STARWARCLOUD STARWAR.AI
返回市场
数据SEO人工智能MCP服务器

数据SEO人工智能MCP服务器

作者：aimonk20252 星标更新：2025-10-25
安装使用来源：spider==github.com

项目介绍

DataForSEO AI优化MCP服务器

用于跟踪品牌在大型语言模型（LLM）中的可见性（如ChatGPT、Claude、Gemini、Perplexity）的完整MCP服务器。

🚀 特点

✅ 实时响应LLM查询（4个工具）

实时查询任何LLM并引用：

  • chatgpt_live - ChatGPT (gpt-4o-mini, gpt-4o, gpt-4-turbo)
  • claude_live - Claude (claude-3-5-haiku, claude-3-5-sonnet)
  • gemini_live - Gemini (gemini-1.5-flash, gemini-1.5-pro)
  • perplexity_live - Perplexity (sonar, sonar-pro)

🔒 品牌提及（6个工具）

  • search_mentions - 在所有LLM中查找品牌提及
  • top_domains - 按域名进行竞争对手分析
  • top_pages - LLM响应中最成功的页面
  • aggregated_metrics - 跨时间的历史追踪
  • cross_aggregated_metrics - 并排比较多个域名

总计：10个专注于生产的工具

📋 先决条件

  • Python 3.10+
  • 带有API凭证的DataForSEO账户
  • Claude Desktop（用于测试）

🔧 安装

第一步：克隆或创建目录

mkdir dataforseo-mcp-server
cd dataforseo-mcp-server

第二步：创建虚拟环境

macOS/Linux:

python3 -m venv venv
source venv/bin/activate

Windows:

python -m venv venv
venv\Scripts\activate

第三步：安装依赖项

pip install -r requirements.txt

第四步：配置凭证

  1. 复制.env.example到.env：
cp .env.example .env
  1. 编辑.env并添加您的DataForSEO凭证：
DATAFORSEO_LOGIN=your_email@example.com
DATAFORSEO_PASSWORD=your_api_password_here

获取凭证：https://app.dataforseo.com/api-dashboard

第五步：测试认证

python test_auth.py

预期输出：

✅ 成功！您的DataForSEO凭证正在工作！

🚀 运行服务器

本地测试

python server.py

配置Claude Desktop

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  # 当前目录
which python  # Python路径（使用venv/bin/python）

# Windows
cd  # 当前目录
where python  # Python路径（使用venv\Scripts\python.exe）

重启Claude Desktop

  1. 完全退出Claude Desktop
  2. 重新打开Claude Desktop
  3. 查看右下角的🔌图标
  4. 点击它 - 您应该能看到“dataforseo-ai”列出

📖 使用示例

示例1：检查品牌提及

使用search_mentions检查“Semrush”是否在LLM中被提及

示例2：获取AI搜索量

获取AI搜索量：“SEO工具”，“关键词研究”，“链接建设”

示例3：多LLM比较

比较响应：询问ChatGPT、Claude和Gemini“最好的SEO工具有哪些？”

示例4：竞争对手分析

使用top_domains查看哪些竞争对手主导了“项目管理软件”

示例5：历史追踪

使用aggregated_metrics从2025年1月1日至2025年3月1日追踪semrush.com的提及情况

💰 成本追踪

所有工具都会记录其信用成本：

  • search_mentions：2个信用（$0.002）
  • ai_keyword_search_volume：每个关键词1个信用（$0.001）
  • chatgpt_live：根据模型不同5-20个信用（$0.005-$0.020）
  • top_domains：2个信用（$0.002）
  • aggregated_metrics：2个信用（$0.002）
  • 模型列表：免费（0个信用）

🐛 故障排除

错误：“DATAFORSEO_LOGIN和DATAFORSEO_PASSWORD必须设置”

  • 检查.env文件是否存在
  • 验证凭证是否正确
  • 确保=符号周围没有多余的空格

错误：“API错误：身份验证失败”

错误：“ModuleNotFoundError: 没有名为'fastmcp'的模块”

  • 激活虚拟环境：source venv/bin/activate
  • 重新安装依赖项：pip install -r requirements.txt

Claude Desktop未显示服务器

  • 检查配置文件路径是否正确
  • 使用绝对路径（不要使用相对路径如~/）
  • 完全重启Claude Desktop
  • 检查Claude Desktop设置中的日志

📊 日志

所有工具都会记录：

  • 输入参数
  • 输出摘要
  • 信用成本
  • 时间戳

当服务器运行时，在终端输出中查看详细日志。

🔐 安全

  • 绝不将.env提交到git
  • .gitignore已预配置
  • 凭证仅从环境变量加载

📚 API文档

完整的DataForSEO API文档：https://docs.dataforseo.com/v3/ai_optimization/overview/

🆘 支持

遇到问题？检查：

  1. DataForSEO API状态：https://status.dataforseo.com/
  2. DataForSEO支持：https://dataforseo.com/support
  3. 您的账户信用：https://app.dataforseo.com/

📝 许可

MIT许可 - 自由用于您的项目

🙏 致谢

由（https://github.com/chetanparma1）为SEO社区构建

由DataForSEO API提供支持

有问题？ 打开一个issue

想贡献？ 欢迎PR！参见CONTRIBUTING.md

喜欢这个项目？ 在GitHub上⭐它！