SEO Tools MCP-Server

Ein umfassender stdio MCP-Server (Model Context Protocol) für SEO-APIs. Dieser Server ermöglicht es LLMs (Large Language Models), mit DataForSEO-API-Funktionen und anderen SEO-Tools zu interagieren.

Übersicht

Der SEO Tools MCP-Server ermöglicht eine nahtlose Integration zwischen LLMs wie Claude und verschiedenen SEO-APIs. Dadurch können SEO-Analysen, Keyword-Recherchen, Backlink-Analysen und viele weitere SEO-bezogene Aufgaben direkt durch Interaktionen in natürlicher Sprache durchgeführt werden.

Diese Implementierung stellt alle wichtigen DataForSEO-API-Endpunkte als MCP-Tools bereit, die von LLMs aufgerufen werden können, um spezifische SEO-Daten abzurufen. Der Server verwendet stdio als Transportebene, was die Integration in verschiedene LLM-Plattformen erleichtert.

Related MCP server: DataForSEO MCP Server

Funktionen

• Umfassende Abdeckung der DataForSEO-API-Endpunkte

• Optionale Integration mit Local Falcon und anderen SEO-Tools von Drittanbietern

• Stdio-Transport für einfache Integration

• Authentifizierungsverwaltung

• Detaillierte Fehlerberichterstattung

• Typsichere Tool-Definitionen mit Zod-Schemas

• Erweiterbare Architektur zum Hinzufügen neuer API-Integrationen

• Selektive Modul- und Tool-Filterung über Umgebungsvariablen

Registrierung bei Data for Seo

https://dataforseo.com/?aff=200885

Implementierte API-Kategorien

DataForSEO API

1. SERP API - Suchmaschinenergebnisdaten von Google, Bing, Yahoo und mehr

2. Keywords Data API - Keyword-Recherche, Vorschläge und Suchvolumendaten

3. DataForSEO Labs API - Fortgeschrittene SEO-Analysen, Domain-Vergleiche und Keyword-Analysen

4. Backlinks API - Backlink-Profile, verweisende Domains und Ankertext-Analysen

5. OnPage API - Website-Audit, Inhaltsanalyse und technische SEO-Prüfungen

6. Domain Analytics API - Erkennung des Technologie-Stacks und Domain-Datenanalyse

7. Content Analysis API - Bewertung der Inhaltsqualität und semantische Analyse

8. Content Generation API - KI-gestützte Tools zur Inhaltserstellung

9. Merchant API - E-Commerce-Daten von Amazon und Google Shopping

10. App Data API - Mobile App-Daten von Google Play und App Store

11. Business Data API - Branchenverzeichnisdaten von Google My Business, Trustpilot und mehr

12. AI Optimization API - LLM-Antworten, KI-Scraper und KI-Keyword-Daten von ChatGPT, Claude, Gemini und Perplexity

Local Falcon API (Optional)

1. Calculate Grid Points - Rasterkoordinaten für die lokale Ranking-Analyse generieren

2. Search GMB Locations - Google My Business-Standorte per Abfrage finden

3. Get Ranking at Coordinate - Unternehmensranking an bestimmten Koordinaten prüfen

4. Keyword Search at Coordinate - Suchbegriffe an bestimmten Standorten testen

5. Run Grid Search - Vollständige rasterbasierte lokale Ranking-Analyse durchführen

Installation

# Clone the repository
git clone https://github.com/Skobyn/dataforseo-mcp-server.git

# Change to the project directory
cd dataforseo-mcp-server

# Install dependencies
npm install

# Build the project
npm run build

Verwendung

Um diesen MCP-Server zu nutzen, benötigen Sie API-Zugangsdaten für die Dienste, die Sie verwenden möchten.

Ausführen des Servers mit DataForSEO

# Set environment variables for DataForSEO authentication
export DATAFORSEO_LOGIN="your_login"
export DATAFORSEO_PASSWORD="your_password"

# Run the server
npm start

Ausführen des Servers mit DataForSEO und Local Falcon

# Set environment variables for all API authentications
export DATAFORSEO_LOGIN="your_login"
export DATAFORSEO_PASSWORD="your_password"
export LOCALFALCON_API_KEY="your_localfalcon_api_key"
# Optional: Set custom Local Falcon API URL if needed
# export LOCALFALCON_API_URL="https://custom-localfalcon-url.com/api"

# Run the server
npm start

Filtern von Modulen und Tools

