DataForSEO MCP-Server

Model Context Protocol (MCP)-Serverimplementierung für DataForSEO, die es Claude ermöglicht, mit ausgewählten DataForSEO-APIs zu interagieren und SEO-Daten über eine standardisierte Schnittstelle abzurufen.

Merkmale

SERP-API: Echtzeitdaten der Suchmaschinen-Ergebnisseite (SERP) für Google, Bing und Yahoo;
KEYWORDS_DATA API: Keyword-Recherche und Clickstream-Daten, einschließlich Suchvolumen, Kosten pro Klick und andere Kennzahlen;
ONPAGE-API: ermöglicht das Crawlen von Websites und Webseiten gemäß anpassbaren Parametern, um On-Page-SEO-Leistungsmetriken zu erhalten;
DATAFORSEO_LABS API: Daten zu Schlüsselwörtern, SERPs und Domänen basierend auf den internen Datenbanken und proprietären Algorithmen von DataForSEO.

Related MCP server: Google Search MCP Server

Voraussetzungen

Node.js (v14 oder höher)
DataForSEO-API-Anmeldeinformationen (API-Login und Passwort)

Installation

Klonen Sie das Repository:

git clone https://github.com/dataforseo/mcp-server-typescript cd mcp-server-typescript

Installieren Sie Abhängigkeiten:

npm install

Umgebungsvariablen einrichten:

# Required export DATAFORSEO_USERNAME=your_username export DATAFORSEO_PASSWORD=your_password # Optional: specify which modules to enable (comma-separated) # If not set, all modules will be enabled export ENABLED_MODULES="SERP,KEYWORDS_DATA,ONPAGE,DATAFORSEO_LABS,BACKLINKS,BUSINESS_DATA,DOMAIN_ANALYTICS" # Optional: enable full API responses # If not set or set to false, the server will filter and transform API responses to a more concise format # If set to true, the server will return the full, unmodified API responses export DATAFORSEO_FULL_RESPONSE="false"

Installation als NPM-Paket

Sie können das Paket global installieren:

npm install -g dataforseo-mcp-server

Oder führen Sie es direkt ohne Installation aus:

npx dataforseo-mcp-server

Denken Sie daran, Umgebungsvariablen festzulegen, bevor Sie den Befehl ausführen:

# Required environment variables export DATAFORSEO_USERNAME=your_username export DATAFORSEO_PASSWORD=your_password # Run with npx npx dataforseo-mcp-server

Bauen und Ausführen

Erstellen Sie das Projekt:

npm run build

Führen Sie den Server aus:

npm start

Verfügbare Module

Die folgenden Module können aktiviert/deaktiviert werden:

SERP : SERP-Daten in Echtzeit für Google, Bing und Yahoo;
KEYWORDS_DATA : Keyword-Recherche und Clickstream-Daten;
ONPAGE : Durchsuchen Sie Websites und Webseiten, um On-Page-SEO-Leistungsmetriken zu erhalten.
DATAFORSEO_LABS : Daten zu Schlüsselwörtern, SERPs und Domänen basierend auf den Datenbanken und Algorithmen von DataForSEO;
BACKLINKS : Daten zu eingehenden Links, verweisenden Domänen und verweisenden Seiten für jede Domäne, Subdomäne oder Webseite;
BUSINESS_DATA : basierend auf Unternehmensbewertungen und Unternehmensinformationen, die öffentlich auf den folgenden Plattformen geteilt werden: Google, Trustpilot, Tripadvisor;
DOMAIN_ANALYTICS : hilft bei der Identifizierung aller möglichen Technologien, die zum Erstellen von Websites verwendet werden, und bietet Whois-Daten;

Hinzufügen neuer Tools/Module

Modulstruktur

Jedes Modul entspricht einer bestimmten DataForSEO-API:

SERP Modul → SERP-API
KEYWORDS_DATA -Modul → Keywords Data API
ONPAGE -Modul → OnPage-API
DATAFORSEO_LABS -Modul → DataForSEO Labs API
BACKLINKS : Modul → Backlinks-API
BUSINESS_DATA : Modul → Geschäftsdaten-API
DOMAIN_ANALYTICS : Modul → Domain Analytics API

Implementierungsoptionen

Sie können entweder:

Hinzufügen eines neuen Tools zu einem vorhandenen Modul
Erstellen Sie ein völlig neues Modul

