AI Storefront
Browse the documentation

Buyer's Market Scan

Every matching dealer listing near you, new listings and price drops first.

This is the technical reference. For the price, a rendered sample and answers to common questions, see the Buyer's Market Scan product page.

At a glance

Price $4.99 per run.
Tool name generate_buyer_market_scan
Scope reports:buyer-market-scan
Built for Car Shopper

What it does

For a car shopper who knows what they want. Scans dealer websites within the chosen radius of the shopper's ZIP (50 miles by default) for every listing that matches up to 3 makes and models (or a body type such as SUV), the year, price and mileage limits and up to 5 must-have features. Returns the cars first listed in the last 7 days, the asking-price drops of the last 7 days (largest cut first), every current match (the nearest 300 in a large market) with its dealer, distance and up to 4 equipment highlights, each car's asking price against a named basis (its own MarketCheck Price, similar cars at its mileage, or the sticker price for new cars), the matches by model and by dealer, and a day-by-day count of new listings and price drops for the previous 7 days. Dealer websites only (no marketplaces, private sellers or auctions); every price is a dealer asking price. Use when a CONSUMER is shopping for a car and asks what is for sale near them within a budget, which listings are new this week, or which ones dropped in price. For ONE specific listing use Pre-Purchase Negotiation Brief (what to offer) or Used Car Health Check (its history); for what the shopper's own car is worth use Trade-In Valuation Report.

Arguments

Argument What it is Example
zip Required The shopper's 5-digit US ZIP code. Dealer websites within radius_miles of it are searched. 75201
vehicles Recommended Up to 3 makes and models, one per line or separated by semicolons, as "Make | Model | Trims" (trims optional, comma separated), e.g. "Toyota | RAV4 | XLE, XLE Premium; Honda | CR-V". "Toyota RAV4" also works. Leave empty and set body_type to search a whole body type instead. Toyota | RAV4 | XLE, XLE Premium; Honda | CR-V
body_type Recommended Use when no specific model is given: every make and model of this body type. Ignored when vehicles is set. SUV
car_type Optional Used (the default), New, or Certified for certified pre-owned only. used
year_min Optional Oldest model year to include. 2021
year_max Optional Newest model year to include. 2024
price_min_usd Optional Lowest asking price to include, in USD. 20000
price_max_usd Optional Highest asking price to include, in USD (the shopper's budget). 36000
miles_max Optional Highest odometer reading to include. 60000
features Optional Up to 5 must-have features, comma separated; every match has all of them. Choose from: Sunroof, Panoramic roof, Leather seats, Heated seats, Heated and cooled seats, Third-row seats, Navigation, Apple CarPlay, Android Auto, Adaptive cruise control, Blind spot monitor, Lane keep assist, 360 camera, Remote start, Power liftgate, Premium audio, Wireless charging, Head-up display, Memory seats. Sunroof, Heated seats
radius_miles Optional How far from the ZIP to search, 10 to 100 miles. 50
drivetrain Optional awd (all-wheel or four-wheel drive), fwd (front-wheel drive) or rwd (rear-wheel drive). awd
powertrain Optional gas, hybrid, phev (plug-in hybrid) or ev (electric). hybrid
dealer_type Optional franchise (new-car brand dealers) or independent dealers only. franchise
clean_title_only Optional Only cars whose dealer reports a clean title. false
one_owner_only Optional Only cars whose dealer reports a single previous owner. false

What comes back

Asking for it in a chat client

Find me a used Toyota RAV4 or Honda CR-V near 75201: 2021 or newer, under 60,000 miles, $20,000 to $36,000, with a sunroof.

Which used 4WD pickups under $45,000 were listed or cut their price this week near 80202?

Running it from a backend

Grant an agent the reports:buyer-market-scan scope, then call the tool over MCP:

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "generate_buyer_market_scan",
    "arguments": {
      "zip": "75201",
      "vehicles": "Toyota | RAV4 | XLE, XLE Premium; Honda | CR-V"
    }
  }
}

See Server-side access for the token exchange and how to read the response.