Serpstat MCP 服务器
MCP（模型上下文协议）服务器，用于与Serpstat API集成，实现用于SEO分析的API方法。
这是v0.0.2的alpha版本。
需求
- Java: 17+
- 梅文: 3.6+
- Serpstat API令牌
获取API令牌：
- 如果您没有订阅该计划：请转到https://serpstat.com购买订阅或激活启用API访问的团队或更高级别计划的试用访问。
- 如果您已经订阅：转到 您的Serpstat个人资料 并复制它。
安装调试
- 如果需要，安装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?
您可以尝试使用您的语言进行提示！
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 sklastruj包含的工具（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研发团队_