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.
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:
- 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:
Führen Sie den Server aus:
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;
Modulstruktur
Jedes Modul entspricht einer bestimmten DataForSEO-API:
Implementierungsoptionen
Sie können entweder:
- Hinzufügen eines neuen Tools zu einem vorhandenen Modul
- Erstellen Sie ein völlig neues Modul
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!
Ressourcen