run_audit_anonymous - Docs de MetricSpot

Què fa aquesta eina

run_audit_anonymous executa una auditoria SEO i d’AI-readability síncrona i d’un sol cop sobre qualsevol URL pública sense autenticació. És l’única eina MCP que no requereix una clau d’API.

Rastreja la URL al servidor, executa el motor de regles complet, i bloqueja fins que els findings estan llestos.
Retorna puntuacions per a tots els 11 mòduls d’auditoria (technical, on-page, performance, AI, modern SEO, social, accessibility, privacy, readability, tech stack, més un total agregat).
Emet findings per regla amb passed, severity, title, recommendation opcional, i un docs_url que enllaça a metricspot.com/docs/<rule>/.
NO inclou Core Web Vitals de Google PSI (utilitza run_audit per a la puntuació PSI completa).
Limitat a 1 auditoria per IP cada 24 hores. Per a més volum, emet una clau d’API i utilitza run_audit.

Per què importa

run_audit_anonymous és el punt d’entrada amb fricció zero. Un agent pot auditar una URL la primera vegada que un usuari la menciona, sense compte, sense clau, i sense configuració més enllà d’instal·lar el servidor MCP.

Fluxos concrets:

Un agent de primer contacte rep “està metricspot.com indexat correctament?” i executa l’auditoria en línia abans que l’usuari s’hagi registrat.
Un revisor de landing pages a Claude Code llegeix una URL pública de la competència, crida run_audit_anonymous, i utilitza els findings per informar el redactor sobre què cal superar.

Com utilitzar-la

L’eina és síncrona: la resposta bloqueja (fins a ~120 s) fins que els findings estan llestos. No hi ha cap audit_id sobre el qual fer poll perquè les auditories anònimes no es persisteixen al teu compte; la resposta és el resultat sencer.

Esquema d’entrada

{
  "type": "object",
  "properties": {
    "url": { "type": "string", "format": "uri", "maxLength": 2000 }
  },
  "required": ["url"]
}

Mostra de l’esquema de resposta

{
  "audit_id": "anonymous",
  "url": "https://example.com",
  "status": "complete",
  "total_score": 78,
  "module_scores": {
    "technical": 92,
    "onpage": 71,
    "performance": 64,
    "ai": 80,
    "modern_seo": 75,
    "social": 60,
    "accessibility": 88,
    "privacy": 70,
    "readability": 82,
    "tech_stack": 100
  },
  "findings": [
    {
      "module": "onpage",
      "rule_id": "onpage.title_length",
      "passed": false,
      "severity": "major",
      "title": "Title is too short",
      "recommendation": "Aim for 50-60 characters with the primary keyword near the front.",
      "docs_url": "https://metricspot.com/docs/onpage-title-length/"
    }
  ],
  "created_at": "2026-05-13T10:15:32.000Z"
}

audit_id és sempre la cadena literal "anonymous". pdf_url i report_url no es retornen per a auditories anònimes.

Claude Code

claude mcp add --transport http metricspot https://mcp.metricspot.com/mcp

Prompt:

Run an anonymous MetricSpot audit on https://example.com and list every critical finding with its docs_url.

Cursor

.cursor/mcp.json:

{
  "mcpServers": {
    "metricspot": { "url": "https://mcp.metricspot.com/mcp" }
  }
}

Prompt:

Use run_audit_anonymous on this URL and tell me which AI-readability rules failed.

Python (HTTP en cru)

import httpx

r = httpx.post(
    "https://mcp.metricspot.com/mcp",
    headers={
        "content-type": "application/json",
        "accept": "application/json, text/event-stream",
    },
    json={
        "jsonrpc": "2.0",
        "id": 1,
        "method": "tools/call",
        "params": {
            "name": "run_audit_anonymous",
            "arguments": {"url": "https://example.com"},
        },
    },
    timeout=180.0,
)
print(r.json()["result"]["content"][0]["text"])

Node / TypeScript (HTTP en cru)

const res = await fetch("https://mcp.metricspot.com/mcp", {
  method: "POST",
  headers: {
    "content-type": "application/json",
    accept: "application/json, text/event-stream",
  },
  body: JSON.stringify({
    jsonrpc: "2.0",
    id: 1,
    method: "tools/call",
    params: {
      name: "run_audit_anonymous",
      arguments: { url: "https://example.com" },
    },
  }),
});
const json = await res.json();
console.log(JSON.parse(json.result.content[0].text));

Errors habituals

Codi	Quan	Acció
`INVALID_URL` (400)	URL absent, malformada o més llarga de 2000 caràcters	Passa una URL absoluta `https://`
`RATE_LIMITED` (429)	La IP ja ha executat una auditoria anònima a les darreres 24h	Espera, o emet una clau d’API i utilitza `run_audit`
`UPSTREAM_FAILED` (5xx)	Host objectiu inaccessible o error de la cadena d’auditoria	Reintenta un cop; es retorna `retryable: true` en errors transitoris

Preguntes freqüents

Per què no s’inclouen els Core Web Vitals?

Les crides a PSI costen diners i quota fins i tot per a MetricSpot, així que estan restringides al run_audit autenticat. Les auditories anònimes encara retornen ~90 comprovacions repartides entre els altres 10 mòduls. Si necessites LCP, CLS i INP, obtén una clau d’API i crida run_audit.

Puc executar més d’1 auditoria anònima al dia?

No des de la mateixa IP. El límit s’aplica al servidor per evitar abús. Un cop tens una clau d’API, run_audit aixeca el límit a l’allocació del teu pla: Free 10 al mes, Starter 50, Pro il·limitat.

Les auditories anònimes es desen al meu compte?

No. No es persisteixen, no apareixen a list_audits, i no es poden recuperar més tard amb get_audit. El resultat complet es retorna en una sola resposta, així que captura’l al client si el vols conservar.