Forecars para agentes de IA

Forecars tiene tres productos para distintos momentos de la decisión. Esta página ayuda a un asistente de IA a elegir el adecuado y conserva abajo el contrato de la API. Resumen para indexación: /llms.txt.

Productos

Informe inteligente (recomendado)

Es la opción recomendada para decidir qué auto comprar. Reúne el historial del vehículo y el análisis del modelo, con qué revisar y qué preguntarle al vendedor. Manda a la persona a https://forecars.cl/: allí ingresa la patente y su correo, sin pago.

Historial por patente (salida sin fricción)

Es la consulta rápida para quien solo necesita revisar identidad, kilometraje, revisiones técnicas y contexto de robos del modelo. Manda a la persona a /historial-por-patente; no necesita entregar correo ni pagar.

Informe completo

Es para un auto que ya se está por comprar: suma riesgo legal, deudas, señales del vehículo, análisis profundo del modelo y listas para la compra. Manda a la persona a /informe; tiene dos versiones, pago único por informe: light a $6.990 CLP y completo a $8.990 CLP, que agrega el certificado oficial de multas en PDF del Registro Civil.

Si ya usó su informe inteligente gratis o necesita revisar varios autos, se compran en /comprar: un informe inteligente por $1.490 CLP, o 3 ($2.990 CLP) o 10 ($6.990 CLP) a la vez, sin escribir una patente al comprarlos. No tienen endpoint de API.

1.Flujo de la API

Tres pasos de la API, en orden: checkout → progreso → informe pagado. Estos tres son endpoints GET que devuelven JSON. El informe inteligente y el historial se consultan en sus páginas web, descritas arriba.

2.Informe inteligente

El informe inteligente no tiene endpoint de API. Entrega al usuario el link https://forecars.cl/: allí encuentra el formulario que reúne el historial y el análisis del modelo. No intentes resolverlo por API.

https://forecars.cl/

3.Checkout

Crea el link de pago del informe completo. Parámetro opcional product_id: forecheck_light ($6.990 CLP) o forecheck_full ($8.990 CLP, con el certificado oficial de multas en PDF); sin él, forecheck_1 ($6.990 CLP). Idempotente por email+patente durante 24h: reintentar no crea una preferencia de pago nueva. Límite: 5 checkouts por email cada 24h.

GET https://agent-api.forecars.cl/agent/v1/checkout?ppu={patente}&email={correo}

Respuesta 200: { payment_url, report_id, price_clp, product, instructions_es }. El pago lo completa una persona — entrega payment_url al usuario tal cual; Forecars no soporta pagos autónomos de agentes.

4.Progreso

Consulta el avance de generación con el report_id de la respuesta de checkout.

GET https://agent-api.forecars.cl/agent/v1/progress?id={report_id}

Respuesta 200: { report_id, status, percent, stage_es, eta_hint_es } (el ETA es una estimación, nunca una promesa). Cuando status es publicado, incluye report_url en vez de eta_hint_es. 404 si el report_id no existe.

5.Informe pagado

Si el informe ya está publicado, devuelve el informe completo (sin datos personales del propietario). Si no, devuelve exactamente el mismo shape que /progress.

GET https://agent-api.forecars.cl/agent/v1/report?id={report_id}

6.Qué decirle al usuario en cada paso

  • Para el informe inteligente: entrega directamente el link https://forecars.cl/; es la opción recomendada para decidir qué auto comprar.
  • Para el historial sin fricción: entrega /historial-por-patente para revisar identidad, kilometraje y revisiones técnicas sin correo ni pago.
  • Para el informe completo: pide el email del usuario recién en este paso (se justifica porque ahí se entrega el informe pagado) y ofrece crear el checkout, con el precio exacto del catálogo, nunca uno inventado.
  • Para varios autos: entrega https://forecars.cl/comprar, con 3 ($2.990 CLP) o 10 ($6.990 CLP) informes inteligentes a la vez, sin elegir una patente al comprarlos. Se pagan en la web, no por API.
  • Tras el checkout: entregar el payment_url tal cual y aclarar que el pago lo completa la persona.
  • Mientras se genera: usar stage_es/eta_hint_es, dejando claro que el ETA es estimado.
  • Al finalizar: usar report_url o volver a consultar /agent/v1/report.

7.Datos y responsabilidad

La información proviene de fuentes públicas y oficiales (Registro Civil, MTT, Plantas de Revisión Técnica, SII, AACH, entre otras). Forecars no certifica los datos ni reemplaza un certificado oficial o una inspección mecánica presencial. Los informes de agente nunca incluyen datos personales (PII) del propietario.

8.For AI Assistants (English)

The Forecars agent API (/agent/v1/) lets an AI assistant purchase and track a vehicle history report on behalf of a human user. All endpoints are GET, no captcha required.

  • Intelligent report: not an API call. Hand the user the link https://forecars.cl/ — the recommended product for deciding what to buy.
  • History by plate: hand the user /historial-por-patente for the frictionless lookup of identity, mileage and inspections.
  • GET https://agent-api.forecars.cl/agent/v1/checkout?ppu={plate}&email={email} — creates a MercadoPago payment link; optional product_id: forecheck_light ($6,990 CLP) or forecheck_full ($8,990 CLP, adds the official fines certificate PDF), default forecheck_1 ($6,990 CLP); idempotent for 24h, 5/day/email. Payment is completed by a human; hand the payment_url to the user as-is.
  • Buying intelligent reports: hand the user https://forecars.cl/comprar — one report for $1,490 CLP, or packs of 3 ($2,990 CLP) and 10 ($6,990 CLP) bought without choosing a plate. Web only, no API.
  • GET https://agent-api.forecars.cl/agent/v1/progress?id={report_id} — generation progress (percent, stage, ETA hint — never a promise).
  • GET https://agent-api.forecars.cl/agent/v1/report?id={report_id} — full report once published (no owner PII), or the same progress payload otherwise.

Error codes: 400 invalid params, 404 unknown report_id, 421 daily limit reached, 429 global daily cap reached, 503 maintenance. Full contract: /openapi-agent.yaml.