DataForSEO

Интеграция DataForSEO API с Claude! Получайте данные SERP в реальном времени, исследования ключевых слов и SEO-метрики на странице. Автоматизируйте SEO-задачи и получайте конкурентные инсайты.

Разработка API Веб-скрапинг и сбор данных Маркетинговая автоматизация ★ 29 GitHub (29 ★)

DataForSEO позволяет Claude получать доступ и использовать SEO-данные из различных API DataForSEO через стандартизированный интерфейс Model Context Protocol. Эта реализация сервера предоставляет доступ к данным поисковой выдачи (SERP) в реальном времени, данным исследования ключевых слов и кликстрима, метрикам производительности on-page SEO, а также данным из внутренних баз данных и алгоритмов DataForSEO. Разработчики могут расширять его функциональность, добавляя новые инструменты и модули для поддержки дополнительных конечных точек API DataForSEO, расширяя возможности сервера для решения конкретных задач SEO-анализа и отчетности.

Ключевые особенности

0129 звёзд на GitHub

02Позволяет сканировать веб-сайты для получения метрик производительности on-page SEO.

03Использует базы данных DataForSEO для получения данных по ключевым словам, SERP и доменам.

04Поддерживает расширение с помощью новых инструментов и модулей для дополнительных конечных точек API DataForSEO.

05Предоставляет данные SERP в реальном времени для Google, Bing и Yahoo.

06Предлагает данные исследования ключевых слов и кликстрима, включая объем поиска и цену за клик.

Варианты использования

01Интеграция SEO-данных в приложения на базе ИИ.

02Расширение возможностей Claude с помощью SEO-специфичных инструментов.

03Автоматизация задач SEO-анализа и отчетности.

DataForSEO MCP Server

Model Context Protocol (MCP) server implementation for DataForSEO, enabling Claude to interact with selected DataForSEO APIs and obtain SEO data through a standardized interface.

Features

SERP API: real-time Search Engine Results Page (SERP) data for Google, Bing, and Yahoo;
KEYWORDS_DATA API: keyword research and clickstream data, including search volume, cost-per-click, and other metrics;
ONPAGE API: allows crawling websites and webpages according to customizable parameters to obtain on-page SEO performance metrics;
DATAFORSEO_LABS API: data on keywords, SERPs, and domains based on DataForSEO's in-house databases and proprietary algorithms.

Prerequisites

Node.js (v14 or higher)
DataForSEO API credentials (API login and password)

Installation

Clone the repository:

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

Install dependencies:

npm install

Set up environment variables:

# 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 as an NPM Package

You can install the package globally:

npm install -g dataforseo-mcp-server

Or run it directly without installation:

npx dataforseo-mcp-server

Remember to set environment variables before running the command:

# Required environment variables
export DATAFORSEO_USERNAME=your_username
export DATAFORSEO_PASSWORD=your_password

# Run with npx
npx dataforseo-mcp-server

Building and Running

Build the project:

npm run build

Run the server:

npm start

Available Modules

The following modules are available to be enabled/disabled:

SERP: real-time SERP data for Google, Bing, and Yahoo;
KEYWORDS_DATA: keyword research and clickstream data;
ONPAGE: crawl websites and webpages to obtain on-page SEO performance metrics;
DATAFORSEO_LABS: data on keywords, SERPs, and domains based on DataForSEO's databases and algorithms;
BACKLINKS: data on inbound links, referring domains and referring pages for any domain, subdomain, or webpage;
BUSINESS_DATA: based on business reviews and business information publicly shared on the following platforms: Google, Trustpilot, Tripadvisor;
DOMAIN_ANALYTICS: helps identify all possible technologies used for building websites and offers Whois data;

Adding New Tools/Modules

Module Structure

Each module corresponds to a specific DataForSEO API:

SERP module → SERP API
KEYWORDS_DATA module → Keywords Data API
ONPAGE module → OnPage API
DATAFORSEO_LABS module → DataForSEO Labs API
BACKLINKS: module → Backlinks API
BUSINESS_DATA: module → Business Data API
DOMAIN_ANALYTICS: module → Domain Analytics API

Implementation Options

You can either:

Add a new tool to an existing module
Create a completely new module

Adding a New Tool

Here's how to add a new tool to any new or pre-existing module:

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

Creating a New Module

Create a new directory under src/modules/ for your module:

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

Create module files:

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

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

Initialize your module in src/index.ts:

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

What endpoints/APIs do you want us to support next?

We're always looking to expand the capabilities of this MCP server. If you have specific DataForSEO endpoints or APIs you'd like to see supported, please:

Check the DataForSEO API Documentation to see what's available
Open an issue in our GitHub repository with:
- The API/endpoint you'd like to see supported;
- A brief description of your use case;
- Describe any specific features you'd like to see implemented.

Your feedback helps us prioritize which APIs to support next!

Resources

MCP-сервер DataForSEO

Реализация протокола Model Context Protocol (MCP) для API DataForSEO. Сервер позволяет ИИ-агентам (например, Claude) получать SEO-данные через унифицированный интерфейс: результаты поиска, данные по ключевым словам, информацию об обратных ссылках, аналитику доменов и многое другое.

Возможности

