run_audit_anonymous

Qué hace esta herramienta

run_audit_anonymous ejecuta una auditoría síncrona y puntual de SEO y legibilidad para IA en cualquier URL pública sin autenticación. Es la única herramienta MCP que no requiere clave API.

• Rastrea la URL desde el servidor, ejecuta el motor de reglas completo y bloquea hasta que los hallazgos estén listos.
• Devuelve puntuaciones por módulo en los 11 módulos de auditoría (técnico, on-page, rendimiento, IA, SEO moderno, social, accesibilidad, privacidad, legibilidad, stack tecnológico, más un total agregado).
• Emite hallazgos por regla con passed, severity, title, una recommendation opcional y una docs_url que enlaza a metricspot.com/docs/<rule>/.
• NO incluye Core Web Vitals de Google PSI (usa run_audit para puntuación completa con PSI).
• Limitada a 1 auditoría por IP cada 24 horas. Para mayor volumen, emite una clave API y usa run_audit.

Por qué importa

run_audit_anonymous es el punto de entrada sin fricción. Un agente puede auditar una URL la primera vez que el usuario la mencione, sin cuenta, sin clave y sin más configuración que instalar el servidor MCP.

Flujos concretos:

• Un agente de primer contacto recibe la pregunta “¿metricspot.com está indexado correctamente?” y ejecuta la auditoría en línea antes de que el usuario se registre.
• Un revisor de landing pages en Claude Code lee una URL pública de un competidor, llama a run_audit_anonymous y usa los hallazgos para informar al redactor sobre lo que hay que superar.

Cómo usarla

La herramienta es síncrona: la respuesta bloquea (hasta ~120 s) hasta que los hallazgos estén listos. No hay audit_id que sondear porque las auditorías anónimas no se persisten en tu cuenta; la respuesta es el resultado completo.

Esquema de entrada

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

Ejemplo de esquema de respuesta

{
  "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 es siempre la cadena literal "anonymous". pdf_url y report_url no se devuelven en auditorías anónimas.

Claude Code

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

Pide:

Ejecuta una auditoría anónima de MetricSpot en https://example.com y lista cada hallazgo crítico con su docs_url.

Cursor

.cursor/mcp.json:

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

Pide:

Usa run_audit_anonymous en esta URL y dime qué reglas de legibilidad para IA fallaron.

Python (HTTP crudo)

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 crudo)

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));

Errores comunes

Código	Cuándo	Acción
INVALID_URL (400)	URL ausente, malformada o de más de 2000 caracteres	Pasa una URL absoluta con https://
RATE_LIMITED (429)	La IP ya ejecutó una auditoría anónima en las últimas 24 h	Espera, o emite una clave API y usa run_audit
UPSTREAM_FAILED (5xx)	Host destino inalcanzable o error en la cadena de auditoría	Reintenta una vez; en fallos transitorios se establece retryable: true

Preguntas frecuentes

¿Por qué no se incluye Core Web Vitals?

Las llamadas a PSI tienen coste y cuota incluso para MetricSpot, así que están detrás del run_audit autenticado. Las auditorías anónimas siguen devolviendo ~90 comprobaciones en los otros 10 módulos. Si necesitas LCP, CLS e INP, obtén una clave API y llama a run_audit.

¿Puedo ejecutar más de 1 auditoría anónima al día?

No desde la misma IP. El tope se aplica en el servidor para evitar abusos. Una vez que tienes clave API, run_audit levanta el límite a la asignación de tu plan: Free 10 al mes, Starter 50, Pro ilimitado.

¿Las auditorías anónimas se guardan en mi cuenta?

No. No se persisten, no aparecen en list_audits y no se pueden recuperar después con get_audit. El resultado completo se devuelve en la única respuesta, así que captúralo del lado cliente si quieres conservarlo.