English Français العربية

cars-data.com — Car Specs API

السجل الرسمي البحث والويب

Search, compare & filter 103,372 car variants — 224 specs, 20 languages. Free demo, no key; x402.

الشيفرة المصدرية الموقع التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http cars-data-com-car-specs-api 'https://api.cars-data.com/mcp' --header 'Authorization: <Bearer <your cars-data.com API key> — OPTIONAL. Without it this server answers a fixed 40-car demo (every spec, every photo, 20 languages); a demo key, issued in one click, covers the same 40 cars over REST. Two tools reach the full 103,372-variant catalogue with no key and no account at all, paid per call under x402 v2 on Base (USDC): search_catalogue $0.005 and get_specs_full $0.05. Keys and licensed exports: https://cars-data.com/en/api/for-ai-agents>'
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "cars-data-com-car-specs-api": {
            "type": "http",
            "url": "https://api.cars-data.com/mcp",
            "headers": {
                "Authorization": "<Bearer <your cars-data.com API key> — OPTIONAL. Without it this server answers a fixed 40-car demo (every spec, every photo, 20 languages); a demo key, issued in one click, covers the same 40 cars over REST. Two tools reach the full 103,372-variant catalogue with no key and no account at all, paid per call under x402 v2 on Base (USDC): search_catalogue $0.005 and get_specs_full $0.05. Keys and licensed exports: https://cars-data.com/en/api/for-ai-agents>"
            }
        }
    }
}

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. cars-data.com — Car Specs API + MCP server
  2. MCP server
  3. REST API
  4. Pricing
  5. Data & attribution
  6. License

cars-data.com — Car Specs API + MCP server

REST API and remote MCP server over cars-data.com's multilingual vehicle-specs database: 102,191 vehicle variants, 1,300+ models, 5,299 generations, 180 spec types across 19 categories, in 19 languages (including Arabic, RTL).

  • REST API: https://api.cars-data.com/v1
  • MCP server (streamable HTTP): https://api.cars-data.com/mcp
  • OpenAPI spec: openapi.yaml
  • Also distributed as an Apify Actor (pay-per-event, no API key needed)

MCP server

Connect directly from Claude, ChatGPT connectors, Cursor, or Windsurf:

{
  "mcpServers": {
    "cars-data": {
      "type": "http",
      "url": "https://api.cars-data.com/mcp"
    }
  }
}

Tools exposed:

ToolWhat it does
search_carsFree-text search across 102,191 variants, 116 brands, 19 languages
get_specsFull localized specs for one variant — 180 spec types across 19 categories (safety, comfort/interior, engine & fuel, performance, EV/hybrid, chassis, exterior, dimensions & weights, WLTP/NEDC consumption, and more), with a confidence score and last_synced_at freshness timestamp
compare_variantsSide-by-side localized specs for 2-4 variants
list_generationsGenerations/facelifts of a model, with production years
filter_carsStructured filter: fuel, body, drive, power/price range, year, EV-only
get_imagesImage URLs (own CDN) for a vehicle variant

The MCP server is unauthenticated for discovery (rate-limited per IP). No signup required to try it.

REST API

Base URL: https://api.cars-data.com/v1. Full reference in openapi.yaml.

curl https://api.cars-data.com/v1/variants/42164/specs?locale=de \
  -H "X-Api-Key: cd_free_..."
EndpointDescription
GET /brands, /brands/{slug}, /brands/{slug}/modelsCatalog: brands and models
GET /models/{id}/generationsGenerations for a model
GET /generations/{id}/variantsVariants for a generation
GET /variants, /variants/{id}Filterable variant listing / single variant
GET /variants/{id}/specs?locale=Full localized specs (180 types, 19 languages)
GET /variants/{id}/imagesImage URLs
GET /variants/{id}/pricesPrice snapshot (single point-in-time, not a history)
GET /search?q=Free-text search
GET /compare?ids=Side-by-side specs for 2-4 variants
GET /specs/catalogThe full spec-type catalog (categories + counts)
GET /usageSelf-check current quota usage for your key
Get a free API key
curl -X POST https://api.cars-data.com/v1/keys \
  -H "Content-Type: application/json" \
  -d '{"email": "you@example.com", "accept_tos": true}'

Free tier: 1,000 requests/month, 20 req/min.

Pricing

  • Free — 1,000 req/month, instant self-serve key, no payment.
  • Apify — pay-per-event, billed through the Apify Store listing, no API key needed.
  • x402 — per-call USDC payment on Base for agents that want to pay without an account (not yet live — see the project roadmap).

There is no subscription/Stripe tier — Free and Apify (and, later, x402) are the only paid paths.

Data & attribution

Data comes from cars-data.com's multilingual vehicle-specs database. See cars-data.com/api/terms for the API Terms of Service (attribution required on Free tier; no bulk extraction / resale).

License

The API and its documentation in this repository are provided as-is. Access to the underlying dataset is governed by the API Terms of Service, not an open-source license — this repo documents and hosts the server implementation, not a redistributable dataset.

الأسئلة الشائعة

ما هو cars-data.com — Car Specs API؟

Search, compare & filter 103,372 car variants — 224 specs, 20 languages. Free demo, no key; x402.

كيف أثبّت cars-data.com — Car Specs API؟

يعمل كخادم بعيد. في Claude Code: claude mcp add --transport http cars-data-com-car-specs-api 'https://api.cars-data.com/mcp' --header 'Authorization: <Bearer <your cars-data.com API key> — OPTIONAL. Without it this server answers a fixed 40-car demo (every spec, every photo, 20 languages); a demo key, issued in one click, covers the same 40 cars over REST. Two tools reach the full 103,372-variant catalogue with no key and no account at all, paid per call under x402 v2 on Base (USDC): search_catalogue $0.005 and get_specs_full $0.05. Keys and licensed exports: https://cars-data.com/en/api/for-ai-agents>'. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج cars-data.com — Car Specs API إلى مفتاح API؟

نعم. يتطلب Authorization، وتضبطها في إعداداته.

هل cars-data.com — Car Specs API مفتوح المصدر؟

شيفرته علنية على GitHub، لكن المستودع لا يعلن ترخيصًا قياسيًا.

من يصون cars-data.com — Car Specs API؟

ينشره mariusmmmmm. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.