SEO工具 MCP 服务器

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

概述

SEO工具 MCP 服务器实现了LLM（如Claude）与各种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. 关键词数据API - 关键词研究、建议和搜索量数据
3. DataForSEO Labs API - 高级SEO分析、域名比较和关键词分析
4. 反向链接API - 反向链接配置文件、引用域名和锚文本分析
5. OnPage API - 网站审核、内容分析和技术SEO检查
6. 域名分析API - 技术栈检测和域名数据分析
7. 内容分析API - 内容质量评估和语义分析
8. 内容生成API - AI驱动的内容生成工具
9. 商家API - 来自Amazon和Google Shopping的电子商务数据
10. 应用数据API - 来自Google Play和App Store的移动应用数据
11. 商业数据API - 来自Google My Business、Trustpilot等的商业列表数据

Local Falcon API (可选)

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

安装

# 克隆存储库
git clone https://github.com/Skobyn/dataforseo-mcp-server.git

# 切换到项目目录
cd dataforseo-mcp-server

# 安装依赖项
npm install

# 构建项目
npm run build

用法

要使用此MCP服务器，您需要您想要使用的服务的API凭据。

运行带有DataForSEO的服务器

# 设置DataForSEO身份验证的环境变量
export DATAFORSEO_LOGIN="your_login"
export DATAFORSEO_PASSWORD="your_password"

# 运行服务器
npm start

运行带有DataForSEO和Local Falcon的服务器

# 设置所有API身份验证的环境变量
export DATAFORSEO_LOGIN="your_login"
export DATAFORSEO_PASSWORD="your_password"
export LOCALFALCON_API_KEY="your_localfalcon_api_key"
# 可选：如果需要，设置自定义Local Falcon API URL
# export LOCALFALCON_API_URL="https://custom-localfalcon-url.com/api"

# 运行服务器
npm start

与Claude或其他LLM一起使用

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

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

开发

# 以热重载的开发模式运行
npm run dev

示例

查看examples目录，了解显示如何使用SEO工具 MCP 服务器的示例代码。

基本示例演示了：

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

可用工具

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

DataForSEO SERP API 工具

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

DataForSEO 关键词数据工具

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

有关模板，请参见src/api/localfalcon/中的Local Falcon集成。

许可证

MIT