关于 SISTRIX SEO Toolbox
SISTRIX SEO Toolbox 是面向 SEO 从业者的 MCP 服务,提供 SISTRIX 搜索数据、AI 可见度及 Amazon 数据查询。它将工具调用与 API 积分成本关联,并提供分析工作流提示词及完整 API 入口。
主要功能
- 0117 个精选 SEO 工具
- 02查询排名、关键词、竞争对手和外链
- 03分析 AI 品牌提及及引用来源
- 04查询 Amazon 排名、价格和评论
- 05显示 API 积分并控制结果行数
- 06提供 SEO 分析工作流提示词
适用场景
- 01检查域名可见度和排名趋势
- 02寻找关键词机会并比较竞争对手
- 03查看 ChatGPT 等 AI 的品牌引用
- 04跟踪 Amazon 商品排名和价格历史
- 05运行 SEO 健康检查或关键词研究
MCP 相关
它通过 MCP 向客户端提供 SISTRIX 数据工具和四种分析提示词,并支持调用已文档化的 API 方法。工具描述包含积分成本信息,列表结果设有行数限制。
配置
本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。
我们还没有获取到这个服务的安装包或远程地址,请按项目 README 中的说明安装。
工具
本地服务需要在你的电脑上运行后才能读取工具,维护者暂未提供工具列表。
详细介绍
sistrix-mcp
与 SISTRIX SEO 数据对话。 可通过 Claude、Cursor、VS Code 或任何 MCP 客户端使用。
17 个精选且考虑额度的 SEO 工具,以及一个完整 API 直通入口。单个二进制文件,启动即用,适合上下文使用。
You ▸ How is example.com doing in Google — and who is beating us?
Claude ▸ example.com's visibility index is 4.82 (Germany), up 6% over the last
8 weeks. It ranks for 18,400 organic keywords, 2,100 in the top 10.
Closest SEO competitors: competitor-a.de (74% overlap),
competitor-b.com (61%). Biggest opportunity: 312 keywords sit on
page 2 — want the top 20 by potential gain?
SISTRIX Toolbox 能回答的所有问题,现在你的 AI 助手也能回答——包括后续问题、比较分析和“为什么?”。
✨ 为什么选择 sistrix-mcp?
| 🎯 精选而非生成 | 17 个精心打造的工具,围绕真实 SEO 问题设计——而不是 90 多个自动生成的 API 镜像,后者会挤占模型上下文并降低工具选择质量。 |
| 🧭 引导式工作流 | 四个 MCP 提示词(SEO 健康检查、关键词研究、竞争对手比较、AI 可见度报告)只需单击一次,即可运行完整且考虑额度的分析。 |
| 💳 考虑额度 | SISTRIX 的大多数 API 调用会按返回行数从每周额度中扣除。每个工具都设有严格的行数限制,在说明中注明成本,并提供免费的 sistrix_credits 额度余额查询——避免一个问题就耗尽你一周的额度。 |
| ⚡ 即时启动 | 无需往返进行内省。单个静态二进制文件,无需 Node、Python 或运行时。毫秒级启动。 |
| 🔒 默认安全 | API 密钥仅通过 POST 请求正文发送(绝不出现在 URL 或日志中),并会从所有错误消息中脱敏。 |
| 🧠 适合上下文使用 | 每份报告都有限制行数,并设有硬性响应预算和可执行的指导——单次工具调用绝不会撑爆上下文窗口。 |
| 🤖 内置 AI 可见度数据 | SISTRIX 最新数据:ChatGPT、Perplexity 和 Google AI Overviews 实际引用了哪些品牌、实体和来源(sistrix_ai_*)。 |
| 🛒 内置 Amazon 数据 | 按 ASIN 提供 Marketplace 数据:排名、价格历史、评价(sistrix_amazon)。 |
| 🧰 绝不受限 | 精选工具未涵盖时,sistrix_api 可调用任何有文档说明的 API 方法(ai.check、marketplace.keyword.、project.onpage. 等)。 |
| 🔁 运行可靠 | 遇到 429/5xx/网络故障时自动重试并采用退避策略。所有有文档说明的 SISTRIX 错误代码都会映射为模型可执行的提示。 |
🚀 快速入门
1. 安装
预构建二进制文件(Linux、macOS、Windows)——从 Releases 下载,或者:
# Cargo
cargo install sistrix-mcp
# From source
cargo install --git https://github.com/Liohtml/sistrix-mcp
# Docker
docker pull ghcr.io/liohtml/sistrix-mcp
2. 获取 SISTRIX API 密钥
前往 app.sistrix.com/account/api → 创建密钥。 从 Plus 套餐起即可使用 API,并采用每周额度。
3. 验证连接
sistrix-mcp --api-key YOUR_KEY --check
✓ Connected — 10000 API credits available
4. 连接你的客户端 ⬇
🔌 连接你的客户端
Claude Code
claude mcp add sistrix \
--env SISTRIX_API_KEY=YOUR_KEY \
--env SISTRIX_COUNTRY=de \
-- sistrix-mcp
Claude Desktop
添加到 claude_desktop_config.json(macOS:~/Library/Application Support/Claude/,Windows:%APPDATA%\Claude\):
{
"mcpServers": {
"sistrix": {
"command": "sistrix-mcp",
"env": {
"SISTRIX_API_KEY": "YOUR_KEY",
"SISTRIX_COUNTRY": "de"
}
}
}
}
Cursor
.cursor/mcp.json(项目级)或 ~/.cursor/mcp.json(全局):
{
"mcpServers": {
"sistrix": {
"command": "sistrix-mcp",
"env": {
"SISTRIX_API_KEY": "YOUR_KEY",
"SISTRIX_COUNTRY": "de"
}
}
}
}
VS Code (GitHub Copilot)
.vscode/mcp.json:
{
"servers": {
"sistrix": {
"type": "stdio",
"command": "sistrix-mcp",
"env": {
"SISTRIX_API_KEY": "${input:sistrix-key}",
"SISTRIX_COUNTRY": "de"
}
}
},
"inputs": [
{
"id": "sistrix-key",
"type": "promptString",
"description": "SISTRIX API key",
"password": true
}
]
}
Windsurf / Zed / 其他 MCP 客户端
任何通过 stdio 使用 MCP 通信的客户端都可以使用以下通用配置:
{
"command": "sistrix-mcp",
"args": [],
"env": {
"SISTRIX_API_KEY": "YOUR_KEY",
"SISTRIX_COUNTRY": "de"
}
}
Docker(任何客户端)
{
"mcpServers": {
"sistrix": {
"command": "docker",
"args": [
"run", "-i", "--rm",
"-e", "SISTRIX_API_KEY", "-e", "SISTRIX_COUNTRY",
"ghcr.io/liohtml/sistrix-mcp"
],
"env": {
"SISTRIX_API_KEY": "YOUR_KEY",
"SISTRIX_COUNTRY": "de"
}
}
}
}
提示
设置
SISTRIX_COUNTRY(例如de),每次工具调用都会自动使用该 国家索引,除非模型要求使用其他索引。
🧭 工具
| 工具 | 可回答的问题示例 | 积分* |
|---|---|---|
sistrix_credits | “我们还剩多少 API 积分?” | 免费 |
sistrix_lists | “有哪些国家索引 / SERP 功能 / AI 模型?” | 免费 |
sistrix_domain_overview | “example.com 的整体表现如何?” | 固定 5 |
sistrix_visibility | “过去一年可见度指数的趋势如何?历史最高值是多少?” | 每行 1 |
sistrix_keyword_counts | “我们有多少关键词获得排名?前 10 名趋势如何?” | 每行 1 |
sistrix_competitors | “哪些是我们最接近的 SEO / Ads 竞争对手?” | 每行 1 |
sistrix_keyword_ideas | “哪些关键词刚好未进入第 1 页且潜力最大?” | 每行 1 |
sistrix_domain_structure | “哪些 URL / 子域名 / 目录带动了我们的可见度?” | 每行 1 |
sistrix_domain_rankings | “我们在第 2 页获得排名的所有关键词及其流量。” | 每行 1 |
sistrix_keyword | “‘ergonomic chair’的搜索量、CPC、意图和 SERP 功能有哪些?” | 每行 1–5 |
sistrix_links | “我们的反向链接概况如何?热门链接文本有哪些?” | 每行 1–25(固定) |
sistrix_ai_top | “AI 在我们的市场中最常提及哪些品牌?” | 每行 1 |
sistrix_ai_entity | “ChatGPT 等如何看待我们的品牌?它们引用了哪些来源?” | 每行 1–10(固定) |
sistrix_ai_tracker | “在跟踪的 AI 提示词中,我们相较于竞争对手的可见度如何?” | 每行 1 |
sistrix_project | “Optimizer 项目排名、页面抓取结果、跟踪的 SERP。” | 不定 |
sistrix_amazon | “此 ASIN 的 Amazon 排名、价格和评价历史。” | 每行 1 |
sistrix_api | 其他所有内容——ai.check.*、marketplace.keyword.*、project.onpage.*、任何已记录的方法 | 不定 |
*各方法的费用以 SISTRIX 文档为准;请参阅 API 积分。
域名工具接受 target(域名、主机、路径或 URL)、用于告知 SISTRIX 如何解读它的 scope、country 索引以及行数 limit。
引导式工作流(MCP 提示词)
我们提供四种现成的分析工作流,作为 MCP 提示词使用——Claude 等客户端会将其显示为一键命令。每种工作流都会运行经过验证且考虑积分消耗的工具序列,并以结构化报告收尾:
| 提示词 | 参数 | 结果 |
|---|---|---|
seo_health_check | target、country? | 完整状况:关键数据、趋势、竞争对手、快速见效项、后续行动 |
keyword_research | keyword、country? | 指标、意图、SERP 功能、问题、排名对象——以及结论 |
competitor_comparison | target、competitor、country? | 并排比较,以及 3 项缩小差距的具体举措 |
ai_visibility_report | brand、country? | ChatGPT 等如何看待该品牌:竞争对手、提示词、引用来源 |
可尝试的提示词
- "为 example.com 在德国进行一次 SEO 健康检查。"
- "哪些关键词排名在 11–20 位,且流量潜力最大?"
- "对比我们与 competitor-a.de 过去 12 个月的可见度趋势。"
- "ChatGPT 会推荐我们的品牌吗?它在我们的细分领域引用了哪些来源?"
- "我们排名前 10 的核心关键词的搜索意图和 CPC 是什么?"
💳 API 额度
SISTRIX API 访问权限从 Plus 套餐开始,并使用每周额度预算。大多数方法每返回一行消耗 1 个额度;少数方法按固定额度收费(domain.overview = 5,domain.visibilityindex.overview = 10,links.overview = 25),而 keyword.seo.metrics 每个关键词消耗 5 个额度。
sistrix-mcp 默认将每个列表限制为 25 行(而非 SISTRIX 的 100–10,000 行),并告知模型每次调用的成本,因此探索性对话也能保持低成本。可随时通过 sistrix_credits 免费查看余额;sistrix_lists 和项目/跟踪器列表报告也都是免费的。
速率限制为每分钟 300 次请求;达到限制时,sistrix-mcp 会自动退避并重试。
⚙️ 配置
| 标志 | 环境变量 | 默认值 | 说明 |
|---|---|---|---|
--api-key | SISTRIX_API_KEY | — (必需) | SISTRIX API 密钥(在此创建) |
--country | SISTRIX_COUNTRY | 账户默认值 | 所有适用国家/地区的工具所用的默认国家/地区索引(例如 de、at、us) |
--timeout-secs | SISTRIX_TIMEOUT_SECS | 30 | 每次请求的超时时间 |
--max-response-chars | SISTRIX_MAX_RESPONSE_CHARS | 50000 | 截断前的响应长度上限 |
--api-url | SISTRIX_API_URL | https://api.sistrix.com/ | API 端点(仅用于测试) |
--check | — | — | 验证 API 密钥、显示剩余额度,然后退出 |
🆚 这与 SISTRIX 官方 MCP 集成有何不同?
SISTRIX 介绍了自家的 MCP 桥接服务,用于将聊天机器人连接到 API;根据其文档,目前通过该服务发出的请求不会计入额度。如果这能满足你的需求,就使用它吧!
sistrix-mcp 是开源、可自托管的替代方案:本地 stdio 二进制程序,提供精心整理且文档完备的工具集(17 个工具,包含精确的架构、枚举值和针对各种情况的验证);还提供一个后备入口,可调用所有有文档记录的 API 方法,包括最新的功能领域(ai.check、marketplace、Optimizer onpage);并为模型上下文设置严格的响应长度上限,支持离线测试,且不依赖托管的桥接服务。它采用 MIT 许可证,因此你可以确切了解模型能否使用你的 API 密钥执行某项操作。
🩺 故障排除
“wrong api key”(代码 100)
运行 sistrix-mcp --api-key ... --check。如果失败,请在
app.sistrix.com/account/api 下重新生成密钥。
“not enough credits”(代码 200)
每周额度已用尽。额度每周补充;请通过 sistrix_credits 查看余额。请将 limit 设得较小——大多数工具每行消耗 1 个额度。
“package does not contain api access”(代码 5000)
SISTRIX Plus 套餐起提供 API 访问权限。请检查你的套餐。
“domain not found”(代码 2000)
所选国家/地区索引对应的 SISTRIX 数据库中没有该域名。请尝试其他 country,或检查拼写。
响应似乎被截断
这是上下文保护机制在发挥作用。请减少行数,或提高 --max-response-chars 的值。
🏗️ 开发
git clone https://github.com/Liohtml/sistrix-mcp.git
cd sistrix-mcp
cargo test # 59 offline tests, no SISTRIX account needed
cargo clippy --all-targets -- -D warnings
cargo run -- --api-key YOUR_KEY --check
设计说明请参阅 docs/ARCHITECTURE.md;完整抓取的 SISTRIX API 参考文档(涵盖全部 91 个方法及其参数和额度成本)请参阅 docs/sistrix-api-reference.md。
欢迎贡献——请参阅 CONTRIBUTING.md。
📄 许可证
MIT © Lionel Machire
- MCP 注册表名称:
mcp-name: io.github.Liohtml/sistrix-mcp - 也已列入 Glama:
与 SISTRIX GmbH 无关联,也未获其认可。SISTRIX 是 SISTRIX GmbH 的商标。
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。