API

REST sencillo, autenticado con una clave Bearer. También exponemos nuestras propias herramientas WebMCP en /mcp.

Autenticación

Authorization: Bearer ar_live_…

Crea claves en el panel. Requiere plan Pro o superior.

Iniciar un análisis

curl -X POST https://agentreadyfunnel.com/v1/scans \
  -H "authorization: Bearer $AGENTREADY_KEY" \
  -H "content-type: application/json" \
  -d '{"url":"https://example.com","locale":"en","depth":1}'

→ 202 {"scan_id":"scan_…","status":"queued"}

Leer el informe

curl https://agentreadyfunnel.com/v1/scans/scan_… \
  -H "authorization: Bearer $AGENTREADY_KEY"

Sondea hasta que scan.status sea done. Un análisis de una página suele tardar entre 5 y 40 segundos.

Otros endpoints

Método	Ruta	Qué hace
GET	/v1/me	Cuenta, plan y consumo del periodo
GET	/v1/sites/:domain	Último análisis público de un dominio
GET	/v1/leaderboard	Ranking público
GET	/v1/plans	Catálogo de planes y límites
POST	/mcp	Servidor MCP (JSON-RPC)

Errores

{"error":{"code":"scan_quota_exceeded","message":"…","limit":25,"plan":"free"}}

Los límites de plan devuelven 402, la autenticación 401, los permisos 403 y el ritmo 429.

MCP

curl -X POST https://agentreadyfunnel.com/mcp \
  -H "content-type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Herramientas: scan_site, get_report, get_leaderboard, request_audit.