generated: '2026-09-01'
method: generated
source: openapi/thecarapi-openapi.json + https://thecarapi.com/docs/recipes
note: >-
  TheCarApi publishes no Agent Skills, no AGENTS.md and no skills directory — its own agent page
  (https://thecarapi.com/docs/agents) points agents at the OpenAPI document and the Markdown docs
  twins instead. These four skills are GENERATED by API Evangelist from the provider's published
  OpenAPI and its six documented end-to-end recipes. Every operationId referenced was verified
  present in openapi/thecarapi-openapi.json; none is invented. Every rule stated is transcribed
  from the provider's own documentation.
provider_published: false
skill_count: 4
skills:
  - name: thecarapi-vehicle-search
    file: thecarapi-vehicle-search.md
    summary: Search inventory and page it correctly — cross-filtered facets, one pagination spelling, the auction_id_str rule.
    operations:
      - get_api_facets
      - get_api_search
      - get_api_models
      - get_api_sites
      - get_api_contract
    scopes: [search]
  - name: thecarapi-vehicle-detail
    file: thecarapi-vehicle-detail.md
    summary: Open one lot — detail, live bid, gallery, and the three pending states that look like errors and are not.
    operations:
      - get_api_auction_site_slug_auction_id
      - get_api_auction_images_site_slug_auction_id
      - get_api_car_details
      - post_api_car_details
      - get_api_contract
    scopes: [auctions, details]
  - name: thecarapi-import-costing
    file: thecarapi-import-costing.md
    summary: Find under-priced lots, cost one landed, and check it against the retail market before calling it a deal.
    operations:
      - get_api_top_offers
      - get_api_auction_site_slug_auction_id
      - get_api_calculator_countries
      - post_api_calculator_calculate
      - get_api_cars_bg_market
      - get_api_auction_market
    scopes: [top-offers, auctions, calculator, market]
  - name: thecarapi-feed-sync
    file: thecarapi-feed-sync.md
    summary: Mirror the feed cheaply — gzip, include_total=false, ETag revalidation, and selective detail hydration.
    operations:
      - get_api_search
      - get_api_listVehicles
      - post_api_listVehicles
      - get_api_auction_site_slug_auction_id
      - get_api_auction_site_slug_auction_id_price_history
      - get_api_vin_vin_history
      - get_api_contract
      - get_api_health
    scopes: [search, details, auctions, ops]
grounding:
  spec: openapi/thecarapi-openapi.json
  operations_in_spec: 39
  operations_referenced: 18
  invented_operations: 0