SERP API — данные со страниц результатов поиска Google, Bing и Yahoo в реальном времени.
KEYWORDS_DATA API — исследование ключевых слов и кликстрим-данные: объём поиска, цена за клик (CPC) и другие метрики.
ONPAGE API — гибкий краулинг сайтов и страниц для получения метрик SEO-производительности.
DATAFORSEO_LABS API — данные по ключевым словам, SERP и доменам на основе собственных баз DataForSEO.
BACKLINKS API — данные об обратных ссылках, ссылающихся доменах и страницах.
BUSINESS_DATA API — бизнес-отзывы и информация с Google, Trustpilot и Tripadvisor.
DOMAIN_ANALYTICS API — определение технологического стека сайтов и данные Whois.

Требования

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

Установка

Клонирование репозитория

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

Установка как глобального NPM-пакета

npm install -g dataforseo-mcp-server

Либо запускайте без установки через npx:

npx dataforseo-mcp-server

Конфигурация

Перед запуском обязательно задайте переменные окружения:

DATAFORSEO_USERNAME — ваш логин (обязательно)
DATAFORSEO_PASSWORD — ваш пароль (обязательно)
ENABLED_MODULES — список модулей через запятую. Если не задано, включены все. Пример:

export ENABLED_MODULES="SERP,KEYWORDS_DATA,ONPAGE,DATAFORSEO_LABS,BACKLINKS,BUSINESS_DATA,DOMAIN_ANALYTICS"

DATAFORSEO_FULL_RESPONSE — если true, сервер возвращает полный нефильтрованный ответ API. По умолчанию ответы сокращаются для удобства ИИ-агентов.

Запуск

npm run build
npm start

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

Модуль	Описание
SERP	Результаты поиска Google, Bing, Yahoo
KEYWORDS_DATA	Исследование ключевых слов и кликстрим
ONPAGE	Краулинг и анализ on-page SEO
DATAFORSEO_LABS	Расширенные данные об关键词, SERP и доменах
BACKLINKS	Обратные ссылки, рефереры
BUSINESS_DATA	Бизнес-отзывы и информация (Google, Trustpilot, Tripadvisor)
DOMAIN_ANALYTICS	Технологический стек и Whois

Расширение функциональности

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

1. Создание инструмента

Создайте файл 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);
    this.fields = ['title', 'description', 'url']; // поля, которые вернутся
  }
  getName() { return 'your-tool-name'; }
  getDescription() { return 'Описание инструмента'; }
  getParams(): z.ZodRawShape {
    return {
      keyword: z.string().describe('Ключевое слово'),
      location: z.string().describe('Локация'),
    };
  }
  async handle(params: any) {
    const response = await this.client.makeRequest({
      endpoint: '/v3/dataforseo_endpoint_path',
      method: 'POST',
      body: [{ keyword: params.keyword, location: params.location }],
    });
    this.validateResponse(response);
    const result = this.handleDirectResult(response); // или handleItemsResult
    return this.formatResponse(result);
  }
}

2. Регистрация модуля

Создайте src/modules/your-module-name/your-module-name.module.ts и зарегистрируйте его в src/config/modules.config.ts и src/index.ts. Подробные примеры смотрите в репозитории.

Обратная связь по новым API

Если вам не хватает какого-либо эндпоинта DataForSEO, создайте issue на GitHub с описанием use case. Это поможет приоритизировать разработку.

Полезные ссылки

Источник: https://mcpmarket.com/server/dataforseo-2

Ключевые особенности

Варианты использования

DataForSEO MCP Server

Features

Prerequisites

Installation

Installation as an NPM Package

Building and Running

Available Modules

Adding New Tools/Modules

Module Structure

Implementation Options

Adding a New Tool

Creating a New Module

What endpoints/APIs do you want us to support next?

Resources

MCP-сервер DataForSEO

Возможности

Требования

Установка

Клонирование репозитория

Установка как глобального NPM-пакета

Конфигурация

Запуск

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

Расширение функциональности

1. Создание инструмента

2. Регистрация модуля

Обратная связь по новым API

Полезные ссылки

Как установить и настроить сервер DataForSEO MCP?

Могу ли я расширить сервер новыми конечными точками API DataForSEO?

Какие SEO-данные я могу получить с помощью этого инструмента?

Что такое сервер DataForSEO MCP?

Какие API DataForSEO сейчас поддерживаются?

Serp Organic Live Advanced

Parameters

Serp Locations

Parameters

Serp Youtube Locations

Parameters

Serp Youtube Organic Live Advanced

Parameters

Serp Youtube Video Info Live Advanced

Parameters

Serp Youtube Video Comments Live Advanced

Parameters

Serp Youtube Video Subtitles Live Advanced

Parameters

Keywords Data Google Ads Search Volume

Parameters

Keywords Data Dataforseo Trends Demography

Parameters

Keywords Data Dataforseo Trends Subregion Interests

Parameters

Keywords Data Dataforseo Trends Explore

Parameters

Keywords Data Google Trends Categories

Keywords Data Google Trends Explore

Parameters

On Page Content Parsing

Parameters

On Page Instant Pages

Parameters

On Page Lighthouse

Parameters

Dataforseo Labs Google Ranked Keywords

Parameters

Dataforseo Labs Google Competitors Domain

Parameters