API y MCP de ARQSEO

Lanza auditorías SEO y consulta los resultados desde tu código, desde tus automatizaciones o directamente desde tu asistente de IA. Misma clave para las dos cosas. Disponible en los planes Pro y Agency.

Autenticación

Todas las peticiones llevan la cabecera Authorization con tu clave. Las claves se crean desde el panel, en API y MCP. 

curl -H "Authorization: Bearer arq_TUCLAVE.TUSECRETO" \
  https://arqseo.com/api/v1/

Esa dirección raíz se describe sola: devuelve la lista de recursos que puedes usar, tus permisos y tu límite de peticiones. Del secreto solo guardamos un resumen cifrado (hash), así que solo se muestra una vez, al crearlo.

Tres cosas que conviene saber

Paginación por cursor

Cada lista trae siguiente_cursor. Pásalo como ?cursor=. No usamos OFFSET: las tablas de detalle tienen millones de filas y paginar así cuesta lo mismo en la página 1 que en la 10.000.

Auditar es asíncrono

POST /auditorias responde 202 con la cabecera Location. Consulta esa URL para seguir el progreso. Un sitio grande tarda minutos: no bloqueamos tu petición.

Límites por clave

Cada respuesta trae X-RateLimit-Limit, -Remaining y -Reset. Al pasarte recibes un 429 con Retry-After.

Endpoints

Cuenta

GET /api/v1/cuenta

Plan, limites y creditos restantes

Proyectos

GET /api/v1/proyectos

Lista los proyectos con su ultima puntuacion

Parámetros: limite, cursor

Auditorias

GET /api/v1/auditorias

Lista auditorias con estado y puntuacion

Parámetros: limite, cursor, proyecto_id, estado

POST /api/v1/auditorias

Lanza una auditoria (asincrona)

Requiere una clave con permiso de escritura. Consume 1 credito por pagina rastreada. Devuelve 202 y la cabecera Location con la URL del recurso; el progreso se consulta con GET sobre esa URL.

GET /api/v1/auditorias/{id}

Estado, progreso y puntuacion de una auditoria

Parámetros: id

GET /api/v1/auditorias/{id}/resumen

Auditoria con los problemas AGRUPADOS por codigo

El endpoint mas util para analizar un sitio: en vez de miles de filas sueltas devuelve los problemas agrupados por codigo con cuantas paginas afecta cada uno, mas los que afectan a todo el sitio.

Parámetros: id

GET /api/v1/auditorias/{id}/problemas

Problemas detectados, con URL y recomendacion

Parámetros: id, limite, cursor, severidad, codigo

GET /api/v1/auditorias/{id}/paginas

Paginas rastreadas con su puntuacion

Parámetros: id, limite, cursor, score_maximo

GET /api/v1/auditorias/{id}/paginas-peores

Las paginas con peor puntuacion

Parámetros: id, limite

GET /api/v1/auditorias/{id}/evolucion

Que ha cambiado pagina a pagina desde la auditoria anterior

Parámetros: id, anterior_id

GET /api/v1/auditorias/{id}/enlaces-rotos

Enlaces rotos encontrados

Parámetros: id, limite, cursor

GET /api/v1/auditorias/{id}/comparativa

Compara con la auditoria anterior del mismo proyecto

Que problemas se han resuelto, cuales han aparecido y como ha evolucionado la puntuacion. Usa siempre la auditoria inmediatamente anterior del proyecto.

Parámetros: id

Search Console

GET /api/v1/proyectos/{id}/quick-wins

Paginas en posicion 4-15 con volumen de busqueda

Parámetros: id, limite

GET /api/v1/proyectos/{id}/canibalizacion

Consultas por las que compiten varias URLs del sitio

Parámetros: id, limite

Especificación completa: openapi.json (OpenAPI 3.1, importable en Postman, Insomnia o cualquier generador de clientes).

Servidor MCP

ARQSEO ofrece un servidor MCP (Model Context Protocol), así que puedes conectarlo a Claude o a cualquier cliente compatible y pedirle que audite un sitio o te explique los problemas sin salir de la conversación. 

claude mcp add arqseo --transport http https://arqseo.com/mcp \
  --header "Authorization: Bearer arq_TUCLAVE.TUSECRETO"

Herramientas (tools) disponibles:

Las claves de solo lectura ni siquiera ven las herramientas de escritura.

¿Todavía no tienes cuenta?

Empezar gratis