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.
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
- 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
- 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
- Check it
Spiral shows as connected.
opencode mcp list
Use the Spiral skill
- Send opencode this message
Your agent reads Spiral's skill and sets itself up.
set up https://spiral.ai/SKILL.md
- Sign in or paste a key
Approve Spiral in the browser, or give the agent a key from the console.
Use the Spiral CLI
- 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
- Create an API key
In the console, under API keys.
- 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.
Settings you can ask for
Ask opencode for any of these in your prompt.
| Setting | Allowed values | Default | Description |
|---|---|---|---|
| Page | 1 to 40 | 1 | Result page; 25 listings per page. |
| Sort | relevance, price_asc, price_desc, mileage_asc, year_desc, distance_asc, or newest | relevance | 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 max | 1981 to 2030 | Newest model year to include, inclusive; must not be below year_min. | |
| Year min | 1981 to 2030 | Oldest model year to include, inclusive. | |
| Price max | a number from 0 | Highest advertised price to include, in whole US dollars; must not be below price_min. | |
| Price min | a number from 0 | Lowest advertised price to include, in whole US dollars. | |
| Drive type | awd, 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 max | 1 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 type | used, new, certified, or all | used | Inventory to search: used, new, certified pre-owned, or all three. Defaults to used. |
| Radius miles | 0, 10, 25, 50, 75, 100, 200, 300 and 2 more | 50 | 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 color | beige, black, blue, brown, burgundy, charcoal, gold, gray and 11 more | kbb.com exterior colour group; matches the manufacturer colour names in |
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.
More on Kelley Blue Book car listings and opencode
Overview
Kelley Blue Book car listings in other agents
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.
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 https://spiral.ai/SKILL.md


