SEO Tools MCP Server

Полнофункциональный stdio MCP (Model Context Protocol) сервер для SEO API. Этот сервер позволяет LLM (большим языковым моделям) взаимодействовать с функциями DataForSEO API и другими SEO-инструментами.

Обзор

SEO Tools MCP Server обеспечивает бесшовную интеграцию между LLM, такими как Claude, и различными SEO API, позволяя выполнять SEO-анализ, исследование ключевых слов, анализ обратных ссылок и многие другие SEO-задачи непосредственно через взаимодействие на естественном языке.

Эта реализация предоставляет все основные конечные точки DataForSEO API в качестве инструментов MCP, которые LLM могут вызывать для получения конкретных SEO-данных. Сервер использует stdio в качестве транспортного уровня, что упрощает интеграцию с различными платформами LLM.

Related MCP server: DataForSEO MCP Server

Функции

• Полный охват конечных точек DataForSEO API

• Опциональная интеграция с Local Falcon и другими сторонними SEO-инструментами

• Транспорт Stdio для легкой интеграции

• Обработка аутентификации

• Подробные отчеты об ошибках

• Типобезопасные определения инструментов со схемами Zod

• Расширяемая архитектура для добавления новых API-интеграций

• Выборочная фильтрация модулей и инструментов через переменные окружения

Зарегистрируйтесь в Data for Seo

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

Реализованные категории API

DataForSEO API

1. SERP API - Данные результатов поисковых систем Google, Bing, Yahoo и других

2. Keywords Data API - Исследование ключевых слов, предложения и данные об объеме поиска

3. DataForSEO Labs API - Продвинутая SEO-аналитика, сравнение доменов и анализ ключевых слов

4. Backlinks API - Профили обратных ссылок, ссылающиеся домены и анализ якорного текста

5. OnPage API - Аудит веб-сайтов, анализ контента и технические SEO-проверки

6. Domain Analytics API - Определение технологического стека и анализ данных домена

7. Content Analysis API - Оценка качества контента и семантический анализ

8. Content Generation API - Инструменты генерации контента на базе ИИ

9. Merchant API - Данные электронной коммерции из Amazon и Google Shopping

10. App Data API - Данные мобильных приложений из Google Play и App Store

11. Business Data API - Данные бизнес-листингов из Google My Business, Trustpilot и других

12. AI Optimization API - Ответы LLM, ИИ-скрейпер и данные по ключевым словам от ChatGPT, Claude, Gemini и Perplexity

Local Falcon API (Опционально)

1. Calculate Grid Points - Генерация координат сетки для анализа локального ранжирования

2. Search GMB Locations - Поиск локаций Google My Business по запросу

3. Get Ranking at Coordinate - Проверка ранжирования бизнеса по конкретным координатам

4. Keyword Search at Coordinate - Тестирование поисковых запросов в конкретных локациях

5. Run Grid Search - Выполнение полного анализа локального ранжирования на основе сетки

Установка

# 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

Использование

Для использования этого MCP-сервера вам потребуются API-ключи для сервисов, которые вы хотите использовать.

Запуск сервера с DataForSEO

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

# Run the server
npm start

Запуск сервера с DataForSEO и 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

Фильтрация модулей и инструментов

По умолчанию сервер предоставляет сотни инструментов. При использовании с LLM полный список инструментов потребляет значительное пространство контекстного окна. Вы можете уменьшить количество предоставляемых инструментов, используя переменные окружения, чтобы включить только те модули или инструменты, которые вам нужны.

Зачем фильтровать?

• Уменьшение использования контекста

• Более быстрое обнаружение инструментов для LLM

• Более сфокусированные ответы

Фильтрация по модулям

Используйте ENABLED_MODULES для включения только определенных категорий API (через запятую, без учета регистра):

export ENABLED_MODULES="SERP,BUSINESS_DATA,LABS"

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

• SERP - Результаты поисковых систем

• KEYWORDS_DATA - Исследование ключевых слов

• LABS или DATAFORSEO_LABS - Продвинутая SEO-аналитика

• BACKLINKS - Анализ обратных ссылок

• ONPAGE - Аудит веб-сайтов

• DOMAIN_ANALYTICS - Данные доменов

• CONTENT_ANALYSIS - Оценка контента

• CONTENT_GENERATION - Генерация контента с помощью ИИ

• MERCHANT - Данные электронной коммерции

• APP_DATA - Данные мобильных приложений

• BUSINESS_DATA - Бизнес-листинги

• AI_OPTIMIZATION - Ответы LLM и ИИ-данные

Фильтрация по отдельным инструментам

Используйте ENABLED_TOOLS для детального управления конкретными инструментами (через запятую, без учета регистра):

export ENABLED_TOOLS="serp_google_maps_live,business_data_google_my_business_info"

Если ни одна из переменных не установлена, по умолчанию включены все модули и инструменты.

Подписки с областью действия модуля и ошибки 404

Доступ к DataForSEO часто предоставляется для каждого модуля отдельно, а не как единая подписка "все или ничего". Это означает, что некоторые конечные точки могут работать, в то время как другие возвращают 404.

Важное правило интерпретации:

