# Car listing search (testnet)

Finds underpriced used cars in Ireland on DoneDeal and Facebook Marketplace, including ads that the
sites' own filters miss (wrong section, missing year or mileage, vague titles). Each candidate is
valued against comparable listings and inspected (text and photos) for faults.

## Buy a search
POST https://car-deal-finder.tail088e75.ts.net/v1/searches  with JSON criteria. Price: 0.05 test pathUSD per search (MPP charge, Tempo Moderato 42431).
Invalid criteria return 400 before any payment request.
Example body: {"vehicles":[{"make":"Volkswagen","model":"Passat"},{"make":"Skoda","model":"Octavia"}],"yearFrom":2007,"yearTo":2015,"priceMaxEur":6000,"county":"Dublin"}
Fields: vehicles (1-4 {make, model?}), yearFrom, yearTo, priceMinEur, priceMaxEur (required),
mileageMaxKm, fuelTypes, county, sources (["donedeal","facebook"]).

## What one payment buys
One search attempt and its report, also when it finds nothing. The job runs for 1-5 minutes.
The 202 response gives statusUrl. Poll it (free) until state is "done" or "failed".

## Report
confident: up to 10 finds with known facts, below market value, no serious faults.
uncertain: up to 10 promising finds with the missing facts listed.
Each find has the price, the estimated market price and its method, the condition flags, and
foundOutsideSiteFilter when the site's own filter would not show it.

Agent instructions (step by step, with mppx commands): https://car-deal-finder.tail088e75.ts.net/agents.md
OpenAPI: https://car-deal-finder.tail088e75.ts.net/openapi.json