API REST + servidor MCP

La API de informes SEO para
desarrolladores y agentes de IA

Crea informes por REST, consulta su estado y lee el mismo objeto de informe guardado que tu equipo ve en el sitio web. La misma clave API conecta cualquier agente compatible con MCP.

Modelo de acceso

Cuenta gratuita + clave API

El acceso API está vinculado a la cuenta. Crea una cuenta gratuita, emite una clave API, y comienza con vistas previas de puntuación. No se requiere tarjeta para el camino de evaluación.

Un objeto de informe

Sesiones de sitio web, llamadas API y sesiones de agente se leen del mismo estado del informe guardado.

Flujo sencillo

Crea un informe, consulta el estado, luego lee la vista previa o los resultados completos del mismo objeto.

Puntos finales disponibles

POST/api/v1/reports/preview

Crear una vista previa de puntuación para flujos de socios y lanzamiento de productos.

POST/api/v1/reports

Crea un nuevo informe o reutiliza uno que ya exista.

GET/api/v1/reports/:id

Obtén el último estado del informe y las secciones.

GET/api/v1/reports/:id/result

Lee los resultados completos una vez desbloqueado el informe.

GET/api/v1/reports/:id/download?format=json

Exportar la carga útil del informe como JSON para integraciones programáticas.

Oficial TypeScript Cliente

Zero-config auth, free-tier listo, launch-platform listo.

Línea de comandos

Ejecuta informes desde tu terminal. Una instalación global, vistas previas instantáneas.

Bash
npm install -g @seoreport/client

Servidor MCP: la misma API, la misma clave

Apunta cualquier cliente compatible con MCP a https://seoreport.dev/mcp y autentícate con la misma clave API Bearer que usas en REST. Las herramientas de informes y de cuenta se anuncian al conectar, así que un agente puede ejecutar una auditoría y leer los hallazgos sin código intermedio.

Configuración del cliente MCPJSON
{
  "mcpServers": {
    "seoreport": {
      "url": "https://seoreport.dev/mcp",
      "headers": {
        "Authorization": "Bearer sr__live_your_api_key"
      }
    }
  }
}
create_report

Inicia un informe para una URL y devuelve un ID de trabajo.

get_report_status

Consulta el trabajo hasta que el informe esté listo.

get_report

Lee el informe terminado con su puntuación y hallazgos.

list_reports

Lista los informes de la cuenta.

get_report_download

Obtén una URL de descarga en JSON, Markdown, texto o PDF.

get_usage

Consulta los créditos restantes y el periodo de facturación actual.

El pago, la cancelación y la eliminación de la cuenta devuelven una URL de confirmación en el navegador en lugar de ejecutarse directamente. Un agente puede iniciarlas; solo una persona puede completarlas.

Respuesta de ejemploJSON
{
  "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
}

Listo para construir?

Obtén tu clave API gratuita y comienza a integrar informes SEO en tu producto.