Documentación

Referencia para Agentes, MCP & API

Ejecuta informes de posicionamiento web desde tu sitio web, REST API, o MCP. Una clave para todo.

¿Es tu primera vez? La página para desarrolladores explica el modelo de acceso antes de llegar a la referencia de endpoints. Leer el resumen de la API de informes SEO

Autenticación

Todas las solicitudes requieren un token Bearer. Crea una clave API en la configuración de tu cuenta después de registrarte.

Header· http
Authorization: Bearer sr__live_your_api_key

Solicitud de ejemplo

curl· bash
curl -X POST https://seoreport.dev/api/v1/reports \
  -H "Authorization: Bearer sr__live_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{"url": "example.com"}'

Puntos finales de la API REST

URL base: https://seoreport.dev

POST/api/v1/reports
GET/api/v1/reports/:id
GET/api/v1/reports/:id/result
GET/api/v1/reports/:id/download?format=pdf|md|txt|json

Respuesta de ejemplo

response.json· json
{
  "success": true,
  "report": {
    "jobId": "383c5318-5e81-45a8-9df8-579d10442f72",
    "stage": "snapshot_ready",
    "status": "completed",
    "targetUrl": "https://rbeckner.com",
    "isSnapshotReady": true,
    "preview": {
      "sectionKeys": ["hero_summary", "top_findings"]
    },
    "paidUnlock": {
      "unlockEligible": true,
      "unlocked": false
    }
  },
  "pollAfterMs": 0
}

Conecta tu agente con la URL de MCP