MCP & API

KI-Sichtbarkeit aus Claude, Ihren Agenten und Ihrer Pipeline bewerten.

AeoState betreibt einen Model-Context-Protocol-Server (MCP) unter https://aeostate.com/mcp – mit derselben HTTP-API dahinter. Einmal verbinden, und der kostenlose KI-Sichtbarkeits-Score erscheint als interaktive Karte in Claude Desktop, claude.ai, Claude Code, Cursor und jedem anderen MCP-Host – oder rufen Sie die API direkt aus einem Skript auf.

Werkzeuge

Kostenlose Werkzeuge funktionieren für alle – ohne Konto, ohne Schlüssel. Werkzeuge mit der Kennzeichnung „API-Schlüssel“ handeln für ein registriertes Konto: kostenloses Konto anlegen, dann einen persönlichen Schlüssel unter Konto → API-Zugang erstellen.

In einem Schritt verbinden

Kopieren Sie einen dieser Ausschnitte in Ihren Host. Fügen Sie den Authorization-Header hinzu, sobald Sie einen Schlüssel haben.

MCP-Endpunkt
https://aeostate.com/mcp
Claude Code
claude mcp add --transport http aeostate https://aeostate.com/mcp
Cursor, VS Code, claude.ai-Connectors und andere Hosts (JSON)
{
  "mcpServers": {
    "aeostate": {
      "url": "https://aeostate.com/mcp"
    }
  }
}
Dasselbe, im Namen Ihres Kontos
{
  "mcpServers": {
    "aeostate": {
      "url": "https://aeostate.com/mcp",
      "headers": {
        "Authorization": "Bearer <your-api-key>"
      }
    }
  }
}

Schlichtes HTTP für Pipelines

Dieselben drei Aufrufe, die der MCP-Server macht. Scan starten, abfragen, Bericht lesen – aus CI, einem CRM-Workflow oder einem nächtlichen Job.

1 · Scan starten
curl -s -X POST https://aeostate.com/api/analyze \
  -H "content-type: application/json" \
  -d '{"url":"https://example.com","industry":"family dental clinic","category":"family dental clinic","locale":"en"}'
# → {"mode":"async","jobId":"…"} (poll below) or the finished free summary
2 · Abfragen, bis er fertig ist
curl -s https://aeostate.com/api/scan-jobs/<jobId>
# → {"status":"queued|running|completed|failed","stage":"crawling|scoring|completed","reportId":"…"}
3 · Bericht lesen
curl -s https://aeostate.com/api/reports/<reportId>
# → 402 + the free summary (score, grade, confidence, section teasers)

Anonyme Scans folgen den Regeln des kostenlosen Scores der Website (Ratenlimits; wo der kostenlose Score per E-Mail freigeschaltet wird, kommt der Link per E-Mail). Mit einem Schlüssel laufen sie als Ihr Konto: keine Schranke, Limits pro Schlüssel und Ihre bezahlten Berichte.

Wie KI-Agenten AeoState finden

Neben dem MCP-Server veröffentlicht AeoState maschinenlesbare Beschreibungen, damit KI-Agenten und Agenten-Verzeichnisse es selbstständig finden. Jede Adresse unten antwortet mit JSON, das jede Website lesen darf.

MCP-Serverkarte
https://aeostate.com/.well-known/mcp/server-card.json
KI-Katalog (ARD)
https://aeostate.com/.well-known/ai-catalog.json
API-Katalog (RFC 9727)
https://aeostate.com/.well-known/api-catalog

Skills für Agenten (Agent Skills)

Agenten, die Agent Skills unterstützen, können den von AeoState veröffentlichten Skill aus diesem Index laden. Er zeigt ihnen, wie sie über den MCP-Server oder die HTTP-API eine kostenlose Prüfung der KI-Sichtbarkeit starten und das Ergebnis lesen. Jeder Skill ist mit einem SHA-256-Hash aufgeführt, damit der Agent prüfen kann, was er heruntergeladen hat.

Agent-Skills-Index
https://aeostate.com/.well-known/agent-skills/index.json

Seiten als Markdown

Fordern Sie eine öffentliche Seite mit dem Header Accept: text/markdown an, um ihren Text als Markdown statt als HTML zu erhalten, mit Titel, Adresse und Sprache am Anfang. Browser erhalten weiterhin die normale Seite.

Beispiel
curl -H "Accept: text/markdown" https://aeostate.com/de/pricing

Tools im Browser (WebMCP)

In einem Browser mit WebMCP-Unterstützung kann ein KI-Agent auf dieser Website Seiten öffnen, die aktuellen Preise abrufen, einen laufenden Scan prüfen und das Formular für den kostenlosen Score ausfüllen. Bestätigen und absenden muss das Formular weiterhin die besuchende Person. WebMCP ist experimentell und nur in einigen Browser-Versionen verfügbar; überall sonst ändert sich nichts.

Kostenloser Score und Advanced-Bericht

Ohne Konto

Kostenloser Score – jedes Werkzeug, jeder Besucher

  • Ihr Gesamt-Sichtbarkeitswert, die Note und unsere Konfidenz
  • Wie klar Ihre veröffentlichten Inhalte KI-Antworten unterstützen
  • Der wichtigste Befund, der Ihre Sichtbarkeit bremst

Persönlichen API-Schlüssel erhalten

Melden Sie sich an (oder erstellen Sie ein kostenloses Konto), öffnen Sie Konto → API-Zugang, erstellen Sie einen Schlüssel und fügen Sie ihn in die Ausschnitte oben ein. Schlüssel wirken nur auf Scans und die Berichte, die Sie gekauft haben – nie auf Ihr Konto, die Abrechnung oder die Berichte anderer.

Schlüssel holen