DataForSEO AI优化MCP服务器
用于在大型语言模型（如ChatGPT、Claude、Gemini、Perplexity）中追踪品牌可见度的完整MCP服务器。
🚀 功能特点
✅ 大语言模型实时响应（4种工具）
实时查询任何带有引用的大型语言模型（LLM）：
- chatgpt_live（可译为“ChatGPT直播”或根据具体语境调整为更贴切的表述） - ChatGPT（gpt-4o-mini，gpt-4o，gpt-4-turbo）
- claude现场直播 - 克劳德（claude-3-5-haiku，claude-3-5-sonnet）
- gemini_live 翻译为中文是“双子直播” - Gemini（gemini-1.5-flash，gemini-1.5-pro）
- 实时困惑度 - 混淆度（声纳，声纳专业版）
🔒 大型语言模型（LLM）提及（6种工具）
- 搜索提及（或“搜索@提及”） - 在所有大型语言模型中查找品牌提及
- 顶级域名 - 按领域进行竞争对手分析
- 顶级页面 - 大语言模型（LLM）响应中的顶级表现页面
- 聚合指标 - 随时间的历史追踪
- 跨聚合指标 - 并排比较多个领域
总计：10款经过优化、可投入生产的工具
📋 前提条件
- Python 3.10+（或可译为“Python 3.10及以上版本”）
- 拥有API凭据的DataForSEO账户
- Claude Desktop（用于测试）
🔧 安装
步骤1：克隆或创建目录
mkdir dataforseo-mcp-server
cd dataforseo-mcp-server步骤2：创建虚拟环境
macOS/Linux：
python3 -m venv venv
source venv/bin/activateWindows：
python -m venv venv
venv\Scripts\activate步骤3：安装依赖项
pip install -r requirements.txt步骤4：配置凭据
- 复制
.env.example到；向；对于；为了；以至于.env：
cp .env.example .env- 编辑
.env并添加您的DataForSEO凭据：
DATAFORSEO_LOGIN=your_email@example.com
DATAFORSEO_PASSWORD=your_api_password_here从以下网址获取凭据：https://app.dataforseo.com/api-dashboard
步骤5：测试认证
python test_auth.py预期输出：
✅ SUCCESS! Your DataForSEO credentials are working!🚀 运行服务器
本地测试
python server.py配置Claude桌面版
macOS：
编辑： ~/Library/Application Support/Claude/claude_desktop_config.json
{
"mcpServers": {
"dataforseo-ai": {
"command": "/FULL/PATH/TO/venv/bin/python",
"args": ["/FULL/PATH/TO/server.py"],
"env": {
"DATAFORSEO_LOGIN": "your_email@example.com",
"DATAFORSEO_PASSWORD": "your_api_password"
}
}
}
}Windows：
编辑： %APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"dataforseo-ai": {
"command": "C:\\FULL\\PATH\\TO\\venv\\Scripts\\python.exe",
"args": ["C:\\FULL\\PATH\\TO\\server.py"],
"env": {
"DATAFORSEO_LOGIN": "your_email@example.com",
"DATAFORSEO_PASSWORD": "your_api_password"
}
}
}
}获取完整路径：
# macOS/Linux
pwd # Current directory
which python # Python path (use venv/bin/python)
# Windows
cd # Current directory
where python # Python path (use venv\Scripts\python.exe)重启Claude桌面版
- 彻底退出Claude Desktop
- 重新打开Claude桌面版
- 在右下角寻找 🔌 图标
- 点击它 - 您应该会看到“dataforseo-ai”列在其中
📖 使用示例
示例1：检查品牌提及情况
Use search_mentions to check if "Semrush" is mentioned in LLMs示例2：获取AI搜索量
Get AI search volume for: "SEO tools", "keyword research", "link building"示例3：多模型（LLM）对比
Compare responses: Ask ChatGPT, Claude, and Gemini "What are the best SEO tools?"示例4：竞争对手分析
Use top_domains to see which competitors dominate for "project management software"示例5：历史追踪
Use aggregated_metrics to track semrush.com mentions from 2025-01-01 to 2025-03-01💰 成本追踪
所有工具都会记录其信用成本：
- 搜索提及（或：搜索提到的内容）2积分（0.002美元）
- AI关键词搜索量每个关键词1个积分（0.001美元）
- chatgpt_live（注：这个短语本身在中文中没有直接对应的翻译，因为它是一个特定网站或服务的名称，但可以理解为“ChatGPT实时服务”或“ChatGPT直播服务”，具体翻译需根据上下文确定。）根据型号不同，5-20积分（$0.005-$0.020）
- 顶级域名2个积分（0.002美元）
- 聚合指标2个积分（0.002美元）
- 模型列表免费（0学分）
🐛 故障排除
错误：“必须设置 DATAFORSEO_LOGIN 和 DATAFORSEO_PASSWORD”
- 检查
.env文件已存在 - 验证凭据是否正确
- 周围没有多余空格
=迹象；标志
错误：“API 错误：身份验证失败”
- 在 https://app.dataforseo.com/api-dashboard 验证凭据
- 检查账户是否有可用余额
- 确认使用API密码，而非账户密码
错误：“ModuleNotFoundError: 没有名为 'fastmcp' 的模块”
- 激活虚拟环境：
source venv/bin/activate - 重新安装依赖项：
pip install -r requirements.txt
Claude Desktop 未显示服务器
- 检查配置文件路径是否正确
- 使用绝对路径（而非相对路径，如
~/） - 完全重启Claude桌面版
- 在Claude桌面设置中检查日志
📊 日志记录
所有工具日志：
- 输入参数
- 输出摘要
- 信贷成本
- 时间戳
在服务器运行时检查终端输出以获取详细日志。
🔐 安全
- 永远不要承诺
.env这个短语“to git”在中文里并没有一个直接对应的、广泛认可的翻译，因为它不是一个标准的英语短语，而且“git”在英语中有多种含义，包括“获取”、“获得”以及在某些语境下作为俚语表示“糟糕的人”等。不过，如果仅从字面意思上理解，“to git”可以翻译为“去获取”或“去获得”，但这需要根据具体语境来确定最准确的翻译。在缺乏具体上下文的情况下，这样的翻译只能作为大致的参考 .gitignore是预先配置的- 凭据仅从环境变量中加载
📚 API 文档
完整的DataForSEO API文档：https://docs.dataforseo.com/v3/ai_optimization/overview/
🆘 支持
有问题吗？检查一下：
- DataForSEO API 状态：https://status.dataforseo.com/
- DataForSEO 支持页面：https://dataforseo.com/support
- 您的账户余额：https://app.dataforseo.com/
📝 许可证
MIT 许可证 - 在您的项目中自由使用
🙏 致谢
由（https://github.com/chetanparma1）为SEO社区打造
由……提供支持/驱动 DataForSEO（可译为“针对SEO的数据”或根据具体语境简化为“SEO数据”，但为保持原英文表达的完整性，这里保留“DataForSEO”作为译文） API
______________________________________________________________________
有问题吗？ 打开一个问题（或议题）
想贡献一份力量吗？ 欢迎提出拉取请求（PRs）！详见 CONTRIBUTING.md（贡献指南文件）
喜欢这个项目吗？ ⭐ 在GitHub上给它加个星标吧！