SurfRank MCP-Server

Lassen Sie Ihren KI-Agenten KI-Sichtbarkeitsberichte erstellen, Keywords recherchieren und Wettbewerber auf SurfRank verfolgen — direkt aus dem Chat-Fenster.

Dieses Paket stellt die öffentliche API von SurfRank als Model Context Protocol (MCP)-Tools bereit, sodass jeder MCP-kompatible KI-Assistent — Claude Desktop, Claude Code, Cursor, Windsurf, ChatGPT MCP-Connectors und andere — SurfRank in Ihrem Namen aufrufen kann.

Was ist SurfRank?

SurfRank misst, wie sichtbar Ihre Marke in KI-Antworten (ChatGPT, Perplexity, Gemini, Claude, Grok, DeepSeek, Meta AI) ist. Es prüft Ihre verfolgten Keywords gegen jede Engine, bewertet Ihre Erwähnungen im Vergleich zu Wettbewerbern und zeigt die Content-Möglichkeiten auf, die den größten Einfluss hätten.

Related MCP server: DataForSEO MCP Server

Was ist MCP?

Das Model Context Protocol ist ein offener Standard von Anthropic, der es KI-Agenten ermöglicht, externe Tools zu entdecken und aufzurufen. Installieren Sie diesen Server einmal, und Ihr Agent erhält 24 neue Fähigkeiten — keine Plugin-APIs, kein OAuth-Aufwand, kein Klebecode.

Was Sie Ihren Agenten fragen können, sobald dies verbunden ist

💬 "Erstelle ein SurfRank-Projekt für surfrank.ai in der SaaS-Branche und verfolge dann diese 10 Keywords…"

💬 "Was hat mein neuester KI-Sichtbarkeitsbericht ergeben? Welche Engines vermissen meine Marke?"

💬 "Führe einen schnellen Test für competitor.com durch und vergleiche ihn mit meinem Score."

💬 "Liste meine Top 5 Content-Möglichkeiten auf und entwirf Artikel für die mit der höchsten Wirkung."

Der Agent wählt das richtige Tool aus, ruft die SurfRank-API mit Ihrem Schlüssel auf und antwortet in natürlicher Sprache. Credits werden von Ihrem SurfRank-Konto zum gleichen Satz wie bei direkten API-Aufrufen abgebucht.

Anforderungen

• Node.js 18 oder neuer (erforderlich durch das MCP SDK).

• Ein SurfRank API-Schlüssel im Pay As You Go-Plan. Generieren Sie einen unter app.surfrank.ai/api-management.

• Ein MCP-kompatibler Client (siehe Abschnitt Konfiguration).

Installation

Führen Sie es ad-hoc mit npx aus — keine Installation erforderlich:

npx -y @surfrank/mcp-server

Oder installieren Sie es global:

npm install -g @surfrank/mcp-server

Konfiguration

Wählen Sie unten Ihren Client aus und fügen Sie den Schnipsel in dessen MCP-Konfigurationsdatei ein.

Claude Desktop

Bearbeiten Sie Ihre Claude Desktop-Konfigurationsdatei:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

• Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "surfrank": {
      "command": "npx",
      "args": ["-y", "@surfrank/mcp-server"],
      "env": {
        "SURFRANK_API_KEY": "sr_your_key_here"
      }
    }
  }
}

Starten Sie Claude Desktop neu. Sie sollten surfrank im Menü der MCP-Server sehen.

Cursor

Bearbeiten Sie ~/.cursor/mcp.json (oder verwenden Sie Einstellungen → MCP → Server hinzufügen):

{
  "mcpServers": {
    "surfrank": {
      "command": "npx",
      "args": ["-y", "@surfrank/mcp-server"],
      "env": {
        "SURFRANK_API_KEY": "sr_your_key_here"
      }
    }
  }
}

Claude Code

claude mcp add surfrank -- npx -y @surfrank/mcp-server
export SURFRANK_API_KEY=sr_your_key_here

Windsurf

Bearbeiten Sie ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "surfrank": {
      "command": "npx",
      "args": ["-y", "@surfrank/mcp-server"],
      "env": { "SURFRANK_API_KEY": "sr_your_key_here" }
    }
  }
}

Verfügbare Tools

Der Server stellt jeden öffentlichen API-Endpunkt von SurfRank als Tool bereit (insgesamt 24). Ihr Agent entdeckt diese automatisch — Sie müssen sie nicht in Ihrem Prompt auflisten.

Jedes Tool entspricht 1:1 einem REST-Endpunkt unter https://api.surfrank.ai/api/v1/public/*.

Bereichsbezogene API-Schlüssel (Scoped API keys)

Wenn Sie einen projektbezogenen API-Schlüssel generieren, kann der MCP-Server nur für dieses Projekt arbeiten. Jeder Tool-Aufruf, der sich auf eine andere Projekt-ID bezieht, wird mit einem 403 von der SurfRank-API abgelehnt, und der Fehler erscheint wortwörtlich in der Antwort des Agenten.

Dies ist die empfohlene Einrichtung, wenn Sie einen einzelnen Arbeitsbereich oder einen Teamkollegen mit einer einzelnen Marke verbinden.

Credit-Verbrauch

Credits werden von Ihrem SurfRank-Konto gemäß der gleichen Preisgestaltung wie bei direkten API-Aufrufen abgebucht:

Jede Tool-Antwort enthält ein credits-Objekt, damit Ihr Agent (und Sie) den Verbrauch in Echtzeit verfolgen können.

Umgebungsvariablen

Debugging

Verwenden Sie den offiziellen MCP-Inspektor, um den Server direkt zu untersuchen — nützlich beim Onboarding eines neuen Clients oder bei der Diagnose eines Verbindungsproblems:

SURFRANK_API_KEY=sr_your_key_here \
  npx @modelcontextprotocol/inspector npx @surfrank/mcp-server

Der Inspektor öffnet eine Browser-Benutzeroberfläche, in der Sie Tools auflisten und manuell aufrufen können, genau wie es ein KI-Agent tun würde.

Sicherheitshinweise

• API-Schlüssel werden bei der Erstellung einmalig angezeigt und als SHA-256-Hashes auf den Servern von SurfRank gespeichert. Wenn Sie einen Schlüssel verlieren, widerrufen Sie ihn und generieren Sie einen neuen — er kann nicht wiederhergestellt werden.

• Anmeldedaten verbleiben in Ihrer lokalen MCP-Konfigurationsdatei. Dieses Paket schreibt sie niemals auf die Festplatte und sendet sie niemals nach Hause.

• Jeder API-Schlüssel ist auf 60 Anfragen pro Minute begrenzt. Ein Überschreiten führt zu einem HTTP 429.

Links

• 🌐 SurfRank — surfrank.ai

• 🔑 API-Verwaltung — app.surfrank.ai/api-management

• 📘 Öffentliche API-Dokumentation — im Tab API-Verwaltung → Dokumentation

• 🐛 Probleme — github.com/SurfRankAI/mcp-server/issues

• 📦 npm — @surfrank/mcp-server

Lizenz

MIT © SurfRank Pte. Ltd. — siehe LICENSE.