[Integrations](https://spiral.ai/integrations) › [Gemini CLI](https://spiral.ai/integrations/gemini-cli) › [HiBid auction search](https://spiral.ai/integrations/gemini-cli/hibid-auction-search)

# How to Use HiBid auction search in Gemini CLI

Finds current or completed auction events, with catalog links and event information. Use it to discover relevant sales before inspecting their terms or individual lots.

|  |  |
| --- | --- |
| Model | HiBid auction 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 HiBid auction search in Gemini CLI

- Use HiBid auction search to look this up and give me the result as a table. Save the result in ./assets.
- Pull the latest numbers from HiBid auction search and tell me what changed since last week.
- Check HiBid auction search and summarize what you find in three bullet points.
- Pull the newest data from HiBid auction search and give me the result as a table.
- Check HiBid auction search every morning and tell me only when something changed.

## How to set up HiBid auction search in Gemini CLI

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

### Use Spiral's MCP server

1. **Add the server**: Or add it to `~/.gemini/settings.json` yourself:

```bash
gemini mcp add --scope user --transport http spiral https://api.spiral.ai/mcp
```

2. **Sign in**: Start `gemini` and run:

```text
/mcp auth spiral
```

3. **Check it**: In Gemini CLI, run `/mcp`. From your shell:

```bash
gemini mcp list
```

### Use the Spiral skill

1. **Send Gemini CLI 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 HiBid auction 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": "hibid-com/online-auctions/search_auctions",
    "input": {
      "zip": "<zip>"
    }
  }'
```

Then paste one of the prompts above: Gemini CLI finds HiBid auction search on Spiral, shows the price and runs it.

Setup guide in the docs: https://spiral.ai/docs/quickstarts/gemini-cli

## HiBid auction search tools and prices

- [HiBid · Search auctions](https://spiral.ai/tools/alexandria/hibid-com/online-auctions/search_auctions) (Alexandria): $0.00873 per call.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| zip |  | — | Pattern: ^[A-Za-z0-9 -]{3,10}$. |
| page | 1 to 1000 | 1 | page |
| miles | 1 to 5000 | — | Radius around zip in miles (default 50 when zip is given). Requires zip. |
| query |  | — | Keyword over auction titles and lots; with archived=true a date range is required. |
| state |  | — | Two-letter US state or Canadian province code. Pattern: ^[A-Za-z]{2}$. |
| status | OPEN, ALL | OPEN | OPEN: auctions accepting bids now (default). ALL: open and upcoming current auctions. Ignored when archived=true. |

## What can you do with HiBid auction search in Gemini CLI?

Build a purchasing review that connects HiBid auction companies, events, item descriptions, and bidding activity. Keep seller terms beside each shortlisted lot so the project preserves the conditions relevant to an inspection.

### Choose coins for a collection

Find coin auction companies and relevant sales, search for Morgan silver dollars, and inspect promising lots. Compare the seller's description and pictures with event terms and displayed bid activity before deciding which items deserve closer inspection.

### Source used restaurant equipment

Locate auction companies and equipment sales near Chicago, then shortlist mixers or refrigeration lots. Review item descriptions, auction pickup conditions, seller contacts, and bid activity to decide which equipment merits an inspection.

### Inspect record collections before bidding

Find auction companies offering vinyl collections and identify their relevant catalogs. Inspect lot descriptions and pictures, review event terms, and examine displayed bidding activity before choosing collections to view in person.

### Find equipment for a workshop

Identify local auction companies and upcoming workshop sales, then search for a specific tool model. Review its description and pictures alongside auction conditions and bid history to prepare questions for the seller.

### Review completed auction results

Find completed sales relevant to an intended purchase, then inspect archived lots within each auction. Compare descriptions and realized results only where the items are sufficiently similar.

## Overview

- [Alexandria](https://spiral.ai/providers/alexandria)
- [All Gemini CLI guides](https://spiral.ai/integrations/gemini-cli)

## HiBid auction search in other agents

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

## More Gemini CLI guides

- [HiBid auction details](https://spiral.ai/integrations/gemini-cli/hibid-auction-details)
- [HiBid auctioneer search](https://spiral.ai/integrations/gemini-cli/hibid-auctioneer-search)
- [Hertz Car Sales vehicle suggestions](https://spiral.ai/integrations/gemini-cli/hertz-car-sales-vehicle-suggestions)
- [HiBid lot bid history](https://spiral.ai/integrations/gemini-cli/hibid-lot-bid-history)
- [Hertz Car Sales vehicle details](https://spiral.ai/integrations/gemini-cli/hertz-car-sales-vehicle-details)
- [HiBid lot details](https://spiral.ai/integrations/gemini-cli/hibid-lot-details)

## Questions about HiBid auction search in Gemini CLI

**Can Gemini CLI use HiBid auction search?**

Yes. Add Spiral to Gemini CLI as an MCP server, and Gemini CLI can find and run HiBid auction search like any built-in tool.

**How much does HiBid auction search cost in Gemini CLI?**

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

**Do I need an Alexandria account to use HiBid auction search in Gemini CLI?**

No. Spiral runs HiBid auction 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 HiBid auction search in Gemini CLI?**

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

**Does Gemini CLI wait while HiBid auction search runs?**

HiBid auction search runs in the background. Gemini CLI starts the run, checks on it and gives you the json when it's ready.

**Where does the auction data come from?**

Alexandria documents HiBid's public GraphQL interface as its source. Auctioneer-branded HiBid subdomains use the same underlying data, restricted to that auction company.

**Does HiBid verify item descriptions and condition?**

HiBid says it does not verify seller-provided item information or confirm item condition. Independent auctioneers control the descriptions and terms, so an item's stated condition is a seller claim.

**How fresh are the displayed bidding details?**

HiBid warns that catalog and search-result cards in timed soft-close auctions do not update automatically. A late bid can extend a lot while an older card still shows it closing; HiBid recommends refreshing or opening the lot.

**Can I search all completed lots at once?**

Archived lot results are served one auction at a time and can include realized amounts. Find the completed auction first, then inspect its archived lots.

**Are bidder identities public?**

HiBid's displayed bid history does not name bidders. It shows bid amounts, timestamps, counts at each amount, and an overall bid count.

