API REST de SEO per a desenvolupadors
El mateix motor d'auditoria de 91 regles, accessible per HTTP pla. Porta el teu propi llenguatge: curl, Node, Python, PHP, qualsevol cosa que parli HTTPS. Les mateixes claus API funcionen també amb el nostre servidor MCP.
Sense targeta. Resultats en 30 segons.
Autenticació amb un token Bearer
Cada endpoint autenticat accepta un token a la capçalera Authorization: Authorization: Bearer ms_live_xxx. Genera una clau a app.metricspot.com/settings/api-keys (fins a 10 per compte). L'endpoint d'auditoria anònima funciona sense clau, limitat a 1 auditoria per IP cada 24 hores. Les mateixes claus ms_live_ funcionen tant en aquesta API REST com en el servidor MCP de MetricSpot.
curl
Endpoint anònim, sense token. Retorna el sobre complet de l'auditoria en línia.
curl -X POST https://app.metricspot.com/api/public/audit \
-H "Content-Type: application/json" \
-d '{"url":"https://example.com"}'Node (fetch)
Funciona a Node 18+, Bun, Deno i navegadors moderns. Sense dependències.
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 és equivalent: canvia httpx.post per 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ó cURL estàndard, disponible a qualsevol instal·lació de PHP des de 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);Sis endpoints, tot el motor d'auditoria
Cada endpoint executa la mateixa auditoria de 91 regles i els mateixos 11 mòduls de puntuació que app.metricspot.com. JSON entra, JSON surt. L'endpoint de prova anònima no requereix clau; els altres cinc accepten un token Bearer del teu panell.
/api/public/audit Auditoria anònima
Llança una auditoria puntual de SEO i llegibilitat per IA sobre qualsevol URL pública. Retorna puntuacions a 11 mòduls i 91 checks, més troballes accionables amb enllaços a la documentació. Limitat a 1 auditoria per IP cada 24 hores.
/api/audits Encuar auditoria completa
Encua una auditoria completa de SEO i llegibilitat per IA. Inclou Core Web Vitals des de Google PageSpeed Insights i trànsit orgànic si tens GA4 i Google Search Console connectats. Respon a l'instant amb audit_id i status: queued.
/api/audits/:id Obtenir auditoria
Recupera per id una auditoria ja encuada. Retorna les puntuacions dels 11 mòduls (0-100), la puntuació total, cada troballa amb severitat i text de recomanació, i els enllaços als informes HTML i PDF.
/api/audits Llistar auditories
Llista les auditories del compte, més recents primer, deduplicades per URL. Retorna audit_id, url, status, total_score i created_at. Límit per defecte 24, màxim 100. Paginació estàndard amb offset i limit.
/api/audits/:id/pdf Renderitzar PDF amb marca
Llança el render del PDF amb la teva marca per a una auditoria. Combina amb GET /api/pdfs/:id per obtenir la URL signada de descàrrega. Els actius de marca (logo, colors, peu) vénen de Brands; passa brand_id per triar una marca concreta.
/api/audits/:id/google Trànsit orgànic
Retorna el snapshot de trànsit orgànic de 28 dies per a una auditoria si GA4 i Google Search Console estan connectats a la URL auditada. Inclou sessions, tendència diària, pàgines d'aterratge principals, queries principals i salut d'indexació.
API REST o servidor MCP: quin encaixa amb el teu stack
Totes dues interfícies parlen amb el mateix motor d'auditoria, amb les mateixes claus i les mateixes dades. Tria REST si escrius HTTP pla des de CI, scripts o eines no-code; tria MCP si un agent d'IA necessita descobrir i encadenar eines pel seu compte.
| Cas d'ús | Auditoria SEO manual | Altres APIs de SEO | MCP de MetricSpot | API REST de MetricSpot |
|---|---|---|---|---|
| CI/CD a cada PR | No és viable a ritme de PR | Possible però car per crida, JSON trencadís | Excessiu: MCP brilla amb agents interactius, no amb jobs headless | Un curl en un GitHub Action, comenta el delta de puntuació al PR |
| Eines no-code (Zapier, n8n, Make) | Exportació i copiar i enganxar manuals | Bloc HTTP a mida, camps mapejats a mà, fràgil davant canvis d'esquema | Sense suport MCP a plataformes no-code majoritàries avui | Bloc HTTP estàndard amb Bearer, resposta JSON que mapeja netament |
| Stack polígloth (Go, Ruby, Java) | No aplicable | Cal un SDK per llenguatge, sovint mantingut per la comunitat | Les llibreries client MCP existeixen sobretot per a TypeScript i Python | Qualsevol llenguatge amb client HTTPS funciona des del primer dia |
| Jobs interns programats | Hores al mes, fàcils de saltar-se | Preu per crida, sovint per keyword o per domini | Funciona, però un subprocés stdio és incòmode dins de cron | HTTPS pla des de cron, Kubernetes CronJob o Lambda |
| Fluxos amb agents d'IA | Humà a cada bucle | Els agents poden trucar a REST, però necessiten wrappers escrits a mà | Pensat per a això: descripcions i esquemes autodescoberts | Possible, però hauràs d'escriure tu mateix el codi d'enganxina de l'agent |
| PDF amb marca al teu SaaS | Exportació i rebrand manuals | Normalment només al pla més car | Disponible via get_audit_pdf, dissenyat per a fluxos d'agent | POST /api/audits/:id/pdf i després GET /api/pdfs/:id, incrusta'l a la teva UI |
Preus de l'API REST
L'API REST està inclosa a cada pla de pagament de MetricSpot: els mateixos crèdits d'auditoria, els mateixos mòduls, el mateix PDF. L'endpoint d'auditoria anònima és gratuït i funciona sense compte. Les crides autenticades consumeixen la mateixa quota mensual d'auditories que veus al teu panell. Les mateixes claus ms_live_ funcionen a l'API REST i al servidor MCP, sense quota separada.
Free
$0/mo
Prova la plataforma. Sense targeta, sense compromís.
- ·10 auditories al mes (1 per lloc cada 24h)
- ·Els deu mòduls de puntuació
- ·Descàrrega PDF amb la nostra marca
- ·Informes multilingües
Starter
$29/mo
Per a freelances amb informes mensuals.
- ·Fins a 5 dominis monitoritzats
- ·50 auditories al mes
- ·Informes PDF totalment marca blanca
- ·Kit de marca personalitzat (logo, color, peu de pàgina)
Pro
$49/mo
Per a agències, freelances i revenedors.
- ·Tot el de Starter
- ·Re-auditories programades (setmanal, quinzenal o mensual)
- ·Dominis monitoritzats il·limitats
- ·Enviament directe d'informes per email al client
Què construeixen els desenvolupadors amb l'API REST
Patrons concrets que veiem en equips que ja són en producció amb l'API. Cada exemple fa servir els mateixos sis endpoints i el mateix token Bearer.
- •CI/CD: audita cada preview deploy en obrir un PR, comenta el delta de puntuació davant de main i trenca el build si la puntuació cau més de 5 punts.
- •Zapier, n8n, Make: llança una auditoria quan entra un lead nou al teu CRM, envia la puntuació total i les 3 troballes principals a un canal de Slack i adjunta el PDF amb la teva marca.
- •Monitoratge intern: programa una auditoria nocturna de les teves 50 URLs principals, aboca les puntuacions dels mòduls en un panell de Grafana i alerta quan cau una categoria.
- •SaaS amb marca blanca: encua una auditoria a demanda de l'usuari, renderitza el PDF amb la teva marca i incrusta les troballes JSON a la teva pròpia UI sense allotjar el motor d'auditoria.
- •Gates de QA: bloqueja un deploy si el mòdul de llegibilitat per IA baixa del llindar compromès amb el teu client, amb les regles fallades al log del build.
- •Reports: llança GET /api/audits/:id/google després de cada auditoria per enviar un únic PDF que combina troballes tècniques amb dades de trànsit orgànic de 28 dies.
Escriure HTTP pla des d'un script o un runner de CI és un camí. Si condueixes l'auditoria des d'un agent d'IA (Claude Code, Cursor, ChatGPT, Gemini), el nostre servidor MCP de SEO exposa les mateixes sis eines sobre Model Context Protocol amb esquemes autodescoberts: mateix motor, mateixes claus, sense codi d'enganxina.
Preguntes freqüents
L'API REST és gratis?
L'endpoint d'auditoria anònima (POST /api/public/audit) és gratuït i no requereix compte, limitat a 1 auditoria per IP cada 24 hores. Els endpoints autenticats estan inclosos a cada pla de MetricSpot, inclòs el Free (10 auditories al mes). No hi ha preu apart de l'API ni recàrrec per crida: les crides a l'API consumeixen la mateixa quota d'auditories que veus al teu panell.
En què es diferencia això del servidor MCP?
Mateix motor d'auditoria, mateixes 91 regles, mateixos 11 mòduls, mateixes claus Bearer. L'API REST és HTTP pla per a persones que escriuen codi: curl, fetch, requests, el que sigui. El servidor MCP parla Model Context Protocol perquè els agents d'IA (Claude Code, Cursor, ChatGPT, Gemini) descobreixin automàticament eines, esquemes i autenticació. Fes servir REST per a CI, scripts i no-code; fes servir MCP per a fluxos amb agents.
Puc fer-la servir amb eines no-code com Zapier?
Sí. Qualsevol plataforma no-code amb un bloc HTTP genèric funciona: Zapier (Webhooks by Zapier), n8n (HTTP Request node), Make (mòdul HTTP), Pipedream, Retool. Posa la URL a https://app.metricspot.com/api/audits, mètode POST, afegeix Authorization: Bearer ms_live_xxx a les capçaleres i envia {"url": "https://example.com"} com a JSON. La resposta mapeja netament a camps natius a totes les plataformes provades.
Quins llenguatges tenen SDK oficial?
Cap encara. L'únic necessari és un client HTTPS i parsing de JSON, que qualsevol llenguatge modern porta de sèrie. Un SDK prim de JavaScript i TypeScript és al roadmap; fins llavors, els quatre exemples de codi de dalt cobreixen el 90% de les integracions que veiem. Si vols un SDK en un llenguatge concret, obre una issue a github.com/MetricSpot.
Com m'autentico?
Envia Authorization: Bearer ms_live_xxx a cada crida autenticada. Els tokens porten el prefix ms_live_ i es mostren una sola vegada en crear-los; el panell guarda només un hash. Tracta'ls com qualsevol altre secret: no els pugis mai a git, rota'ls si els exposes, fes servir una clau per integració per poder revocar-les individualment. El panell limita cada compte a 10 claus actives.
D'on surten les claus API?
Genera-les a app.metricspot.com/settings/api-keys després de registrar-te a qualsevol pla, inclòs el Free. Cada clau es mostra una sola vegada; copia-la al teu gestor de secrets a l'instant. Les mateixes claus funcionen a l'API REST i al servidor MCP de MetricSpot, així que només gestiones un conjunt de credencials als dos camins d'integració.
Les dades són les mateixes que al panell de MetricSpot?
Sí. Cada endpoint passa pel mateix motor d'auditoria que mou app.metricspot.com: les mateixes 91 regles en 11 mòduls, les mateixes severitats, els mateixos textos de recomanació. El PDF de POST /api/audits/:id/pdf és el mateix que descarregues des del panell. El trànsit orgànic ve de les mateixes connexions a GA4 i Google Search Console que has autoritzat al teu compte.
Quins són els límits d'ús?
L'endpoint anònim està limitat a 1 auditoria per IP cada 24 hores. Els endpoints autenticats consumeixen la quota mensual del teu pla: Free són 10 al mes (1 per lloc cada 24 hores), Starter són 50 al mes, Pro és il·limitat. No hi ha un rate limit per segon més enllà del que absorbeixi la pipeline d'auditoria; si encues desenes alhora es processen en ordre.
Deixa d'escriure informes SEO a mà.
Executa una auditoria, posa la teva marca al PDF, envia'l. En cinc minuts.
Comença la teva primera auditoria