Der Server stellt standardmäßig Hunderte von Tools bereit. Bei der Verwendung mit LLMs verbraucht die vollständige Tool-Liste erheblichen Platz im Kontextfenster. Sie können die Anzahl der bereitgestellten Tools mithilfe von Umgebungsvariablen reduzieren, um nur die Module oder Tools zu aktivieren, die Sie benötigen.

Warum filtern?

• Reduzierung des Kontextverbrauchs

• Schnellere Tool-Erkennung für das LLM

• Fokussiertere Antworten

Filtern nach Modul

Verwenden Sie ENABLED_MODULES, um nur bestimmte API-Kategorien zu aktivieren (durch Kommas getrennt, nicht zwischen Groß- und Kleinschreibung unterscheidend):

export ENABLED_MODULES="SERP,BUSINESS_DATA,LABS"

Verfügbare Module:

• SERP - Suchmaschinenergebnisse

• KEYWORDS_DATA - Keyword-Recherche

• LABS oder DATAFORSEO_LABS - Fortgeschrittene SEO-Analysen

• BACKLINKS - Backlink-Analyse

• ONPAGE - Website-Audits

• DOMAIN_ANALYTICS - Domain-Daten

• CONTENT_ANALYSIS - Inhaltsbewertung

• CONTENT_GENERATION - KI-Inhaltserstellung

• MERCHANT - E-Commerce-Daten

• APP_DATA - Mobile App-Daten

• BUSINESS_DATA - Branchenverzeichnisse

• AI_OPTIMIZATION - LLM-Antworten und KI-Daten

Filtern nach individuellem Tool

Verwenden Sie ENABLED_TOOLS für eine fein abgestimmte Kontrolle über bestimmte Tools (durch Kommas getrennt, nicht zwischen Groß- und Kleinschreibung unterscheidend):

export ENABLED_TOOLS="serp_google_maps_live,business_data_google_my_business_info"

Wenn keine der Variablen gesetzt ist, sind standardmäßig alle Module und Tools aktiviert.

Modulbezogene Abonnements und 404-Fehler

Der Zugriff auf DataForSEO wird oft pro Modul gewährt, nicht als ein einziges Alles-oder-Nichts-Abonnement. Das bedeutet, dass einige Endpunkte funktionieren können, während andere 404 zurückgeben.

Wichtige Interpretationsregel:

• 404 bei bekannten aktiven Endpunkten wie SERP, App Data, DataForSEO Labs App Store oder Content Generation kann bedeuten, dass das Modul für das aktuelle Konto nicht aktiviert ist

• Dies ist nicht notwendigerweise ein Fehler im MCP-Server oder ein falscher Endpunktpfad

• Kostenlose Discovery-Endpunkte wie Standorte oder Sprachen können weiterhin funktionieren, auch wenn kostenpflichtige Live-Endpunkte im selben Bereich nicht verfügbar sind

Der Server normalisiert jetzt bekannte 404-Antworten auf Modulebene in eine klarere Meldung:

• DataForSEO module not enabled: <module> ...

Wenn dies geschieht, aktivieren Sie das Modul im DataForSEO-Dashboard oder wechseln Sie zu Tools aus Modulen, die für das aktuelle Konto bereits aktiviert sind.

Verwendung mit Claude oder anderen LLMs

Dieser Server implementiert das Model Context Protocol, das es LLMs ermöglicht, auf standardisierte Weise mit externen Systemen zu interagieren. Um ihn mit Claude zu verwenden, müssen Sie ihn gemäß der spezifischen MCP-Implementierung in Ihre LLM-Plattform integrieren.

Siehe das Verzeichnis examples für Anwendungsbeispiele.

Entwicklung

# Run in development mode with hot reloading
npm run dev

# Run tests
npm test

Beispiele

Sehen Sie sich das Verzeichnis examples für Beispielcode an, der zeigt, wie der SEO Tools MCP-Server verwendet wird.

Das grundlegende Beispiel demonstriert:

• Starten des Servers

• Verbinden von einem Client aus

• Aufrufe an verschiedene API-Endpunkte tätigen

• Ergebnisse verarbeiten

Verfügbare Tools

Der Server stellt Hunderte von Tools über alle integrierten API-Kategorien hinweg bereit. Nachfolgend finden Sie einige Beispiele der am häufigsten verwendeten Tools:

DataForSEO SERP API-Tools

• serp_google_organic_live - Google organische Suchergebnisse abrufen

• serp_google_organic_task_post - Eine Google organische Suchaufgabe erstellen

