run_audit_anonymous

O que esta ferramenta faz

run_audit_anonymous corre uma auditoria síncrona, de uma só vez, de SEO e legibilidade para IA em qualquer URL público sem autenticação. É a única ferramenta MCP que não exige chave API.

• Faz crawl do URL no servidor, corre o motor de regras completo e bloqueia até as descobertas estarem prontas.
• Devolve pontuações de módulo ao longo dos 11 módulos de auditoria (technical, on-page, performance, AI, modern SEO, social, accessibility, privacy, readability, tech stack, mais um total agregado).
• Emite descobertas por regra com passed, severity, title, recommendation opcional, e um docs_url a ligar para metricspot.com/docs/<rule>/.
• NÃO inclui Core Web Vitals do Google PSI (usa run_audit para pontuação PSI completa).
• Limitada a 1 auditoria por IP por 24 horas. Para volume mais alto, emite uma chave API e usa run_audit.

Por que importa

run_audit_anonymous é a porta de entrada sem fricção. Um agente pode auditar um URL na primeira vez que um utilizador o menciona, sem conta, sem chave, e sem configuração para além de instalar o servidor MCP.

Fluxos concretos:

• Um agente de primeiro contacto é questionado “o metricspot.com está indexado corretamente?” e corre a auditoria em linha antes do utilizador se inscrever.
• Um revisor de landing pages no Claude Code lê o URL público de um concorrente, chama run_audit_anonymous, e usa as descobertas para informar o redator sobre o que tem de bater.

Como usá-la

A ferramenta é síncrona: a resposta bloqueia (até cerca de 120 s) até as descobertas estarem prontas. Não há audit_id para fazer polling porque auditorias anónimas não são persistidas na tua conta; a resposta é o resultado inteiro.

Schema de entrada

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

Amostra do schema 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 é sempre a string literal "anonymous". pdf_url e report_url não são devolvidos para auditorias anónimas.

Claude Code

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

Pede:

Corre uma auditoria MetricSpot anónima em https://example.com e lista cada descoberta crítica com o seu docs_url.

Cursor

.cursor/mcp.json:

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

Pede:

Usa run_audit_anonymous neste URL e diz-me que regras de legibilidade para IA falharam.

Python (HTTP direto)

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

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

Erros comuns

Código	Quando	Ação
INVALID_URL (400)	URL em falta, malformado ou maior que 2000 caracteres	Passa um URL absoluto https://
RATE_LIMITED (429)	O IP já correu uma auditoria anónima nas últimas 24h	Espera, ou emite uma chave API e usa run_audit
UPSTREAM_FAILED (5xx)	Host alvo inacessível ou erro no pipeline de auditoria	Tenta uma vez; retryable: true está definido em falhas transitórias

Perguntas frequentes

Porque é que o Core Web Vitals não está incluído?

As chamadas ao PSI custam dinheiro e quota mesmo ao MetricSpot, por isso ficam atrás de run_audit autenticado. As auditorias anónimas continuam a devolver cerca de 90 verificações ao longo dos outros 10 módulos. Se precisares de LCP, CLS e INP, obtém uma chave API e chama run_audit.

Posso correr mais de 1 auditoria anónima por dia?

Não a partir do mesmo IP. O limite é aplicado no servidor para prevenir abuso. Assim que tiveres uma chave API, run_audit levanta o limite para a tua quota do plano: Free 10 por mês, Starter 50, Pro ilimitado.

As auditorias anónimas ficam guardadas na minha conta?

Não. Não são persistidas, não aparecem em list_audits, e não podem ser obtidas depois com get_audit. O resultado completo é devolvido na resposta única, por isso captura-o no cliente se quiseres mantê-lo.