星战科技xingzhan.cloud
返回市场
索引状态-MCP服务器-Java

索引状态-MCP服务器-Java

作者：SerpstatGlobal2 星标更新：2025-07-09
安装使用来源：spider==github.com

项目介绍

Serpstat MCP Server

用于与Serpstat API集成的MCP（模型上下文协议）服务器，实现用于SEO分析的API方法。

这是alpha版本v0.0.2。

要求

  • Java: 17+
  • Maven: 3.6+
  • Serpstat API令牌

获取API令牌：

个人资料中的令牌位置

安装和调试

  1. 如有需要安装JRE 17+

    sudo apt-get install openjdk-17-jre

  2. 如有需要安装Maven

    sudo apt-get install maven

  3. 克隆或创建项目：

    mkdir serpstat-mcp-server
cd serpstat-mcp-server

  4. 构建MCP服务器jar

    mvn clean package

  5. 运行测试工具脚本

    cp inspect.sh.example inspect.sh
chmod +x inspect.sh
# 编辑文件并设置令牌
vi inspect.sh
./inspect.sh

  6. 检查控制台并在浏览器中打开给定的网址

    user@pc:~/repo/serpstat-mcp-server-java$ ./inspect.sh
正在启动MCP检查器...
⚙️ 代理服务器正在监听端口6277
🔍 MCP检查器已在http://127.0.0.1:6274运行🚀

集成到Linux版Claude桌面

  • 单击Claude桌面右上角的菜单图标（三条线，“汉堡”）以打开设置。
  • 在菜单中，选择常规 → 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桌面

  • 遵循Serpstat MCP服务器安装指南中的步骤

  • TL;DR配置对于Windows版Claude桌面略有不同

    {
   "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"
         }
      }
   }
}

制作第一份报告！

尝试提示 能否帮我制作一份关于netpeak.bg的全面SEO报告？

由Claude生成的SEO报告截图，连接了Serpstat MCP服务器

#1 示例SEO报告netpeak.bg

您可以尝试用您自己的语言的提示！

让我们利用Serpstat为进入华沙市场的新品牌做准备。我们将销售饺子和糕点。品牌名为"Gorące Sztuki"。
* 考虑市场进入策略。
* 收集关键词语义。
* 分析竞争对手。
* 收集他们忽略的关键词语义。
* 创建语义核心并进行聚类。

由Claude生成的SEO策略报告截图，连接了Serpstat MCP服务器，使用波兰语

#2 示例SEO策略新品牌

包含的工具（v.0.0.2）

get_domains_info

使用Serpstat API获取全面的域名信息。返回可见性、关键词数量、估计流量、动态和PPC数据。

domain_regions_count

分析域名关键词在所有Google地区数据库中的存在情况。显示按国家划分的关键词数量、区域性能比较和国际SEO洞察。从这个工具开始每个复杂的域名分析。

domain_keywords

获取域名在Google搜索结果中排名的关键词。包括位置、流量、难度分析以及全面的SEO洞察和性能指标。

get_domain_competitors

从搜索结果中获取顶级20个域名竞争对手及其SEO指标、流量、可见性和相关性得分。

get_backlinks_summary

使用Serpstat API获取全面的反向链接摘要。返回引用域、反向链接数量、链接类型、质量指标及最近的变化。

api_stats

获取当前API使用统计和信用限额。显示剩余信用、使用百分比，并提供优化使用的建议。

projects_list

获取用户项目的列表，包括项目ID、名称、域名、创建日期和用户角色。对项目管理和获取其他API调用所需的项目ID非常有用。不消耗API信用。

get_keywords 🆕

研究相关关键词并获取搜索量、CPC、竞争数据。显示与种子关键词相关的有机关键词，这些关键词出现在Google的前100个结果中。包括体积、每次点击成本、难度和SERP特征分析。每个返回的关键词消耗1个API信用。

keyword_competitors 🆕

分析在Google搜索结果中争夺特定关键词的域名。返回顶级20个竞争对手及其全面的SEO指标，包括可见性评分、流量估算、相关性分析和市场动态。提供智能的竞争水平评估（低/中/高/非常高），识别广告竞争模式，基于竞争对手动态分析市场趋势，并根据表现层级对竞争对手进行分类。支持通过域名列表、流量范围、可见性阈值和相关性分数进行高级过滤。每个竞争对手消耗1个API信用，每次请求至少消耗1个信用（即使结果为空）。对于竞争分析、关键词难度评估和市场机会识别至关重要。

get_related_keywords 🆕

查找语义相关的关键词以扩展内容策略。返回关键词及其搜索量、每次点击成本、连接强度、难度评分和全面的语义分析。显示所有与搜索关键词语义相关的搜索查询及其关系强度（权重）、搜索意图分布、SERP特征存在和地理相关性。包括通过体积范围、难度级别、连接强度、关键词模式、意图和SERP特征进行的高级过滤。基于语义聚类提供智能的内容策略建议：为强连接关键词进行语义扩展，为低难度机会快速取胜，为地理聚焦词进行本地定位，为利基市场制定长尾策略。每个关键词消耗1个API信用，每次请求至少消耗1个信用（即使结果为空）。对于内容缺口分析、语义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许可证

  • 这个东西处于MIT许可证下，这意味着您可以复制、使用、修改甚至出售此代码的任何部分而无需麻烦。
  • 想要抓取一部分用于您的项目吗？尽管去吧。
  • 想要重写一半并发布商业产品吗？请随意。
  • 您唯一需要做的事情是在您所取的文件中不删除版权声明和许可证本身，并记得在收到薪水时对Serpstat团队说声感谢。

来自Serpstat研发团队的爱