run_audit_anonymous

Was dieses Tool tut

run_audit_anonymous führt ein synchrones, einmaliges SEO- und KI-Lesbarkeits-Audit auf jeder öffentlichen URL ohne Authentifizierung aus. Es ist das einzige MCP-Tool, das keinen API-Schlüssel benötigt.

• Crawlt die URL serverseitig, führt die komplette Regel-Engine aus und blockiert, bis die Befunde bereit sind.
• Liefert Modul-Scores über die 11 Audit-Module (technisch, On-Page, Performance, KI, Modern SEO, Social, Barrierefreiheit, Datenschutz, Lesbarkeit, Tech-Stack, plus einen aggregierten Gesamtwert).
• Gibt Befunde pro Regel aus mit passed, severity, title, optionaler recommendation und einer docs_url, die auf metricspot.com/docs/<rule>/ verlinkt.
• Enthält KEINE Core Web Vitals aus Google PSI (für vollständiges PSI-Scoring nutze run_audit).
• Gedeckelt auf 1 Audit pro IP pro 24 Stunden. Für höheres Volumen stellst du einen API-Schlüssel aus und verwendest run_audit.

Warum es wichtig ist

run_audit_anonymous ist der reibungslose Einstiegspunkt. Ein Agent kann eine URL beim ersten Erwähnen direkt auditieren, ohne Konto, ohne Schlüssel und ohne Setup über die Installation des MCP-Servers hinaus.

Konkrete Workflows:

• Ein First-Touch-Agent wird gefragt “ist metricspot.com richtig indexiert?” und führt das Audit inline aus, bevor der User sich registriert hat.
• Ein Landingpage-Reviewer in Claude Code liest eine öffentliche Mitbewerber-URL, ruft run_audit_anonymous auf und nutzt die Befunde, um den Autor zu briefen, was er schlagen muss.

So nutzt du es

Das Tool ist synchron: Die Antwort blockiert (bis ca. 120 s), bis die Befunde bereit sind. Es gibt keine audit_id zum Pollen, weil anonyme Audits nicht in deinem Konto gespeichert werden; die Antwort ist das vollständige Ergebnis.

Input-Schema

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

Beispiel-Response

{
  "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 ist immer die wörtliche Zeichenkette "anonymous". pdf_url und report_url werden bei anonymen Audits nicht zurückgegeben.

Claude Code

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

Prompt:

Führe ein anonymes MetricSpot-Audit auf https://example.com aus und liste jeden kritischen Befund mit seiner docs_url auf.

Cursor

.cursor/mcp.json:

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

Prompt:

Nutze run_audit_anonymous auf dieser URL und sag mir, welche KI-Lesbarkeits-Regeln fehlgeschlagen sind.

Python (roher HTTP)

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 (roher HTTP)

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

Häufige Fehler

Code	Wann	Aktion
INVALID_URL (400)	URL fehlt, ist fehlerhaft oder länger als 2000 Zeichen	Übergib eine absolute https://-URL
RATE_LIMITED (429)	IP hat in den letzten 24h schon ein anonymes Audit gemacht	Warten oder API-Schlüssel ausstellen und run_audit nutzen
UPSTREAM_FAILED (5xx)	Ziel-Host nicht erreichbar oder Audit-Pipeline-Fehler	Einmal erneut versuchen; retryable: true ist bei transienten Fehlern gesetzt

Häufig gestellte Fragen

Warum sind Core Web Vitals nicht enthalten?

PSI-Aufrufe kosten Geld und Kontingent auch für MetricSpot, deshalb sind sie hinter authentifiziertem run_audit gesperrt. Anonyme Audits liefern trotzdem ca. 90 Prüfungen über die anderen 10 Module. Wenn du LCP, CLS und INP brauchst, hol dir einen API-Schlüssel und rufe stattdessen run_audit auf.

Kann ich mehr als 1 anonymes Audit pro Tag laufen lassen?

Nicht von derselben IP. Das Cap wird serverseitig durchgesetzt, um Missbrauch zu verhindern. Sobald du einen API-Schlüssel hast, hebt run_audit das Limit auf dein Plan-Kontingent: Free 10 pro Monat, Starter 50, Pro unbegrenzt.

Werden anonyme Audits in meinem Konto gespeichert?

Nein. Sie werden nicht persistiert, tauchen nicht in list_audits auf und können später nicht mit get_audit abgerufen werden. Das vollständige Ergebnis wird in der einzelnen Antwort zurückgegeben, also fang es clientseitig ein, wenn du es behalten willst.