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

opencode · E-commerce

How to Use CARFAX car listings search in opencode

Find US cars for sale with vehicle specifications, dealer information, and CARFAX history highlights. Use it to build a shortlist across cars before inspecting individual listings.

Prompts to try with CARFAX car listings search in opencode

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

Use CARFAX car listings search for 2020 through 2022 Honda Civics near 94103. Build a comparison table in this project with mileage, dealer, and reported history highlights.

CARFAX car listings searchopencode
Try asking
  • Use CARFAX car listings search for 2021 through 2023 Toyota RAV4s near 60601. Add a comparison view for engine, transmission, and fuel economy.

  • Use CARFAX car listings search for 2019 through 2022 Subaru Outbacks near 80202. Show available CARFAX value assessments beside mileage in this project's results table.

  • Use CARFAX car listings search to look this up and give me the result as a table. Save the result in ./assets.

  • Pull the latest numbers from CARFAX car listings search and tell me what changed since last week.

How to set up CARFAX car listings 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.

    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 CARFAX car listings search

    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": "carfax-com/vehicles/search_listings",
        "input": {
          "zip": "<zip>"
        }
      }'

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

CARFAX car listings search providers and prices

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

AlexandriaE-commerce
CARFAX · Search listings
carfax-com/vehicles/search_listings

Settings you can ask for

Ask opencode for any of these in your prompt.

SettingAllowed valuesDefaultDescription
Page1 to 50

1-based page of 25; Carfax serves at most 50 pages.

Sortbest, price_asc, price_desc, mileage_asc, mileage_desc, year_desc, or year_asc

Default best (Carfax's best match).

Max year1900 to 2100

max_year

Min year1900 to 2100

min_year

Certifiedon or off

Only certified pre-owned.

Conditionused, new, or any

Default used.

Max pricea number from 0

USD.

Min pricea number from 0

USD.

One owneron or off

Only Carfax 1-Owner vehicles.

Max mileagea number from 0

max_mileage

Min mileagea number from 0

min_mileage

No accidentson or off

Only vehicles with no accident or damage reported to Carfax.

Personal useon or off

Only personal-use vehicles.

Radius miles10, 25, 50, 75, 100, 150, 200, 250 and 1 more

Radius around zip; default 50. Needs zip.

Service recordson or off

Only vehicles with service records.

Every API field of CARFAX · Search listings is on its tool page: open its card above.

What can you do with CARFAX car listings search in opencode?

Build a vehicle comparison view that puts CARFAX specifications and reported history beside each candidate. Keep listing highlights and full Vehicle History Reports clearly distinguished in the interface.

Build a used-car shortlist

Compare listed vehicles by mileage, specifications, and reported history, then examine the strongest candidates individually before choosing cars to view.

Compare reported maintenance

Put available service highlights beside mileage for competing cars. Identify which candidates warrant questions about maintenance records.

Review CARFAX value assessments

Compare available History-Based Values and price ratings across candidates, using reported ownership, service, and accident information to explain differences.

Prepare questions for a dealer visit

Turn vehicle specifications and history highlights into a focused question list about equipment, reported damage, and maintenance.

Compare equipment across trims

Check listed features, engines, transmissions, and fuel economy across candidate vehicles before deciding which trim meets your needs.

Compare cars across locations

Review matching vehicles around different US ZIP codes, then inspect individual listings to compare specifications, history highlights, and dealer locations.

Compare reported ownership histories

Compare ownership highlights alongside mileage and service information when choosing between otherwise similar listed cars.

Questions about CARFAX car listings search in opencode

Can opencode use CARFAX car listings search?

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

How much does CARFAX car listings 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 CARFAX car listings search in opencode?

No. Spiral runs CARFAX car listings 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 CARFAX car listings search in opencode?

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

Does opencode wait while CARFAX car listings search runs?

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

Which market do these CARFAX tools cover?

They cover US new and used car listings. CARFAX's underlying history sources also include Canadian provincial agencies, but that does not make these tools a Canadian listings search.

Do the results include a full Vehicle History Report?

No. These tools return listing data and history highlights; full CARFAX Vehicle History Reports are outside their scope.

Does no reported accident mean a car has never been damaged?

No. CARFAX says some accident and damage events go unreported, and some reported events never reach CARFAX. Read the label as a boundary on the records available.

How frequently does CARFAX add history data?

CARFAX advertises 6.5 million records added daily across its vehicle history database. That database-wide figure does not establish a daily refresh schedule for each car listing.

What goes into CARFAX History-Based Value?

CARFAX lists service records, open recalls, past accidents, and previous owner count among its valuation factors. Use those factors when comparing a value estimate with the vehicle's history highlights.

Get started

Start using CARFAX car listings search 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