• serp_google_maps_live - Google Maps Suchergebnisse abrufen

DataForSEO Keywords Data-Tools

• keywords_google_ads_search_volume - Suchvolumen für Keywords abrufen

• keywords_google_ads_keywords_for_site - Keyword-Vorschläge für eine Domain abrufen

• keywords_google_trends_explore - Keyword-Trends im Zeitverlauf erkunden

DataForSEO Labs-Tools

• labs_google_keyword_ideas - Keyword-Ideen basierend auf Seed-Keywords abrufen

• labs_google_related_keywords - Verwandte Keywords abrufen

• labs_google_domain_rank_overview - Domain-Ranking-Übersicht abrufen

DataForSEO Backlinks-Tools

• backlinks_summary - Zusammenfassung des Backlink-Profils einer Domain abrufen

• backlinks_backlinks - Liste der Backlinks für eine Domain abrufen

• backlinks_referring_domains - Verweisende Domains für ein Ziel abrufen

• backlinks_history - Historische Backlink-Daten für ein Ziel abrufen

• backlinks_timeseries_summary - Zeitreihendaten zu Backlinks abrufen

• backlinks_bulk_new_lost_backlinks - Neue und verlorene Backlinks für mehrere Ziele abrufen

• backlinks_bulk_new_lost_referring_domains - Neue und verlorene verweisende Domains für mehrere Ziele abrufen

• backlinks_bulk_pages_summary - Seitenzusammenfassungen für mehrere Ziele abrufen

DataForSEO AI Optimization-Tools

• ai_chatgpt_models - Liste der verfügbaren ChatGPT-Modelle abrufen

• ai_chatgpt_llm_responses_live - Live-Antworten von ChatGPT abrufen

• ai_chatgpt_scraper_locations - Verfügbare Standorte für den ChatGPT-Scraper abrufen

• ai_chatgpt_scraper_languages - Verfügbare Sprachen für den ChatGPT-Scraper abrufen

• ai_claude_models - Liste der verfügbaren Claude-Modelle abrufen

• ai_claude_llm_responses_live - Live-Antworten von Claude abrufen

• ai_gemini_models - Liste der verfügbaren Gemini-Modelle abrufen

• ai_gemini_llm_responses_live - Live-Antworten von Gemini abrufen

• ai_perplexity_models - Liste der verfügbaren Perplexity-Modelle abrufen

• ai_perplexity_llm_responses_live - Live-Antworten von Perplexity abrufen

• ai_keyword_data_search_volume_live - KI-Keyword-Suchvolumendaten abrufen

• ai_keyword_data_locations_and_languages - Verfügbare Standorte und Sprachen für KI-Keyword-Daten abrufen

Local Falcon-Tools (falls konfiguriert)

• localfalcon_calculate_grid_points - Rasterpunkte um eine Basiskoordinate berechnen

• localfalcon_search_gmb_locations - Nach Google My Business-Standorten suchen

• localfalcon_get_ranking_at_coordinate - Unternehmensranking an einer bestimmten Koordinate abrufen

• localfalcon_keyword_search_at_coordinate - Keywords an einem bestimmten Standort suchen

• localfalcon_run_grid_search - Eine vollständige Raster-Suche für lokale Rankings ausführen

Vollständige Tool-Liste

Für eine vollständige Liste aller verfügbaren Tools und deren Parameter, überprüfen Sie die Implementierung im Verzeichnis src/api.

Erweitern des Servers

Der Server ist so konzipiert, dass er erweiterbar ist. Um Unterstützung für zusätzliche SEO-APIs hinzuzufügen:

1. Erstellen Sie ein neues Verzeichnis in src/api/ für Ihre Integration

2. Implementieren Sie die Client-Handhabung und Tool-Registrierung

3. Fügen Sie Ihre Integration zu src/index.ts hinzu

4. Fügen Sie die Umgebungsvariablen-Handhabung für die Authentifizierung hinzu

Siehe die Local Falcon-Integration in src/api/localfalcon/ als Vorlage.

Lizenz

MIT

Maintenance

Resources

• NPM Package
• GitHub Repository
Need Help?
• Reddit Discussion
Related Servers

Tools

• app_data_app_store_app_infoD
• app_data_app_store_languagesD
• app_data_app_store_locationsD
• app_data_app_store_reviewsD
• app_data_app_store_searchD
• app_data_google_play_app_infoD
• app_data_google_play_languagesD
• app_data_google_play_locationsD