Documentación

Referencia para Agentes, MCP & API

Genere informes SEO con IA desde el sitio web, la API REST o MCP, con una sola clave para todo en cualquier plan de pago.

¿Es su 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. Las claves API están disponibles en los planes de pago; cree una en la configuración de su cuenta. Cada sitio nuevo usa uno de los créditos de su plan, que se reinician el primer día de cada mes (UTC) y nunca se acumulan.

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/reportsCrea un nuevo informe o reutiliza uno existente. Añada "forceRerun": true para volver a escanear el sitio.

GET/api/v1/reports/:idObtén el estado y las secciones del informe.

GET/api/v1/reports/:id/resultLee la carga útil completa del resultado.

GET/api/v1/reports/:id/download?format=pdf|md|txt|jsonDescarga el informe renderizado como PDF, Markdown, texto o JSON.

PUT/api/v1/monitorsInicia el monitoreo semanal de un dominio; "enabled": false lo pausa.

GET/api/v1/monitorsLista los dominios que esta cuenta monitorea.

DELETE/api/v1/monitors?url=Detiene el monitoreo de un dominio y elimina sus resultados almacenados.

Respuesta de ejemplo

response.json· json

{
  "success": true,
  "report": {
    "jobId": "3f6c2a1e-8d4b-4c7a-9e21-5b0d7f4a6c18",
    "status": "completed",
    "targetUrl": "https://example.com"
  },
  "pollAfterMs": 0
}

Lectura del resultado

Cuando report.status es completed, el endpoint de resultado devuelve el informe completo. Los hallazgos están en la entrada de report.view.sections cuya clave es full_findings, dentro de detail.findings. Los campos de texto están escritos en el idioma del informe.

result.json· json

{
  "success": true,
  "report": {
    "jobId": "3f6c2a1e-8d4b-4c7a-9e21-5b0d7f4a6c18",
    "status": "completed",
    "targetUrl": "https://www.example.com/",
    "auditedAt": "2026-10-11T09:14:03.000Z",
    "score": { "overall": 72 },
    "view": {
      "sections": [
        {
          "key": "full_findings",
          "state": "ready",
          "detail": {
            "findings": [
              {
                "status": "fail",
                "areaLabel": "URL signals",
                "title": "Canonical tag missing",
                "whyItMatters": "Canonical tags tell search engines which version of a page should appear in results.",
                "fix": "Add a canonical link element or Link HTTP header pointing to the preferred URL for this page."
              }
            ]
          }
        }
      ]
    }
  }
}

report.targetUrl: La dirección que se auditó. Se sigue una redirección dentro del mismo dominio, por lo que puede diferir de la URL que usted envió.
report.auditedAt: Cuándo se realizó la auditoría, como marca de tiempo ISO 8601.
report.score.overall: La puntuación general, de 0 a 100.
report.view.sections[].state: Indica si el contenido de la sección está disponible. Su detail es null hasta que el estado sea ready.
findings[].status: El resultado del hallazgo: fail, warn, pass, info.
findings[].areaLabel: La parte del sitio a la que se refiere el hallazgo.
findings[].title: El hallazgo, en una línea.
findings[].whyItMatters: Por qué el hallazgo importa para la visibilidad en buscadores y en IA.
findings[].fix: Qué cambiar. Se completa en los hallazgos con fallo o advertencia y queda vacío en los demás.

El resultado incluye más campos que estos. Base su integración en los campos listados aquí; los demás no están documentados y pueden cambiar.