AI导哈

SEO工具MCP服务器

一个全面的stdio MCP服务器，用于连接LLM与DataForSEO及其他SEO工具API，支持SEO分析、关键词研究、反向链接分析等功能。

  • by Skobyn
  • TypeScript
  • 本地部署
  • 82 星标
  • 更新于
在 GitHub 查看 Skobyn/dataforseo-mcp-server

使用说明

SEO工具MCP服务器

一个用于SEO API的全面的stdio MCP（模型上下文协议）服务器。该服务器允许LLM（大型语言模型）与DataForSEO API函数和其他SEO工具进行交互。

备注

版本 1.1.0 包括通过将包装器路径与官方DataForSEO文档进行比较而发现的约40个端点错误的更正。看 更改日志.md 查看完整列表。

概述

SEO Tools MCP Server实现了Claude等LLM与各种SEO API之间的无缝集成，从而可以直接通过自然语言交互执行SEO分析、关键字研究、反向链接分析和许多其他与SEO相关的任务。

此实现将所有主要的DataForSEO API端点公开为MCP工具，LLM可以调用这些工具来检索特定的SEO数据。服务器使用stdio作为其传输层，使其易于与各种LLM平台集成。

特性

  • 全面覆盖DataForSEO API端点（请参阅CHANGELOG.md了解此版本中修复的错误）
  • 可选择与Local Falcon和其他第三方SEO工具集成
  • Stdio传输，便于集成
  • 身份验证处理
  • 详细的错误报告
  • 使用Zod模式的类型安全工具定义
  • 用于添加新API集成的可扩展体系结构
  • 通过环境变量进行选择性模块和工具过滤

注册徐的数据

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

实施API类别

搜索引擎优化API数据

  1. SERP API -来自谷歌、必应、雅虎等的搜索引擎结果数据
  2. 关键词数据API -关键词研究、建议和搜索量数据
  3. DataForSEO实验室API -高级SEO分析、域名比较和关键字分析
  4. 反向链接API -反向链接配置文件、引用域和锚文本分析
  5. 第页API -网站审计、内容分析和技术SEO检查
  6. 域分析API -技术栈检测和领域数据分析
  7. 内容分析API -内容质量评估和语义分析
  8. 内容生成API -基于人工智能的内容生成工具
  9. 商户API -来自亚马逊和谷歌购物的电子商务数据
  10. 应用程序数据API -来自Google Play和app Store的移动应用数据
  11. 业务数据API -来自Google My Business、Trustpilot等的企业列表数据
  12. 人工智能优化API -来自ChatGPT、Claude、Gemini和Perplexity的LLM响应、AI抓取器和AI关键字数据

本地Falcon API（可选）

  1. 计算网格点 -为本地排名分析生成网格坐标
  2. 搜索GMB地点 -通过查询查找Google My Business位置
  3. 在坐标系中获得排名 -查看特定坐标处的业务排名
  4. 在坐标处搜索关键字 -在特定位置测试搜索词
  5. 运行网格搜索 -执行基于全网格的本地排名分析

安装

# 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和本地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 -AI内容生成
  • MERCHANT -电子商务数据
  • APP_DATA -移动应用数据
  • BUSINESS_DATA -企业列表
  • AI_OPTIMIZATION -LLM响应和AI数据

按单个工具筛选

使用 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一起使用

此服务器实现了模型上下文协议，该协议允许LLM以标准化的方式与外部系统交互。要将其与Claude一起使用，您需要根据其特定的MCP实现将其与您的LLM平台集成。

有关用法示例，请参阅示例目录。

发展

# Run in development mode with hot reloading
npm run dev

# Run tests
npm test

例子

看看 examples 展示如何使用SEO工具MCP服务器的示例代码目录。

基本示例演示了：

  • 启动服务器
  • 从客户端连接到它
  • 对不同的API端点进行调用
  • 处理结果

可用工具

服务器公开了所有集成API类别中的数百个工具。以下是一些最常用的工具示例：

DataForSEO SERP API工具

  • serp_google_organic_live -获取谷歌自然搜索结果
  • serp_google_organic_task_post -创建Google自然搜索任务
  • serp_google_maps_live -获取谷歌地图搜索结果

DataForSEO关键词数据工具

  • keywords_google_ads_search_volume -获取关键字的搜索量
  • keywords_google_ads_keywords_for_site -获取域的关键字建议
  • keywords_google_trends_explore -探索随时间推移的关键字趋势

DataForSEO实验室工具

  • labs_google_keyword_ideas -基于种子关键词获取关键词创意
  • labs_google_related_keywords -获取相关关键词
  • labs_google_domain_rank_overview -获取域名排名概览

DataForSEO反向链接工具

  • 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_chatgpt_models -获取可用ChatGPT模型列表
  • ai_chatgpt_llm_responses_live -从ChatGPT获取实时响应
  • ai_chatgpt_scraper_locations -获取ChatGPT抓取器的可用位置
  • ai_chatgpt_scraper_languages -获取ChatGPT scraper的可用语言
  • ai_claude_models -获取可用Claude型号列表
  • ai_claude_llm_responses_live -获取Claude的实时回复
  • ai_gemini_models -获取可用Gemini型号列表
  • ai_gemini_llm_responses_live -获取Gemini的实时回复
  • ai_perplexity_models -获取可用困惑模型列表
  • ai_perplexity_llm_responses_live -从困惑中获取实时回复
  • ai_keyword_data_search_volume_live -获取AI关键词搜索量数据
  • ai_keyword_data_locations_and_languages -获取AI关键字数据的可用位置和语言

本地猎鹰工具（如已配置）

  • 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. 添加用于身份验证的环境变量处理

请参阅中的本地猎鹰集成 src/api/localfalcon/ 对于模板。

安全

  • 证书(DATAFORSEO_LOGIN, DATAFORSEO_PASSWORD, LOCALFALCON_API_KEY)仅从环境变量中读取。永远不要承诺。
  • 复制 .env.example 到 .env 并填写您自己的凭证。
  • 这 .gitignore 排除 .env, .env.*.local以及其他秘密存储路径。
  • 在贡献之前，运行 npm audit 并修复任何高/关键漏洞。

许可证

麻省理工学院

相关 MCP