Serpstat MCP 服务器
MCP（模型上下文协议）服务器，用于与Serpstat API集成，实现用于SEO分析的API方法。
这是v0.0.2的alpha版本。
需求
- Java: 17+
- 梅文: 3.6+
- Serpstat API令牌
获取API令牌：
- 如果您没有订阅该计划：请转到https://serpstat.com购买订阅或激活启用API访问的团队或更高级别计划的试用访问。
- 如果您已经订阅：转到 您的Serpstat个人资料 并复制它。
location of token in your Profile
安装调试
- 如果需要，安装JRE 17+
sudo apt-get install openjdk-17-jre- 如果需要，安装Maven
sudo apt-get install maven- 克隆或创建项目：
mkdir serpstat-mcp-server
cd serpstat-mcp-server- 构建mcp服务器jar
mvn clean package- Maka运行测试工具脚本
cp inspect.sh.example inspect.sh
chmod +x inspect.sh
# edit file and set token
vi inspect.sh
./inspect.sh- 检查控制台并在浏览器中打开给定的网址
user@pc:~/repo/serpstat-mcp-server-java$ ./inspect.sh
Starting MCP inspector...
⚙️ Proxy server listening on port 6277
🔍 MCP Inspector is up and running at http://127.0.0.1:6274 🚀集成到Linux版的Claude桌面
- 点击克劳德桌面右上角的菜单图标（三行，“汉堡”）打开 设置.
- 在菜单中，选择 将军→ 克劳德设置→ 配置 （这将打开您的个人资料设置）。
- 在配置文件设置中，转到 开发者 选项卡并单击 编辑配置 添加或更新MCP服务器配置。
- 使用JAR文件和令牌的路径添加配置。保存它。
{
"mcpServers": {
"serpstat": {
"command": "java",
"args": ["-jar", "/path/to/jar/location/serpstat-mcp-server-java-0.0.2.jar"],
"env": {
"SERPSTAT_API_TOKEN": "PLACE_API_TOKEN_HERE",
"LANG": "en_US.UTF-8",
"LC_ALL": "en_US.UTF-8"
}
}
}
}集成到Windows版的Claude Desktop
- TL；Claude Desktop的DR配置有点不同
{
"mcpServers": {
"serpstat": {
"command": "java",
"args": [
"-Dfile.encoding=UTF-8",
"-Dconsole.encoding=UTF-8",
"-jar",
"c:/serpstat_mcp/serpstat-mcp-server-java-0.0.2.jar"
],
"env": {
"SERPSTAT_API_TOKEN": "PLACE_YOUR_TOKEN_HERE",
"JAVA_TOOL_OPTIONS": "-Dfile.encoding=UTF-8"
}
}
}
}做第一份报告！
尝试提示 Would you mind to make me a comprehensive SEO report for the netpeak.bg with Serpstat?
Screen shot of SEO Report generated by Claude with connected Serpstat MCP Server
您可以尝试使用您的语言进行提示！
Przygotujmy nową markę do wejścia na rynek warszawski za pomocą Serpstat. Będziemy sprzedawać pierogi i wypieki. Nazwa "Gorące Sztuki".
* Przemyśl strategię wejścia na rynek.
* Zbierz semantykę dla niszy.
* Przeanalizuj konkurentów.
* Zbierz pominiętą przez nich semantykę.
* Stwórz rdzeń semantyczny i sklastrujScreen shot of SEO Strategy Report generated by Claude with connected Serpstat MCP Server in Polish
包含的工具（v.0.0.2）
get_domains_info
使用Serpstat API获取全面的域信息。返回可见性、关键字计数、估计流量， 用于多个域的动态和PPC数据。
domain_regions_count
分析所有谷歌区域数据库中的域名关键字存在情况。按国家、地区显示关键字计数 性能比较和国际SEO见解。使用此工具开始每个复杂的领域分析。
domain_keywords
获取该域名在谷歌搜索结果中排名的关键字。包括位置、交通、难度分析 全面的SEO见解和性能指标。
get_domain_competitors
从搜索结果中获取排名前20的域名竞争对手，包括SEO指标、流量、知名度和相关性得分。
get_backlinks_summary
使用Serpstat API获取全面的反向链接摘要。返回引用域、反向链接计数、链接类型、， 例如域或子域的质量指标和最近的变化。
api_stats
获取当前API使用统计数据和信用额度。显示剩余积分、使用百分比，并提供 最佳使用建议。
projects_list
获取用户项目列表，其中包含项目ID、名称、域、创建日期和用户角色等详细信息。对于项目管理和获取其他API调用的项目ID非常有用。不消耗API信用。",
get_keywords 🆕
研究相关关键词，获取搜索量、CPC、竞争数据。显示与种子关联的有机关键字 域名在谷歌前100名结果中排名的关键字。包括数量、每次点击成本、难度和SERP 特征分析。每个返回的关键字花费1个API信用。
keyword_competitors 🆕
分析在谷歌搜索结果中争夺特定关键字的域名。以综合排名返回前20位的竞争对手 SEO指标包括可见性得分、流量估计、相关性分析和市场动态。提供智能 竞争水平评估（低/中/高/高），确定广告竞争模式，分析市场 基于竞争对手动态的趋势，并按绩效等级对竞争对手进行分类。支持高级过滤 域列表、流量范围、可见性阈值和相关性得分。每个竞争对手都要花费1个API信用额度 每次请求最低收费1个学分（即使是空结果）。竞争分析必不可少，关键字难度 评估和市场机会识别。
get_related_keywords 🆕
查找语义相关的关键字以扩展内容策略。返回带有搜索量、每次点击成本、， 连接强度、难度分数和综合语义分析。显示以下所有搜索查询 与搜索到的关键字在语义上相关，并对关系强度（权重）、搜索意图进行详细分析 分布、SERP特征存在和地理相关性。包括按音量范围、难度进行高级过滤 级别、连接强度、关键字模式、意图和SERP特征。提供智能内容策略 基于语义聚类的推荐：强连接关键字的语义扩展，速赢 低难度机会、以地理为重点的本地定位以及针对利基市场的长尾策略。每 关键字花费1个API信用，每个请求最低收费一个信用（即使是空结果）。内容必不可少 差距分析、语义SEO规划和全面的关键字宇宙映射。
日志记录
日志将写入：
- 文件
logs/serpstat-mcp-server.log（所有级别）
日志文件会按天和大小自动轮换。
错误处理
服务器处理以下类型的错误：
- API令牌丢失或无效。
- 请求参数无效。
- 网络和HTTP错误。
- Serpstat API错误。
- 内部服务器错误。
整合
使用API令牌设置环境变量：
在终端中运行以下命令（替换 your_serpstat_api_token_here 使用您的令牌）：
export SERPSTAT_API_TOKEN=your_serpstat_api_token_here安全
- API令牌通过环境变量传递。
- 令牌未完全记录。
- 所有HTTP请求都使用HTTPS。
- 配置超时以防止挂起。
支持
获得Serpstat支持的最有效方法是直接在平台内使用他们的实时聊天功能。
或者，您可以发送电子邮件至 support@serpstat.com
许可证
MIT许可证
- 这件事是在麻省理工学院的许可下进行的，这意味着你可以毫无困难地复制、使用、修改甚至出售这段代码的任何部分。
- 想为你的项目争取一块钱吗？去吧。
- 想重写一半并发布商业产品吗？请便。
- 你唯一需要做的就是不要从你的文件中删除版权和许可证本身，当你拿到薪水时，记住Serpstat团队的好话。
_带着爱，Serpstat研发团队_