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
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.
Sesiones de sitio web, llamadas API y sesiones de agente se leen del mismo estado del informe guardado.
Crea un informe, consulta el estado, luego lee la vista previa o los resultados completos del mismo objeto.
Puntos finales disponibles
/api/v1/reports/previewCrear una vista previa de puntuación para flujos de socios y lanzamiento de productos.
/api/v1/reportsCrea un nuevo informe o reutiliza uno que ya exista.
/api/v1/reports/:idObtén el último estado del informe y las secciones.
/api/v1/reports/:id/resultLee los resultados completos una vez desbloqueado el informe.
/api/v1/reports/:id/download?format=jsonExportar 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.
npm install -g @seoreport/clientServidor 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.
{
"mcpServers": {
"seoreport": {
"url": "https://seoreport.dev/mcp",
"headers": {
"Authorization": "Bearer sr__live_your_api_key"
}
}
}
}create_reportInicia un informe para una URL y devuelve un ID de trabajo.
get_report_statusConsulta el trabajo hasta que el informe esté listo.
get_reportLee el informe terminado con su puntuación y hallazgos.
list_reportsLista los informes de la cuenta.
get_report_downloadObtén una URL de descarga en JSON, Markdown, texto o PDF.
get_usageConsulta 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.
{
"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.