使用说明
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研发团队