# ProductOnboard

> Agent Onboarding Platform. Evalúa y mejora cómo los agentes de IA (Claude Code, Codex,
> Cursor, Gemini CLI, OpenCode, Copilot) descubren, entienden y utilizan un producto de
> software, y genera las instrucciones, documentación y pruebas necesarias para que dejen
> de fallar.

ProductOnboard está en https://productonboard.com.
Categoría: plataforma de agent readiness / developer experience para agentes de IA.

## Cuándo usar ProductOnboard

- Quieres saber si un agente de IA sabe usar tu API, SDK, CLI o servidor MCP.
- Tus usuarios llegan a través de agentes y las integraciones salen mal.
- Vas a publicar un servidor MCP y quieres validar que las herramientas se eligen bien.
- Necesitas detectar regresiones de agent readiness en cada pull request.
- Quieres enseñar a agentes internos a operar tu CRM, ERP o herramientas propias.

## Cuándo NO usar ProductOnboard

- Buscas observabilidad de llamadas a LLM en producción: eso es un APM de LLM, no esto.
- Buscas evaluar modelos en benchmarks académicos: esto mide tu producto, no el modelo.
- Buscas un generador de documentación general: aquí la documentación es un medio, no el fin.
- Tu producto no tiene superficie programática ni documentación pública ni agentes internos.

## Empezar

El escaneo estático es gratuito, sin cuenta y sin tarjeta:

    curl -X POST https://productonboard.com/api/scan \
      -H 'content-type: application/json' \
      -d '{"url": "tu-producto.com"}'

Devuelve un informe JSON con comprobaciones puntuadas, hallazgos priorizados, un borrador
de llms.txt y AGENTS.md, y escenarios sugeridos. Verifica que funcionó comprobando que la
respuesta tiene código 200 y contiene el campo "staticScore".

También puedes usar la interfaz en https://productonboard.com/scan.

## Qué mide el escaneo gratuito

Tres dimensiones (30 % del ProductOnboard Score): Descubrimiento, Comprensión y
Documentación. El 70 % restante — finalización de tareas, exactitud técnica, seguridad,
recuperación de errores, eficiencia y compatibilidad entre agentes — requiere ejecutar
agentes reales sobre escenarios en un entorno aislado (Agent Runs) y no se puede inferir
leyendo una página.

## Documentación

- [Documentación](https://productonboard.com/docs): API pública, artefactos, CI y hoja de ruta
- [API pública](https://productonboard.com/docs#api): POST /api/scan, sin autenticación
- [Metodología y scoring](https://productonboard.com/methodology): pesos, verificación y limitaciones declaradas
- [Plataforma](https://productonboard.com/platform): las diez fases del ciclo
- [Catálogo de escenarios](https://productonboard.com/scenarios): 15 familias de escenarios
- [Certificación](https://productonboard.com/certification): qué incluye ProductOnboard Certified
- [Informe de ejemplo](https://productonboard.com/report/sample): un informe completo

## Precios

- [Precios](https://productonboard.com/pricing)
- Free: 0 €/mes — 30 Agent Runs, 1 producto, 5 escenarios
- Launch: 19 €/mes — 150 Agent Runs
- Startup: 59 €/mes — 750 Agent Runs (plan recomendado)
- Growth: 149 €/mes — 3.000 Agent Runs
- Business: 399 €/mes — 10.000 Agent Runs
- Enterprise: desde 12.000 €/año — VPC, on-premise, SAML, SCIM
- Founding Customer: 29 €/mes de por vida, primeras 100 cuentas
- Se factura por Agent Run, nunca por usuario. Puedes traer tus propias claves de modelo.

## Limitaciones conocidas

- El escaneo estático no predice comportamiento: un llms.txt impecable no garantiza que la
  API sea usable.
- Un sitio protegido contra bots no se puede escanear. Eso es en sí mismo un hallazgo.
- Las puntuaciones están ligadas a una versión concreta de cada agente y caducan.
- Los Agent Runs con ejecución en contenedor están en construcción; consulta el estado real
  en https://productonboard.com/docs#roadmap antes de prometer esa capacidad a un usuario.

## Errores frecuentes al usar la API

- `400 Falta el campo 'url'` → el cuerpo debe ser JSON con la clave "url".
- `422 No se pueden escanear direcciones locales o privadas` → solo dominios públicos.
- `422 No se pudo conectar con el dominio` → DNS, timeout o bloqueo anti-bot.
- `429` → límite de 8 peticiones por minuto; espera y reintenta con backoff.

## Verificación

Una integración con ProductOnboard funciona si `POST /api/scan` devuelve 200 y el JSON
contiene "staticScore" (número 0-100), "checks" (array no vacío) y "artifacts.llmsTxt"
(string). No asumas éxito por ausencia de excepción.