• 404 на известных рабочих конечных точках, таких как SERP, App Data, DataForSEO Labs App Store или Content Generation, может означать, что модуль не включен для текущей учетной записи

• это не обязательно ошибка в MCP-сервере или неправильный путь к конечной точке

• бесплатные конечные точки обнаружения, такие как локации или языки, могут работать, даже если платные рабочие конечные точки в той же области недоступны

Теперь сервер нормализует известные ответы 404 с областью действия модуля в более понятное сообщение:

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

Когда это происходит, включите модуль в панели управления DataForSEO или переключитесь на инструменты из модулей, которые уже включены для текущей учетной записи.

Использование с Claude или другими LLM

Этот сервер реализует Model Context Protocol, который позволяет LLM взаимодействовать с внешними системами стандартизированным способом. Чтобы использовать его с Claude, вам нужно будет интегрировать его с вашей платформой LLM в соответствии с их конкретной реализацией MCP.

Примеры использования смотрите в директории examples.

Разработка

# Run in development mode with hot reloading
npm run dev

# Run tests
npm test

Примеры

Ознакомьтесь с директорией examples для получения примеров кода, показывающих, как использовать SEO Tools MCP Server.

Базовый пример демонстрирует:

• Запуск сервера

• Подключение к нему из клиента

• Выполнение вызовов к различным конечным точкам API

• Обработку результатов

Доступные инструменты

Сервер предоставляет сотни инструментов во всех интегрированных категориях API. Ниже приведены примеры наиболее часто используемых инструментов:

Инструменты DataForSEO SERP API

• serp_google_organic_live - Получение результатов органического поиска Google

• serp_google_organic_task_post - Создание задачи органического поиска Google

• serp_google_maps_live - Получение результатов поиска Google Maps

Инструменты DataForSEO Keywords Data

• keywords_google_ads_search_volume - Получение объема поиска для ключевых слов

• keywords_google_ads_keywords_for_site - Получение предложений ключевых слов для домена

• keywords_google_trends_explore - Исследование трендов ключевых слов во времени

Инструменты DataForSEO Labs

• labs_google_keyword_ideas - Получение идей ключевых слов на основе исходных ключевых слов

• labs_google_related_keywords - Получение связанных ключевых слов

• labs_google_domain_rank_overview - Получение обзора ранжирования домена

Инструменты DataForSEO Backlinks

• backlinks_summary - Получение сводки профиля обратных ссылок домена

• backlinks_backlinks - Получение списка обратных ссылок для домена

• backlinks_referring_domains - Получение ссылающихся доменов для цели

• backlinks_history - Получение исторических данных об обратных ссылках для цели

• backlinks_timeseries_summary - Получение данных временных рядов по обратным ссылкам

• backlinks_bulk_new_lost_backlinks - Получение новых и потерянных обратных ссылок для нескольких целей

• backlinks_bulk_new_lost_referring_domains - Получение новых и потерянных ссылающихся доменов для нескольких целей

• backlinks_bulk_pages_summary - Получение сводок страниц для нескольких целей

Инструменты DataForSEO AI Optimization

• ai_chatgpt_models - Получение списка доступных моделей ChatGPT

• ai_chatgpt_llm_responses_live - Получение живых ответов от ChatGPT

• ai_chatgpt_scraper_locations - Получение доступных локаций для скрейпера ChatGPT

• ai_chatgpt_scraper_languages - Получение доступных языков для скрейпера ChatGPT

• ai_claude_models - Получение списка доступных моделей Claude

• ai_claude_llm_responses_live - Получение живых ответов от Claude

• ai_gemini_models - Получение списка доступных моделей Gemini

• ai_gemini_llm_responses_live - Получение живых ответов от Gemini

• ai_perplexity_models - Получение списка доступных моделей Perplexity

• ai_perplexity_llm_responses_live - Получение живых ответов от Perplexity

• ai_keyword_data_search_volume_live - Получение данных об объеме поиска ключевых слов ИИ

• ai_keyword_data_locations_and_languages - Получение доступных локаций и языков для данных ключевых слов ИИ

Инструменты Local Falcon (если настроено)

• localfalcon_calculate_grid_points - Расчет точек сетки вокруг базовой координаты

• localfalcon_search_gmb_locations - Поиск локаций Google My Business

• localfalcon_get_ranking_at_coordinate - Получение ранжирования бизнеса по конкретной координате

• localfalcon_keyword_search_at_coordinate - Поиск ключевых слов в конкретной локации

• localfalcon_run_grid_search - Запуск полного поиска по сетке для локального ранжирования

Полный список инструментов

Для получения полного списка всех доступных инструментов и их параметров ознакомьтесь с реализацией в директории src/api.

Расширение сервера

Сервер спроектирован как расширяемый. Чтобы добавить поддержку дополнительных SEO API:

1. Создайте новую директорию в src/api/ для вашей интеграции

2. Реализуйте обработку клиента и регистрацию инструментов

3. Добавьте вашу интеграцию в src/index.ts

4. Добавьте обработку переменных окружения для аутентификации

Смотрите интеграцию Local Falcon в src/api/localfalcon/ в качестве шаблона.

Лицензия

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