Hinzufügen eines neuen Tools

So fügen Sie einem neuen oder bereits vorhandenen Modul ein neues Tool hinzu:

// src/modules/your-module/tools/your-tool.tool.ts import { BaseTool } from '../../base.tool'; import { DataForSEOClient } from '../../../client/dataforseo.client'; import { z } from 'zod'; export class YourTool extends BaseTool { constructor(private client: DataForSEOClient) { super(client); // DataForSEO API returns extensive data with many fields, which can be overwhelming // for AI agents to process. We select only the most relevant fields to ensure // efficient and focused responses. this.fields = [ 'title', // Example: Include the title field 'description', // Example: Include the description field 'url', // Example: Include the URL field // Add more fields as needed ]; } getName() { return 'your-tool-name'; } getDescription() { return 'Description of what your tool does'; } getParams(): z.ZodRawShape { return { // Required parameters keyword: z.string().describe('The keyword to search for'), location: z.string().describe('Location in format "City,Region,Country" or just "Country"'), // Optional parameters fields: z.array(z.string()).optional().describe('Specific fields to return in the response. If not specified, all fields will be returned'), language: z.string().optional().describe('Language code (e.g., "en")'), }; } async handle(params: any) { try { // Make the API call const response = await this.client.makeRequest({ endpoint: '/v3/dataforseo_endpoint_path', method: 'POST', body: [{ // Your request parameters keyword: params.keyword, location: params.location, language: params.language, }], }); // Validate the response for errors this.validateResponse(response); //if the main data array is specified in tasks[0].result[:] field const result = this.handleDirectResult(response); //if main data array specified in tasks[0].result[0].items field const result = this.handleItemsResult(response); // Format and return the response return this.formatResponse(result); } catch (error) { // Handle and format any errors return this.formatErrorResponse(error); } } }

Erstellen eines neuen Moduls

Erstellen Sie unter src/modules/ ein neues Verzeichnis für Ihr Modul:

mkdir -p src/modules/your-module-name

Moduldateien erstellen:

// src/modules/your-module-name/your-module-name.module.ts import { BaseModule } from '../base.module'; import { DataForSEOClient } from '../../client/dataforseo.client'; import { YourTool } from './tools/your-tool.tool'; export class YourModuleNameModule extends BaseModule { constructor(private client: DataForSEOClient) { super(); } getTools() { return { 'your-tool-name': new YourTool(this.client), }; } }

Registrieren Sie Ihr Modul in src/config/modules.config.ts :

export const AVAILABLE_MODULES = [ 'SERP', 'KEYWORDS_DATA', 'ONPAGE', 'DATAFORSEO_LABS', 'YOUR_MODULE_NAME' // Add your module name here ] as const;

Initialisieren Sie Ihr Modul in src/index.ts :

if (isModuleEnabled('YOUR_MODULE_NAME', enabledModules)) { modules.push(new YourModuleNameModule(dataForSEOClient)); }

Welche Endpunkte/APIs sollen wir als Nächstes unterstützen?

Wir sind stets bestrebt, die Funktionen dieses MCP-Servers zu erweitern. Wenn Sie bestimmte DataForSEO-Endpunkte oder APIs unterstützen möchten, gehen Sie bitte wie folgt vor:

Überprüfen Sie die DataForSEO API-Dokumentation, um zu sehen, was verfügbar ist
Öffnen Sie ein Problem in unserem GitHub-Repository mit:
- Die API/der Endpunkt, der Ihrer Meinung nach unterstützt werden soll;
- Eine kurze Beschreibung Ihres Anwendungsfalls;
- Beschreiben Sie alle spezifischen Funktionen, die Sie gerne implementiert sehen würden.

Ihr Feedback hilft uns dabei, Prioritäten für die als Nächstes zu unterstützenden APIs festzulegen!

DataForSEO MCP Server

DataForSEO MCP-Server

Merkmale

Voraussetzungen

Installation

Installation als NPM-Paket

Bauen und Ausführen

Verfügbare Module

Hinzufügen neuer Tools/Module

Modulstruktur

Implementierungsoptionen

Hinzufügen eines neuen Tools

Erstellen eines neuen Moduls

Welche Endpunkte/APIs sollen wir als Nächstes unterstützen?

Ressourcen

Resources

Tools

New MCP Servers

Latest Blog Posts

MCP directory API