Spiral gives your agent every tool with one account. Browse the tools →

opencode · E-commerce

How to Use Kelley Blue Book car listings in opencode

Returns matching KBB inventory with listing identifiers, VINs, asking prices, mileage, and deal ratings. Use it to find comparable vehicles near a US location before inspecting individual listings.

Prompts to try with Kelley Blue Book car listings in opencode

Copy an example into opencode, or ask in your own words.

Use Kelley Blue Book car listings to find 2021–2023 Toyota Camrys near 90210 within 50 miles, then review how this project's comparison code handles VINs and mileage.

Kelley Blue Book car listingsopencode
Try asking
  • Use Kelley Blue Book car listings to look this up and give me the result as a table. Save the result in ./assets.

  • Pull the latest numbers from Kelley Blue Book car listings and tell me what changed since last week.

  • Check Kelley Blue Book car listings and summarize what you find in three bullet points.

  • Pull the newest data from Kelley Blue Book car listings and give me the result as a table.

How to set up Kelley Blue Book car listings 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.

    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.

    opencode mcp auth spiral
  3. Check it

    Spiral shows as connected.

    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.

    npx -y spiral-cli@latest init

Call the Spiral API

  1. Create an API key

    In the console, under API keys.

  2. Run Kelley Blue Book car listings

    One request; the result comes back by polling or a webhook.

    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": "kbb-com/vehicles/listings",
        "input": {
          "zip": "<zip>",
          "make": "<make>"
        }
      }'

Then paste one of the prompts above: opencode finds Kelley Blue Book car listings on Spiral, shows the price and runs it.

Kelley Blue Book car listings providers and prices

Spiral runs Kelley Blue Book car listings through Alexandria. Open a card for today's price, with every fee included.

AlexandriaE-commerce
Kelley Blue Book · Listings
kbb-com/vehicles/listings

Settings you can ask for

Ask opencode for any of these in your prompt.

SettingAllowed valuesDefaultDescription
Page1 to 401

Result page; 25 listings per page.

Sortrelevance, price_asc, price_desc, mileage_asc, year_desc, distance_asc, or newestrelevance

Result order: relevance (KBB default), price_asc / price_desc by KBB derived price (advertised price plus fees, so advertised prices are only approximately ordered), mileage_asc, year_desc (newest model year first), distance_asc (nearest seller first), newest (most recently listed first).

Year max1981 to 2030

Newest model year to include, inclusive; must not be below year_min.

Year min1981 to 2030

Oldest model year to include, inclusive.

Price maxa number from 0

Highest advertised price to include, in whole US dollars; must not be below price_min.

Price mina number from 0

Lowest advertised price to include, in whole US dollars.

Drive typeawd, 4wd, fwd, or rwd

Drivetrain group. kbb.com groups AWD and 4WD together, so awd and 4wd return the same listings (drive_type AWD4WD).

Mileage max1 to 999999

Only listings with at most this many miles on the odometer (kbb.com maxMileage filter; any ceiling, not just the site's 10,000-mile steps).

Listing typeused, new, certified, or allused

Inventory to search: used, new, certified pre-owned, or all three. Defaults to used.

Radius miles0, 10, 25, 50, 75, 100, 200, 300 and 2 more50

Search radius in miles; 0 means nationwide. KBB pads a market's results with remote 'virtual dealer' delivery listings whose distance is not the seller's; with a non-zero radius these are excluded (count may be below page_size while total_count still includes them).

Exterior colorbeige, black, blue, brown, burgundy, charcoal, gold, gray and 11 more

kbb.com exterior colour group; matches the manufacturer colour names in exterior_color (e.g. white matches Snowflake White Pearl Mica).

Every API field of Kelley Blue Book · Listings is on its tool page: open its card above.

What can you do with Kelley Blue Book car listings in opencode?

Build a vehicle comparison that connects KBB inventory, listing details, trim specifications, and valuation estimates. A coding agent can use your project's comparison logic to keep seller asking prices separate from KBB benchmarks, within your data-use permissions.

Prepare a used-car purchase shortlist

Find Toyota Camrys near Los Angeles, compare their trims, inspect the leading listings, and estimate values using each candidate's mileage and condition. Turn the findings into specific questions for the dealer.

Compare trim premiums

Compare Honda Civic trims, matching local inventory, and individual listing details. Use vehicle-specific estimates to separate the trim premium from differences in mileage and condition.

Compare two nearby shopping markets

Compare the same Subaru Outback model year and trim around Denver and Colorado Springs. Check local inventory, listing details, and regional valuations before deciding where to shop.

Assess a lower-mileage premium

Find Mazda CX-5 candidates of the same year and trim with different odometer readings. Inspect their listing details and compare mileage-specific values to judge whether the lower-mileage option deserves its premium.

Investigate a promising dealer listing

Find Honda CR-V candidates, then examine price history, warranty information, and Fair Purchase Price for the strongest matches. Prepare questions about the details that affect the purchase decision.

Questions about Kelley Blue Book car listings in opencode

Can opencode use Kelley Blue Book car listings?

Yes. Add Spiral to opencode as an MCP server, and opencode can find and run Kelley Blue Book car listings like any built-in tool.

How much does Kelley Blue Book car listings 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 Kelley Blue Book car listings in opencode?

No. Spiral runs Kelley Blue Book car listings on its own Alexandria account. You sign in to Spiral once and never paste a key.

How long does it take to set up Kelley Blue Book car listings in opencode?

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

Does opencode wait while Kelley Blue Book car listings runs?

Kelley Blue Book car listings runs in the background. opencode starts the run, checks on it and gives you the json when it's ready.

Does KBB.com cover vehicles outside the United States?

KBB.com pricing is specific to the United States. Its valuations account for local markets across 134 US geographic regions.

How often does KBB refresh its values?

KBB updates its pricing at least weekly. That schedule describes its valuation data, rather than a promise that each seller's listing is refreshed weekly.

How far back does KBB's used-vehicle valuation coverage go?

KBB provides used-vehicle values for vehicles up to 21 years old. This is a vehicle-age boundary, not 21 years of historical quotes for every car.

Does KBB verify the information in seller listings?

KBB says it cannot verify vehicle information supplied by sellers. A listing's stated equipment or condition therefore does not establish that KBB inspected the vehicle.

Can I store or commercially republish KBB data?

KBB's general website terms require written permission for storing or migrating its information and an advance agreement for commercial use. Public visibility does not establish permission to build a commercial dataset.

Get started

Start using Kelley Blue Book car listings in opencode

One Spiral account for every tool your agent needs. No subscription; you pay per run.

Paste this into opencode:

Set up opencode

set up https://spiral.ai/SKILL.md
Are you an AI agent? See setup options