API REST de SEO para desarrolladores
El mismo motor de auditoría de 91 reglas, accesible por HTTP plano. Trae tu propio lenguaje: curl, Node, Python, PHP, cualquier cosa que hable HTTPS. Las mismas claves API funcionan también con nuestro servidor MCP.
Sin tarjeta. Resultados en 30 segundos.
O simplemente pega una URL: la misma auditoría, sin instalar nada.
Actualizado
Autenticación con un token Bearer
Cada endpoint autenticado acepta un token en la cabecera Authorization: Authorization: Bearer ms_live_xxx. Genera una clave en app.metricspot.com/settings/api-keys (hasta 10 por cuenta). El endpoint de auditoría anónima funciona sin clave, limitado a 1 auditoría por IP cada 24 horas. Las mismas claves ms_live_ funcionan tanto en esta API REST como en el servidor MCP de MetricSpot.
curl
Endpoint anónimo, sin token. Devuelve el sobre completo de auditoría en línea.
curl -X POST https://app.metricspot.com/api/public/audit \
-H "Content-Type: application/json" \
-d '{"url":"https://example.com"}'Node (fetch)
Funciona en Node 18+, Bun, Deno y navegadores modernos. Sin dependencias.
const res = await fetch("https://app.metricspot.com/api/audits", {
method: "POST",
headers: {
"Content-Type": "application/json",
"Authorization": "Bearer ms_live_xxx",
},
body: JSON.stringify({ url: "https://example.com" }),
});
const audit = await res.json();Python (httpx)
requests es equivalente: cambia httpx.post por requests.post.
import httpx
res = httpx.post(
"https://app.metricspot.com/api/audits",
headers={"Authorization": "Bearer ms_live_xxx"},
json={"url": "https://example.com"},
)
audit = res.json()PHP
Extensión cURL estándar, disponible en cualquier instalación de PHP desde la 4.0.
<?php
$ch = curl_init("https://app.metricspot.com/api/audits");
curl_setopt_array($ch, [
CURLOPT_POST => true,
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"Authorization: Bearer ms_live_xxx",
],
CURLOPT_POSTFIELDS => json_encode(["url" => "https://example.com"]),
CURLOPT_RETURNTRANSFER => true,
]);
$audit = json_decode(curl_exec($ch), true);Seis endpoints, todo el motor de auditoría
Cada endpoint ejecuta la misma auditoría de 91 reglas y los mismos 11 módulos de puntuación que app.metricspot.com. JSON entra, JSON sale. El endpoint de prueba anónima no requiere clave; los otros cinco aceptan un token Bearer de tu panel.
/api/public/audit Auditoría anónima
Lanza una auditoría puntual de SEO y legibilidad para IA sobre cualquier URL pública. Devuelve puntuaciones en 11 módulos y 91 checks, más hallazgos accionables con enlaces a la documentación. Limitado a 1 auditoría por IP cada 24 horas.
/api/audits Encolar auditoría completa
Encola una auditoría completa de SEO y legibilidad para IA. Incluye Core Web Vitals desde Google PageSpeed Insights y tráfico orgánico si tienes GA4 y Google Search Console conectados. Responde al instante con audit_id y status: queued.
/api/audits/:id Obtener auditoría
Recupera por id una auditoría ya encolada. Devuelve las puntuaciones de los 11 módulos (0-100), la puntuación total, cada hallazgo con severidad y texto de recomendación, y los enlaces a los informes HTML y PDF.
/api/audits Listar auditorías
Lista las auditorías de la cuenta, más recientes primero, deduplicadas por URL. Devuelve audit_id, url, status, total_score y created_at. Límite por defecto 24, máximo 100. Paginación estándar con offset y limit.
/api/audits/:id/pdf Renderizar PDF con marca
Lanza el render del PDF con tu marca para una auditoría. Combina con GET /api/pdfs/:id para obtener la URL firmada de descarga. Los activos de marca (logo, colores, pie) vienen de Brands; pasa brand_id para elegir una marca concreta.
/api/audits/:id/google Tráfico orgánico
Devuelve el snapshot de tráfico orgánico de 28 días para una auditoría si GA4 y Google Search Console están conectados a la URL auditada. Incluye sesiones, tendencia diaria, páginas de aterrizaje principales, queries principales y salud de indexación.
API REST o servidor MCP: cuál encaja con tu stack
Ambas interfaces hablan con el mismo motor de auditoría, con las mismas claves y los mismos datos. Elige REST si escribes HTTP plano desde CI, scripts o herramientas no-code; elige MCP si un agente de IA necesita descubrir y encadenar herramientas por su cuenta.
| Caso de uso | Auditoría SEO manual | Otras APIs de SEO | MCP de MetricSpot | API REST de MetricSpot |
|---|---|---|---|---|
| CI/CD en cada PR | No es viable a ritmo de PR | Posible pero caro por llamada, JSON quebradizo | Excesivo: MCP brilla con agentes interactivos, no con jobs headless | Un curl en un GitHub Action, comenta el delta de puntuación en el PR |
| Herramientas no-code (Zapier, n8n, Make) | Exportación y copiar y pegar manuales | Bloque HTTP a medida, campos mapeados a mano, frágil ante cambios de esquema | Sin soporte MCP en plataformas no-code mayoritarias hoy | Bloque HTTP estándar con Bearer, respuesta JSON que mapea limpiamente |
| Stack polígloto (Go, Ruby, Java) | No aplicable | Hace falta un SDK por lenguaje, a menudo mantenido por la comunidad | Las librerías cliente MCP existen sobre todo para TypeScript y Python | Cualquier lenguaje con cliente HTTPS funciona desde el primer día |
| Jobs internos programados | Horas al mes, fáciles de saltarse | Pricing por llamada, a menudo por keyword o por dominio | Funciona, pero un subproceso stdio es incómodo dentro de cron | HTTPS plano desde cron, Kubernetes CronJob o Lambda |
| Flujos con agentes de IA | Humano en cada bucle | Los agentes pueden llamar a REST, pero necesitan wrappers escritos a mano | Pensado para esto: descripciones y esquemas auto-descubiertos | Posible, pero escribirás tú mismo el código de pegamento del agente |
| PDF con marca en tu SaaS | Exportación y rebrand manuales | Normalmente solo en el plan más caro | Disponible vía get_audit_pdf, diseñado para flujos de agente | POST /api/audits/:id/pdf y luego GET /api/pdfs/:id, embébelo en tu UI |
Precios de la API REST
La API REST está incluida en cada plan de pago de MetricSpot: los mismos créditos de auditoría, los mismos módulos, el mismo PDF. El endpoint de auditoría anónima es gratuito y funciona sin cuenta. Las llamadas autenticadas consumen la misma cuota mensual de auditorías que ves en tu panel. Las mismas claves ms_live_ funcionan en la API REST y en el servidor MCP, sin cuota separada.
Free
$0/mo
Prueba la plataforma. Sin tarjeta, sin compromiso.
- ·10 auditorías al mes (1 por sitio cada 24h)
- ·Los diez módulos de puntuación
- ·Descarga PDF con nuestra marca
- ·Informes multilingües
Starter
$29/mo
Para freelancers con informes mensuales.
- ·Hasta 5 dominios en seguimiento
- ·50 auditorías al mes
- ·Informes PDF con marca blanca completa
- ·Kit de marca personalizado (logo, color, pie)
Pro
$49/mo
Para agencias, freelancers y revendedores.
- ·Todo lo de Starter
- ·Re-auditorías programadas (semanal, quincenal o mensual)
- ·Dominios en seguimiento ilimitados
- ·Envío de informes al cliente por email
Qué construyen los desarrolladores con la API REST
Patrones concretos que vemos en equipos que ya están en producción con la API. Cada ejemplo usa los mismos seis endpoints y el mismo token Bearer.
- •CI/CD: audita cada preview deploy al abrir un PR, comenta el delta de puntuación frente a main y rompe el build si la puntuación cae más de 5 puntos.
- •Zapier, n8n, Make: lanza una auditoría cuando entra un lead nuevo en tu CRM, manda la puntuación total y los 3 hallazgos principales a un canal de Slack y adjunta el PDF con tu marca.
- •Monitorización interna: programa una auditoría nocturna de tus 50 URLs principales, vuelca las puntuaciones de los módulos en un panel de Grafana y alerta cuando cae una categoría.
- •SaaS con marca blanca: encola una auditoría a demanda del usuario, renderiza el PDF con tu marca y embebe los hallazgos JSON en tu propia UI sin alojar el motor de auditoría.
- •Gates de QA: bloquea un deploy si el módulo de legibilidad para IA baja del umbral comprometido con tu cliente, con las reglas fallidas en el log del build.
- •Reportes: lanza GET /api/audits/:id/google después de cada auditoría para enviar un único PDF que combina hallazgos técnicos con datos de tráfico orgánico de 28 días.
Escribir HTTP plano desde un script o un runner de CI es un camino. Si conduces la auditoría desde un agente de IA (Claude Code, Cursor, ChatGPT, Gemini), nuestro servidor MCP de SEO expone las mismas seis herramientas sobre Model Context Protocol con esquemas auto-descubiertos: mismo motor, mismas claves, sin código de pegamento.
Preguntas frecuentes
¿La API REST es gratis?
El endpoint de auditoría anónima (POST /api/public/audit) es gratuito y no requiere cuenta, limitado a 1 auditoría por IP cada 24 horas. Los endpoints autenticados están incluidos en cada plan de MetricSpot, incluido el Free (10 auditorías al mes). No hay precio aparte de la API ni recargo por llamada: las llamadas a la API consumen la misma cuota de auditorías que ves en tu panel.
¿En qué se diferencia esto del servidor MCP?
Mismo motor de auditoría, mismas 91 reglas, mismos 11 módulos, mismas claves Bearer. La API REST es HTTP plano para personas que escriben código: curl, fetch, requests, lo que sea. El servidor MCP habla Model Context Protocol para que los agentes de IA (Claude Code, Cursor, ChatGPT, Gemini) descubran automáticamente herramientas, esquemas y autenticación. Usa REST para CI, scripts y no-code; usa MCP para flujos con agentes.
¿Puedo usarla con herramientas no-code como Zapier?
Sí. Cualquier plataforma no-code con un bloque HTTP genérico funciona: Zapier (Webhooks by Zapier), n8n (HTTP Request node), Make (módulo HTTP), Pipedream, Retool. Pon la URL en https://app.metricspot.com/api/audits, método POST, añade Authorization: Bearer ms_live_xxx a las cabeceras y envía {"url": "https://example.com"} como JSON. La respuesta mapea limpiamente a campos nativos en todas las plataformas probadas.
¿Qué lenguajes tienen SDK oficial?
Ninguno todavía. Lo único necesario es un cliente HTTPS y parsing de JSON, que cualquier lenguaje moderno trae de serie. Un SDK fino de JavaScript y TypeScript está en el roadmap; hasta entonces, los cuatro ejemplos de código de arriba cubren el 90% de las integraciones que vemos. Si quieres un SDK en un lenguaje concreto, abre una issue en github.com/MetricSpot.
¿Cómo me autentico?
Envía Authorization: Bearer ms_live_xxx en cada llamada autenticada. Los tokens llevan el prefijo ms_live_ y se muestran una sola vez al crearlos; el panel guarda solo un hash. Trátalos como cualquier otro secreto: nunca los subas a git, rótalos si los expones, usa una clave por integración para poder revocarlas individualmente. El panel limita cada cuenta a 10 claves activas.
¿De dónde salen las claves API?
Genéralas en app.metricspot.com/settings/api-keys tras registrarte en cualquier plan, incluido el Free. Cada clave se muestra una sola vez; cópiala a tu gestor de secretos al instante. Las mismas claves funcionan en la API REST y en el servidor MCP de MetricSpot, así que solo gestionas un conjunto de credenciales en los dos caminos de integración.
¿Los datos son los mismos que en el panel de MetricSpot?
Sí. Cada endpoint pasa por el mismo motor de auditoría que mueve app.metricspot.com: las mismas 91 reglas en 11 módulos, las mismas severidades, los mismos textos de recomendación. El PDF de POST /api/audits/:id/pdf es el mismo que descargas desde el panel. El tráfico orgánico viene de las mismas conexiones a GA4 y Google Search Console que has autorizado en tu cuenta.
¿Cuáles son los límites de uso?
El endpoint anónimo está limitado a 1 auditoría por IP cada 24 horas. Los endpoints autenticados consumen la cuota mensual de tu plan: Free son 10 al mes (1 por sitio cada 24 horas), Starter son 50 al mes, Pro es ilimitado. No hay un rate limit por segundo más allá de lo que absorba la pipeline de auditoría; si encolas decenas a la vez se procesan en orden.
Deja de escribir informes SEO a mano.
Ejecuta una auditoría, pon tu marca al PDF, envíalo. En cinco minutos.
Empieza tu primera auditoría