Сервер MCP DataForSEO

Реализация сервера Model Context Protocol (MCP) для DataForSEO, позволяющая Клоду взаимодействовать с выбранными API DataForSEO и получать данные SEO через стандартизированный интерфейс.

Функции

SERP API: данные страницы результатов поисковой системы (SERP) в режиме реального времени для Google, Bing и Yahoo;
API KEYWORDS_DATA: исследование ключевых слов и данные о кликах, включая объем поиска, цену за клик и другие показатели;
API ONPAGE: позволяет сканировать веб-сайты и веб-страницы в соответствии с настраиваемыми параметрами для получения показателей эффективности SEO на странице;
API DATAFORSEO_LABS: данные по ключевым словам, SERP и доменам на основе внутренних баз данных DataForSEO и собственных алгоритмов.

Предпосылки

Node.js (v14 или выше)
Учетные данные API DataForSEO (логин и пароль API)

Установка

Клонируйте репозиторий:

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

Установить зависимости:

npm install

Настройте переменные среды:

# 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"

Строительство и запуск

Создайте проект:

npm run build

Запускаем сервер:

node build/index.js

Доступные модули

Для включения/отключения доступны следующие модули:

SERP : данные SERP в реальном времени для Google, Bing и Yahoo;
KEYWORDS_DATA : исследование ключевых слов и данные о посещениях;
ONPAGE : сканирование веб-сайтов и веб-страниц для получения показателей эффективности SEO на странице;
DATAFORSEO_LABS : данные по ключевым словам, SERP и доменам на основе баз данных и алгоритмов DataForSEO.

Добавление новых инструментов/модулей

Структура модуля

Каждый модуль соответствует определенному API DataForSEO:

Модуль SERP → API SERP
Модуль KEYWORDS_DATA → API данных ключевых слов
Модуль ONPAGE → API OnPage
Модуль DATAFORSEO_LABS → API DataForSEO Labs

Варианты реализации

Вы можете:

Добавить новый инструмент к существующему модулю
Создать совершенно новый модуль

Добавление нового инструмента

Вот как добавить новый инструмент в любой новый или уже существующий модуль:

// 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);
    }
  }
}

Создание нового модуля

Создайте новый каталог в src/modules/ для вашего модуля:

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

Создайте файлы модуля:

// 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),
    };
  }
}

Зарегистрируйте свой модуль в 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;

Инициализируйте свой модуль в src/index.ts :

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

Какие конечные точки/API вы хотите, чтобы мы поддерживали в дальнейшем?

Мы всегда стремимся расширить возможности этого сервера MCP. Если у вас есть определенные конечные точки DataForSEO или API, которые вы хотели бы видеть поддерживаемыми, пожалуйста:

Проверьте документацию API DataForSEO, чтобы узнать, что доступно.
Откройте задачу в нашем репозитории GitHub с помощью:
- API/конечная точка, которую вы хотели бы поддерживать;
- Краткое описание вашего варианта использования;
- Опишите любые конкретные функции, которые вы хотели бы реализовать.

Ваши отзывы помогают нам определить приоритеты поддержки API в дальнейшем!

DataForSEO MCP Server

Integrations