Fragen Sie Claude, Cursor und andere KI-Assistenten zu Ihrem SEO

1. API-Key erstellen

Öffnen Sie in serp.ac Einstellungen → API und erstellen Sie einen Key (nur Kontoinhaber und Admins können das). Kopieren Sie ihn – er wird nur einmal angezeigt. Der MCP-Server nutzt dieselben Keys, dasselbe Rate Limit (120 Anfragen pro Minute pro Key) und dieselben Kontingente wie die REST API. Jeder Key gewährt vollen Zugriff auf das Konto, das ihn erstellt hat – halten Sie ihn geheim und widerrufen Sie ihn auf derselben Seite, falls er bekannt wird.

2. Claude verbinden

Claude (claude.ai und die Claude-Apps) – benutzerdefinierter Connector

Gehen Sie zu Einstellungen → Connectors → Benutzerdefinierten Connector hinzufügen, nennen Sie ihn serp.ac und verwenden Sie die Server-URL https://serp.ac/api/mcp. Der Server authentifiziert jede Anfrage mit Ihrem API-Key, gesendet als Authorization: Bearer sk_live_…; falls der Connector-Dialog in Ihrem Tarif diesen Header nicht senden kann, nutzen Sie stattdessen die Claude-Desktop-Konfiguration unten.

Claude Desktop – Konfigurationsdatei

Öffnen Sie Einstellungen → Entwickler → Konfiguration bearbeiten und fügen Sie den Server zu claude_desktop_config.json hinzu. Dabei läuft die mcp-remote-Bridge (benötigt Node.js), die Ihren Key als Header weiterleitet. Starten Sie Claude Desktop anschließend neu.

{
  "mcpServers": {
    "serp-ac": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://serp.ac/api/mcp", "--header", "Authorization:${SERP_AC_AUTH}"],
      "env": { "SERP_AC_AUTH": "Bearer sk_live_..." }
    }
  }
}

Claude Code

claude mcp add --transport http serp-ac https://serp.ac/api/mcp \
  --header "Authorization: Bearer sk_live_..."

3. Cursor und andere Clients verbinden

Cursor: Fügen Sie den Server zu ~/.cursor/mcp.json (alle Projekte) oder .cursor/mcp.json in einem Projekt hinzu und aktivieren Sie ihn unter Settings → MCP.

{
  "mcpServers": {
    "serp-ac": {
      "url": "https://serp.ac/api/mcp",
      "headers": { "Authorization": "Bearer sk_live_..." }
    }
  }
}

Jeder andere MCP-Client (ChatGPT, VS Code, Windsurf, Ihr eigener Agent) funktioniert genauso, sofern er den Streamable-HTTP-Transport unterstützt und den Authorization-Header senden kann. Clients, die nur stdio unterstützen, können die oben gezeigte mcp-remote-Bridge nutzen.

Schnelltest im Terminal:

curl https://serp.ac/api/mcp \
  -H "Authorization: Bearer sk_live_..." \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Nur-Lese-Modus

Mit Ändert Daten markierte Tools fügen Ihrem Konto etwas hinzu, mit Verbraucht Kontingent markierte Tools verbrauchen Ihre Monatskontingente; Assistenten werden angewiesen, vorher bei Ihnen nachzufragen. Um nur die Lese-Tools freizugeben, verbinden Sie sich mit https://serp.ac/api/mcp?readonly=1. Der Nur-Lese-Modus ist eine Einstellung der Verbindung, nicht des Keys – ein Key trägt immer die vollen Rechte des Kontos.

Tools

Jedes Tool antwortet mit einer kurzen Zusammenfassung plus denselben Daten als strukturiertes JSON. Listen sind begrenzt (bis zu 200 Zeilen) und enthalten ausschließlich Daten Ihres eigenen Kontos. Projekte können per ID oder Domain angegeben werden.

• list_projectsLesen

  Listet die serp.ac-Projekte (Websites) in diesem Konto mit IDs, Domains und der Anzahl der jeweils getrackten Keywords, KI-Prompts und gekauften Links. Zuerst aufrufen, um Projekt-IDs zu erhalten.

• get_rankingsLesen

  Google-Rankings der getrackten Keywords eines Projekts: aktuelle Position, Veränderung seit der letzten Prüfung (positiv = gestiegen), rankende URL, ob eine Google AI Overview angezeigt wird und die Website zitiert, sowie Zeitpunkt der letzten Prüfung. Optionaler Filter nach Keyword-Text und Gerät.

• get_ai_visibilityLesen

  KI-Sichtbarkeit eines Projekts in ChatGPT, Perplexity, Gemini, Claude und Google AI Mode: Anteil der Antworten, die die Marke erwähnen, Zitierrate, durchschnittliche Position, Werte pro Engine, eine Matrix Prompt × Engine, die meistzitierten Quelldomains, Share of Voice und andere Marken, die die KI-Assistenten empfehlen.

