superaudit-mcp

MCP-Server (Model Context Protocol), der die echte und kostenlose Prüfung von SuperAudit als ein Tool bereitstellt, das jeder MCP-kompatible KI-Agent aufrufen kann.

Damit kann ein externer Entwickler seinem eigenen Agenten (Claude oder einem anderen MCP-Client) Dinge wie "prüfe diese Website mit SuperAudit" sagen, ohne mit jemandem vom SuperAudit-Team zu sprechen — das Tool ruft direkt den öffentlichen Produktionsendpunkt auf.

Was es tut

Stellt ein einziges Tool bereit: audit_website.

• Eingabe:

  • url (erforderlich): Domain oder URL, die geprüft werden soll, z. B. "minegocio.es" oder "https://minegocio.es".

  • raw_json (optional, boolean, Standard false): Wenn true, wird zusätzlich zur lesbaren Zusammenfassung das vollständige JSON zurückgegeben, genau wie es SuperAudit liefert (alle Module, alle Punktzahlen, die Pläne).

• Was intern passiert: Es ruft POST https://superaudit.airpagents.pro/api/quick-audit mit { "web": "<url>" } auf — denselben öffentlichen Endpunkt, den die SuperAudit-Landing heute für den kostenlosen Scan verwendet. Es ist kein Schlüssel oder Token erforderlich.

• Ausgabe: eine Textzusammenfassung mit dem Gesamtscore (0-100), der Punktzahl jedes der ~27 Module (SEO, Sicherheit, Recht/DSGVO, Core Web Vitals, WCAG-Barrierefreiheit, Sichtbarkeit in generativer KI, WordPress/CVEs, OWASP Top 10 usw.), den wichtigsten erkannten Problemen und dem kostenpflichtigen Plan, den SuperAudit je nach Ergebnis empfiehlt.

Related MCP server: foglift-mcp

Bekannte Grenzen (wichtig)

• Der öffentliche Endpunkt hat ein Limit von 10 Anfragen pro Minute pro IP auf dem SuperAudit-Server. Wird es überschritten, gibt das Tool einen entsprechenden Fehler zurück — es versucht es nicht automatisch erneut, um den Dienst nicht zu überlasten.

• Das Backend cached jede geprüfte Domain 24 Stunden lang, sodass eine erneute Prüfung derselben Website kurz darauf sofort erfolgt.

• Eine "kalte" Prüfung (nicht gecachte Domain) kann gut mehrere Sekunden dauern: Der Client wartet bis zu 90s, bevor er den Versuch als fehlgeschlagen betrachtet.

• Das Backend validiert, dass die URL auf eine echte öffentliche Domain zeigt (es blockiert private IPs/localhost als SSRF-Maßnahme) — wenn die Website nicht existiert oder nicht online ist, gibt das Tool einen lesbaren Fehler zurück, keinen stillen Fehlschlag.

Installation (für einen externen Entwickler)

Voraussetzungen: Node.js 18 oder höher.

git clone <este repositorio>   # o simplemente copia esta carpeta
cd superaudit-mcp
npm install
npm run build

Dadurch wird dist/index.js erzeugt, das Binärprogramm des MCP-Servers (es kommuniziert über stdio, den Standardtransport von MCP).

Eigenständig testen (optional)

npm run build
node dist/index.js

Der Prozess wartet auf stdio — das ist normal, so funktionieren MCP-Server. Er wird von einem MCP-Client verbunden, nicht als interaktive CLI verwendet.

So verbinden Sie es mit einem MCP-Client

Claude Code

claude mcp add superaudit -- node "/ruta/completa/a/superaudit-mcp/dist/index.js"

Claude Desktop

Bearbeiten Sie die Konfigurationsdatei von Claude Desktop (claude_desktop_config.json) und fügen Sie Folgendes hinzu:

{
  "mcpServers": {
    "superaudit": {
      "command": "node",
      "args": ["/ruta/completa/a/superaudit-mcp/dist/index.js"]
    }
  }
}

Starten Sie Claude Desktop neu. Das Tool audit_website wird verfügbar sein, damit der Agent es nutzen kann, wenn es das Gespräch erfordert (z. B. "prüfe minegocio.es mit SuperAudit").

Jeder andere MCP-Client

Jeder Client, der MCP-Server über stdio unterstützt, kann node dist/index.js als Serverbefehl ausführen — es sind keine zusätzliche Konfiguration oder Umgebungsvariablen erforderlich.

Umgebungsvariablen (optional)

• SUPERAUDIT_BASE_URL: standardmäßig https://superaudit.airpagents.pro. Eine Änderung ist nur sinnvoll, um auf eine eigene Testumgebung zu zeigen.

Es ist kein API-Key erforderlich: Der Endpunkt, den dieses Tool verwendet, ist derselbe, den die öffentliche SuperAudit-Landing für den kostenlosen Scan nutzt.

Entwicklung

npm install
npm run build   # compila TypeScript → dist/

Es gibt keine automatisierten Tests in dieser ersten Auslieferung — es wurde manuell mit einem echten MCP-Client verifiziert (Handshake initialize + tools/list

• tools/call) gegen den Produktionsendpunkt.