[Integrations](https://spiral.ai/integrations) › [opencode](https://spiral.ai/integrations/opencode) › [PS Auction lot search](https://spiral.ai/integrations/opencode/ps-auction-lot-search)

# How to Use PS Auction lot search in opencode

Returns matching lots across PS Auction's inventory, covering equipment from cars to heavy machinery. Use it when you know what you need but haven't chosen a particular auction.

|  |  |
| --- | --- |
| Model | PS Auction lot search |
| Available through | Alexandria |
| Category | E-commerce |
| Price | $0.00873 per call. |
| Returns | json |
| Runs | In the background |
| Setup | About 2 minutes, no API key |

## Prompts to try with PS Auction lot search in opencode

- Use PS Auction lot search to find svets lots around Göteborg and create a shortlist in our project with the returned lot references and descriptions.
- Use PS Auction lot search to look this up and give me the result as a table. Save the result in ./assets.
- Pull the latest numbers from PS Auction lot search and tell me what changed since last week.
- Check PS Auction lot search and summarize what you find in three bullet points.
- Pull the newest data from PS Auction lot search and give me the result as a table.

## How to set up PS Auction lot search in opencode

Pick the way that suits you. Each takes about two minutes.

### Use Spiral's MCP server

1. **Add the server**: Leave out `--global` to add Spiral to the current project only. No header and no client ID or secret: opencode registers itself with Spiral.

```bash
opencode mcp add spiral --global --url https://api.spiral.ai/mcp
```

2. **Sign in**: Your browser opens. Sign in to Spiral, pick the organization and click Authorize, then return to the terminal. No API key. Inside opencode, `/mcps` starts the same sign-in.

```bash
opencode mcp auth spiral
```

3. **Check it**: Spiral shows as connected.

```bash
opencode mcp list
```

### Use the Spiral skill

1. **Send opencode this message**: Your agent reads Spiral's skill and sets itself up.

```
set up https://spiral.ai/SKILL.md
```

2. **Sign in or paste a key**: Approve Spiral in the browser, or give the agent a key from the console.

### Use the Spiral CLI

1. **Install and sign in**: Installs the Spiral CLI, signs you in and adds its skill to your coding agents.

```bash
npx -y spiral-cli@latest init
```

### Call the Spiral API

1. **Create an API key**: In the console, under API keys.

2. **Run PS Auction lot search**: One request; the result comes back by polling or a webhook.

```bash
curl https://api.spiral.ai/v1/runs \
  -H "Authorization: Bearer $SPIRAL_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "provider": "alexandria",
    "model": "psauction-se/auction-lots/search_items",
    "input": {
      "page": 1
    }
  }'
```

Then paste one of the prompts above: opencode finds PS Auction lot search on Spiral, shows the price and runs it.

Setup guide in the docs: https://spiral.ai/docs/quickstarts/opencode

## PS Auction lot search tools and prices

- [PS Auction · Search items](https://spiral.ai/tools/alexandria/psauction-se/auction-lots/search_items) (Alexandria): $0.00873 per call.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| page | 1 to 10000 | 1 | page |
| sort | default, real_endtime, highest_bid, starttime, bid_count, name, number | — | Sort key as the site names it; `real_endtime` is closing soonest. |
| limit | 1 to 144 | 48 | Page size; 48 is the site default, 144 the largest the API accepts. |
| query |  | — | Free text (`params[freeText]`), e.g. `svets`. Optional: without it the search lists every matching lot. |
| language | sv, en | sv | Swedish (psauction.se) or English (psauction.com) texts; prices stay in SEK. |
| location |  | — | Location slug from get_filters: `SE`, `SE_{county}` or `SE_{county}_{city}`, e.g. `SE_Skåne_Malmö`. Pattern: ^SE(_[^_&=?#/]{1,60}){0,2}$. |

## What can you do with PS Auction lot search in opencode?

Build an equipment sourcing report that connects your project's purchasing requirements to PS Auction's inventory. Your coding agent can organize categories, auctions, and lot descriptions into a reviewable shortlist.

### Source workshop equipment

Build a shortlist of welders, compressors, and workbenches near Göteborg. Use suggestions and categories to choose search wording, find relevant sales, review their lots, and inspect individual descriptions.

### Plan a restaurant fit-out

Find commercial kitchen equipment around Malmö. Match returned suggestions to kitchen categories, search individual lots, examine restaurant disposal auctions, and read shortlisted equipment descriptions.

### Refit a warehouse

Look for pallet racking, carts, and lifting equipment around Stockholm. Use the search taxonomy and suggestions to identify relevant wording, then compare standalone lots with equipment offered together in business disposals.

### Research commercial vehicle replacements

Prepare a shortlist of vans and trailers in Sweden. Consult suggestions and vehicle categories, search across inventory, review vehicle auctions, and inspect the descriptions of suitable lots.

### Maintain a closing schedule

Recheck shortlisted lots and relevant auctions before their expected close. Update the schedule when closing times move under PS Auction's three-minute extension rule.

### Improve equipment search wording

Compare PS Auction's returned suggestions and category names with a purchasing team's equipment terminology. Try the relevant wording against actual lots before expanding the search.

### Screen out repair projects

Review equipment search results and auction inventories for Reparationsobjekt descriptions. Separate repair projects from the shortlist for equipment needed immediately.

## Overview

- [Alexandria](https://spiral.ai/providers/alexandria)
- [All opencode guides](https://spiral.ai/integrations/opencode)

## PS Auction lot search in other agents

- [Amp](https://spiral.ai/integrations/amp/ps-auction-lot-search)
- [ChatGPT](https://spiral.ai/integrations/chatgpt/ps-auction-lot-search)
- [Claude](https://spiral.ai/integrations/claude-desktop/ps-auction-lot-search)
- [Claude Code](https://spiral.ai/integrations/claude-code/ps-auction-lot-search)
- [Cline](https://spiral.ai/integrations/cline/ps-auction-lot-search)
- [Codex](https://spiral.ai/integrations/codex/ps-auction-lot-search)
- [Cursor](https://spiral.ai/integrations/cursor/ps-auction-lot-search)
- [Devin](https://spiral.ai/integrations/devin/ps-auction-lot-search)
- [dots](https://spiral.ai/integrations/dots/ps-auction-lot-search)
- [Factory Droid](https://spiral.ai/integrations/factory-droid/ps-auction-lot-search)
- [Gemini](https://spiral.ai/integrations/gemini/ps-auction-lot-search)
- [Gemini CLI](https://spiral.ai/integrations/gemini-cli/ps-auction-lot-search)
- [Google Antigravity](https://spiral.ai/integrations/antigravity/ps-auction-lot-search)
- [goose](https://spiral.ai/integrations/goose/ps-auction-lot-search)
- [Grok](https://spiral.ai/integrations/grok/ps-auction-lot-search)
- [Grok Build](https://spiral.ai/integrations/grok-build/ps-auction-lot-search)
- [Hermes](https://spiral.ai/integrations/hermes/ps-auction-lot-search)
- [Instinct](https://spiral.ai/integrations/instinct/ps-auction-lot-search)
- [Manus](https://spiral.ai/integrations/manus/ps-auction-lot-search)
- [Muse](https://spiral.ai/integrations/muse/ps-auction-lot-search)
- [Muse Code](https://spiral.ai/integrations/muse-code/ps-auction-lot-search)
- [n8n](https://spiral.ai/integrations/n8n/ps-auction-lot-search)
- [Notion](https://spiral.ai/integrations/notion/ps-auction-lot-search)
- [OpenClaw](https://spiral.ai/integrations/openclaw/ps-auction-lot-search)
- [Perplexity](https://spiral.ai/integrations/perplexity/ps-auction-lot-search)
- [Raycast](https://spiral.ai/integrations/raycast/ps-auction-lot-search)
- [VS Code](https://spiral.ai/integrations/vscode/ps-auction-lot-search)
- [Windsurf](https://spiral.ai/integrations/windsurf/ps-auction-lot-search)
- [Zapier](https://spiral.ai/integrations/zapier/ps-auction-lot-search)

## More opencode guides

- [PS Auction lot details](https://spiral.ai/integrations/opencode/ps-auction-lot-details)
- [PS Auction search filters](https://spiral.ai/integrations/opencode/ps-auction-search-filters)
- [PS Auction auction lots](https://spiral.ai/integrations/opencode/ps-auction-auction-lots)
- [PS Auction search suggestions](https://spiral.ai/integrations/opencode/ps-auction-search-suggestions)
- [PS Auction auction calendar](https://spiral.ai/integrations/opencode/ps-auction-auction-calendar)
- [PSA card guide values](https://spiral.ai/integrations/opencode/psa-card-guide-values)

## Questions about PS Auction lot search in opencode

**Can opencode use PS Auction lot search?**

Yes. Add Spiral to opencode as an MCP server, and opencode can find and run PS Auction lot search like any built-in tool.

**How much does PS Auction lot search cost in opencode?**

$0.00873 per call. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your opencode plan is separate.

**Do I need an Alexandria account to use PS Auction lot search in opencode?**

No. Spiral runs PS Auction lot search on its own Alexandria account. You sign in to Spiral once and never paste a key.

**How long does it take to set up PS Auction lot search in opencode?**

About two minutes: add the server, then sign in, then check it.

**Does opencode wait while PS Auction lot search runs?**

PS Auction lot search runs in the background. opencode starts the run, checks on it and gives you the json when it's ready.

**What inventory does PS Auction cover?**

PS Auction lists auction goods including cars, heavy machinery, and business equipment. Its sale calendar includes disposals combining workshop, warehouse, and industrial equipment.

**Can an auction's closing time change?**

Yes. PS Auction extends the auction by three minutes when a bid arrives within the final three minutes, so a previously listed closing time can move.

**Can a listing description change after publication?**

Yes. PS Auction's terms explicitly allow changes to item descriptions during the auction, so an earlier description may differ from the current listing.

**Which description takes precedence if translations differ?**

The Swedish item description takes precedence when PS Auction provides descriptions in multiple languages.

**What does Reparationsobjekt mean?**

PS Auction uses Reparationsobjekt for an item that needs repair, including equipment that is broken or malfunctioning. Exclude those listings when sourcing equipment intended for immediate use.