• get_backlinks_summaryLesen

  Backlink-Überblick eines Projekts: Gesamtzahl der Backlinks und verweisenden Domains, Domain-Rank, Dofollow-Anteil, neue Links der letzten 30 Tage, verlorene Links und die stärksten verweisenden Domains.

• list_purchased_linksLesen

  Gekaufte (bezahlte) Links im Link-Management: Status (pending, active, issue, lost, expired, cancelled = pausiert), erkannte Probleme, Preis, Abrechnungszyklus, nächster Zahlungs-/Verlängerungstermin und Anbieter, plus in den nächsten 30 Tagen fällige Zahlungen. Alle Projekte, sofern kein Projekt angegeben ist.

• get_index_jobLesen

  Status eines mit check_index gestarteten Index-Prüfauftrags, mit dem Indexstatus jeder URL (indexed, not_indexed, queued, error).

• get_usageLesen

  Tarif und Abo-Status des Kontos, Tarif-Limits mit aktueller Nutzung (Projekte, Keywords, KI-Prompts, Links) und die verbleibenden Monatskontingente (Index-Übermittlungen, Index-Prüfungen, Keyword-Datenabfragen).

• get_maps_rankingsLesen

  Google-Maps-Ranking-Tracking (lokales Geo-Grid) eines Projekts: ohne Kampagne jede Maps-Kampagne mit ihrem neuesten Local-Presence-Score (0–100), Top-10-Abdeckung und durchschnittlichem Rang; mit Kampagne (ID oder Keyword-Text) der Rang des letzten Scans an jedem Rasterpunkt, Scan-Verlauf, besser rankende Wettbewerber und das Local Pack.

• track_keywordsÄndert Daten

  startet das Tracking der Google-Rankings neuer Keywords in einem Projekt. Jedes neue Keyword zählt zum SERP-Keyword-Limit des Tarifs; bereits getrackte Keywords bleiben unverändert. Fragen Sie den Nutzer, bevor Sie viele Keywords hinzufügen.

• add_ai_promptsÄndert Daten

  fügt Prompts (Fragen, die Menschen KI-Assistenten stellen) zum KI-Sichtbarkeits-Tracking eines Projekts hinzu; sie laufen dann nach Zeitplan. Jeder neue Prompt zählt zum KI-Prompt-Limit des Tarifs; bereits getrackte Prompts bleiben unverändert.

• add_purchased_linkÄndert Daten

  fügt einen gekauften (bezahlten) Link zum Link-Management eines Projekts hinzu, damit serp.ac ihn täglich prüft und an Zahlungen erinnert. Zählt zum Limit überwachter Links des Tarifs. Schlägt mit already_tracked fehl, wenn derselbe Link Quelle → Ziel bereits existiert.

• check_indexVerbraucht Kontingent

  startet einen Auftrag, der prüft, ob URLs von Google indexiert sind. Jede URL verbraucht 1 Index-Prüfung aus dem Monatskontingent (danach aus gekauften Paketen); reicht es nicht, wird nichts berechnet. Gibt eine Auftrags-ID zurück – rufen Sie get_index_job für die Ergebnisse auf.

• get_keyword_dataVerbraucht Kontingent

  Suchvolumen, CPC, Wettbewerb, Keyword-Schwierigkeit, Suchintention und 12-Monats-Trend pro Keyword. Jedes nicht zwischengespeicherte Keyword zählt zum kostenpflichtigen monatlichen Kontingent für Keyword-Abfragen (zwischengespeicherte sind kostenlos); prüfen Sie bei großen Listen zuerst get_usage.

Limits und Fehler

• Schreib-Tools folgen Ihrem Tarif genau wie das Dashboard und die REST API: Limits für Keywords, Prompts und Links, im Tarif enthaltene KI-Engines sowie ein aktiver Tarif oder eine Testphase.
• check_index verbraucht 1 Index-Prüfung pro URL aus dem Monatskontingent, danach aus Paketen; get_keyword_data verbraucht das monatliche Kontingent für Keyword-Abfragen bei nicht zwischengespeicherten Keywords. Reicht das Kontingent nicht, wird nichts berechnet.
• Probleme bei einem Aufruf (unbekanntes Projekt, ungültige Argumente, Limit erreicht) werden als Tool-Fehler zurückgegeben, den der Assistent lesen kann. Ein fehlender oder widerrufener Key liefert HTTP 401, ein gesperrtes Konto 403 und zu viele Anfragen 429.

Automatisierung ohne KI-Assistent? Die REST-API-Referenz finden Sie unter Einstellungen → API.