Wincher MCP Server

克劳德桌面版Wincher MCP服务器

自然语言SEO分析-通过Claude Desktop查询您的Wincher数据

这有什么作用

此MCP（模型上下文协议）服务器将Claude Desktop连接到Wincher的SEO API，使您能够使用自然对话而不是导航仪表板来分析关键词排名、竞争对手和SERP数据。

问克劳德这样的问题：

• “比较我们与Splunk在所有关键字上的排名”
• “显示‘SIEM软件’的SERP功能”
• “本月哪些关键词在下降？”
• “与竞争对手相比，我们的声音份额是多少？”

特性

✅ 竞争对手分析 -比较排名、流量和语音份额\ ✅ 关键字性能 -跟踪位置、音量、CPC和难度\ ✅ SERP情报 -查看谁在何处排名以及出现了哪些功能\ ✅ 历史趋势 -分析排名随时间的变化\ ✅ 批量操作 -高效查询多个关键字\ ✅ 关键字组 -按主题/类别汇总绩效

先决条件

• Python 3.10+
• Claude桌面应用程序
• 具有API访问权限的绞车帐户

快速开始

1.克隆存储库

git clone https://github.com/yourusername/wincher-mcp-server.git
cd wincher-mcp-server

2.创建虚拟环境

python3 -m venv wincher-mcp-env
source wincher-mcp-env/bin/activate  # On Windows: wincher-mcp-env\Scripts\activate

3.安装依赖项

pip install -r requirements.txt

4.获取绞车API钥匙

1. 登录Wincher
2. 导航到“设置”→ 个人访问令牌
3. 生成新令牌
4. 复制令牌

5.配置克劳德桌面

编辑您的Claude Desktop配置文件：

• 雨衣： ~/Library/Application Support/Claude/claude_desktop_config.json
• 窗户： %APPDATA%\Claude\claude_desktop_config.json

添加此配置：

{
  "mcpServers": {
    "wincher": {
      "command": "/full/path/to/wincher-mcp-env/bin/python",
      "args": ["/full/path/to/wincher_mcp_server.py"],
      "env": {
        "WINCHER_API_KEY": "your_wincher_api_key_here"
      }
    }
  }
}

替换：

• /full/path/to/ 与你的实际路径
• your_wincher_api_key_here 使用API密钥

6.重新启动克劳德桌面

退出并完全重新打开Claude Desktop。

使用示例

看 示例.md 50多个示例提示。

快速示例：

"Show me all my tracked websites in Wincher"
"List keywords where we rank in the top 10"
"Compare our SEO performance vs [competitor]"
"Show me the SERP for 'your target keyword'"
"Which keyword group has the best average position?"

可用工具

MCP服务器为Claude提供以下工具：

• get_websites -列出跟踪的网站
• get_keywords -获取网站的关键字和排名
• get_keyword_rankings -历史排名数据
• get_competitor_ranking_summaries -与竞争对手比较
• get_competitor_keyword_positions -逐个关键字比较
• get_serps -具有特征的SERP分析
• get_keyword_groups -集团绩效指标
• get_bulk_ranking_history -批量历史数据
• get_annotations -SEO活动说明

故障排除

服务器未连接？

• 验证中的路径 claude_desktop_config.json 是绝对路径
• 检查虚拟环境是否位于正确的位置
• 确保API密钥有效

没有数据返回？

• 验证您在Wincher中跟踪了网站和关键字
• 检查API密钥是否具有正确的权限
• 尝试使用curl命令测试API键

需要帮助？

• 在GitHub上打开一个问题
• 检查 详细设置指南

我为什么建造这个

作为Graylog（一家网络安全SIEM公司）的营销专业人员，我每周都要花几个小时手动提取SEO数据，比较竞争对手的排名，并构建报告。这种集成通过自然对话实现即时分析，每周可节省约4小时。

贡献

欢迎投稿！拜托：

1. 复刻仓库
2. 创建要素分支
3. 进行更改
4. 提交拉取请求

安全说明

⚠️ 永远不要将API密钥提交给版本控制。始终使用环境变量或上面显示的配置方法。

许可证

MIT许可证-请参阅 许可证 详细信息文件

致谢

• 内置于 Anthropic的MCP SDK
• 用途 绞车API

连接

由Chris Tutt建造| 领英

如果这有助于你的SEO工作流程，给它一个⭐!

## `.env.example` Content:

绞车API配置

从以下位置获取API密钥：https://www.wincher.com（设置→ 个人访问令牌）

WINCHER_API_KEY=您的_API_KEY_here