SEO Tools MCP 服务器

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

概览

SEO Tools MCP 服务器使像Claude这样的LLM能够与各种SEO API无缝集成，从而可以直接通过自然语言交互执行SEO分析、关键词研究、反向链接分析等许多其他与SEO相关的任务。

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

特性

• 全面覆盖DataForSEO API端点
• 可选地与Local Falcon和其他第三方SEO工具集成
• 使用stdio传输以便于集成
• 处理身份验证
• 详细的错误报告
• 使用Zod模式定义类型安全的工具
• 可扩展架构以添加新的API集成

已实现的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 - AI驱动的内容生成工具
9. Merchant API - 来自亚马逊和Google购物的电子商务数据
10. App Data API - 来自Google Play和App Store的移动应用数据
11. Business Data API - 来自Google My Business、Trustpilot等的商家列表数据

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

与Claude或其他LLM一起使用

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

请参阅示例目录中的用法示例。

开发

# Run in development mode with hot reloading
npm run dev

示例

请查看 examples 目录，其中包含展示如何使用 SEO Tools MCP 服务器的示例代码。

基本示例演示了：

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

可用工具

该服务器在所有集成的 API 类别中提供了数百种工具。以下是一些最常用的工具示例：

DataForSEO SERP API 工具

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

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 - 获取目标的引用域名

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/ 中为您要集成的 API 创建一个新目录
2. 实现客户端处理和工具注册
3. 将您的集成添加到 src/index.ts
4. 添加环境变量处理以进行身份验证

请参阅 src/api/localfalcon/ 中的 Local Falcon 集成作为模板。

许可证

MIT