# Buyer's Market Scan

Canonical URL: https://ai.marketcheck.com/ai/docs/reports/buyer-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](https://ai.marketcheck.com/reports/buyer-market-scan).

## 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

- Cars first listed in the last 7 days
- Asking-price drops in the last 7 days, largest cut first
- Every current match with its dealer, distance and equipment highlights
- Each car against its own MarketCheck Price or similar cars at its mileage
- Matches by model and by dealer
- New listings and price drops, day by day, for the past week

## 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:

```json
{
  "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](https://ai.marketcheck.com/ai/docs/server-side-access/) for the token exchange and how to read the response.
