SISTRIX SEO Toolbox

io.github.Liohtml由 GitHub 帳號 Liohtml 發布v0.1.1更新於 Oct 24, 2026

Curated SISTRIX SEO tools: visibility, rankings, keywords, backlinks, AI visibility, Amazon data.

概覽

AI 產生的概覽

本機 MCP 伺服器,讓 AI 助理取得 SISTRIX SEO 資料:能見度、排名、關鍵字、反向連結、AI 能見度與 Amazon 市場指標。

可以做什麼
免費查詢 API 點數餘額,並列出可用的國家索引、SERP 功能與 AI 模型,接著執行網域報告:能見度趨勢、關鍵字數量、競爭對手、網域結構與帶流量的第二頁排名。查詢關鍵字搜尋量、CPC、意圖與 SERP 功能,並檢視反向連結概況與主要連結文字。查詢 AI 能見度資料,了解 ChatGPT、Perplexity 與 Google AI Overviews 引用了哪些品牌與來源,並依 ASIN 取得 Amazon 排名、價格與評論歷史。讀取 Optimizer 專案排名、頁面爬取結果與追蹤的 SERP,或透過通用工具呼叫任何其他有文件的 SISTRIX API 方法。執行四個引導式提示工作流程:SEO 健康檢查、關鍵字研究、競爭對手比較與 AI 能見度報告。
適用情境
適合希望助理不必離開聊天用戶端就能回答網域 SEO 問題、與競爭對手比較能見度、研究關鍵字,或查看 AI 助理如何引用某品牌時使用。適合想要以自架、留意點數消耗的方式取代託管橋接服務的 SISTRIX 訂閱者。
執行需求
以本機 stdio 程序執行,可透過 Cargo 或已發佈的容器映像安裝,不需要 Node 或 Python 執行環境。需要在 SISTRIX_API_KEY 中提供 SISTRIX API 金鑰,且 API 存取僅從 Plus 方案起提供。選用的 SISTRIX_COUNTRY 可設定預設國家索引。需要連線至 SISTRIX API 的網路存取。
安裝前請注意
SISTRIX_API_KEY 是付費帳戶憑證,應存放在用戶端的環境設定中,而非共用檔案。多數 API 呼叫依回傳列數從每週點數預算中扣點,列數上限過大會耗盡配額;伺服器預設 25 列,並提供免費餘額查詢。工具皆為唯讀查詢,但通用 API 工具可觸及任何有文件的方法。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 SISTRIX SEO Toolbox,將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only,透過 STDIO。 STDIO 服務會啟動本機處理程序,因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

[sistrix-mcp logo]

sistrix-mcp

Talk to your SISTRIX SEO data. From Claude, Cursor, VS Code, or any MCP client.

[CI] [Crates.io] [License: MIT] [Rust] [MCP]

17 curated, credit-aware SEO tools + a full-API escape hatch. Single binary, instant startup, context-friendly.

Quickstart · Clients · Tools · Credits · Configuration · FAQ


text
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?

Every question the SISTRIX Toolbox can answer, your AI assistant can now answer too — including follow-ups, comparisons, and "why?".

✨ Why sistrix-mcp?

🎯 Curated, not generated17 hand-crafted tools modeled on real SEO questions — not 90+ auto-generated API mirrors that flood the model's context and degrade tool selection.
🧭 Guided workflowsFour MCP prompts (SEO health check, keyword research, competitor comparison, AI visibility report) run a complete credit-aware analysis with one click.
💳 Credit-awareSISTRIX bills most API calls per returned row from a weekly credit budget. Every tool ships tight row limits, cost notes in the descriptions, and a free sistrix_credits balance check — so one question never burns your week.
⚡ Instant startupNo introspection round-trips. One static binary, no Node, no Python, no runtime. Starts in milliseconds.
🔒 Safe by defaultAPI key sent via POST body only (never in URLs/logs), redacted from every error message.
🧠 Context-friendlyRow limits on every report and a hard response budget with actionable guidance — one tool call can never blow up the context window.
🤖 AI visibility includedSISTRIX's newest data: which brands, entities, and sources ChatGPT, Perplexity, and Google AI Overviews actually cite (sistrix_ai_*).
🛒 Amazon includedMarketplace data by ASIN: rankings, price history, reviews (sistrix_amazon).
🧰 Never a cagesistrix_api reaches any documented API method (ai.check, marketplace.keyword., project.onpage., …) when the curated tools don't cover it.
🔁 ResilientAutomatic retries with backoff on 429/5xx/network hiccups. Every documented SISTRIX error code mapped to a hint the model can act on.

🚀 Quickstart

1. Install

Prebuilt binary (Linux, macOS, Windows) — grab it from Releases, or:

bash
# Cargocargo install sistrix-mcp
# From sourcecargo install --git https://github.com/Liohtml/sistrix-mcp
# Dockerdocker pull ghcr.io/liohtml/sistrix-mcp

2. Get a SISTRIX API key

app.sistrix.com/account/api → create a key. API access is included from the Plus package onwards and uses a weekly credit budget.

3. Verify the connection

bash
sistrix-mcp --api-key YOUR_KEY --check
text
✓ Connected — 10000 API credits available

4. Connect your client ⬇

🔌 Connect your client

Claude Code
bash
claude mcp add sistrix \  --env SISTRIX_API_KEY=YOUR_KEY \  --env SISTRIX_COUNTRY=de \  -- sistrix-mcp
Claude Desktop

Add to claude_desktop_config.json (macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\):

json
{  "mcpServers": {    "sistrix": {      "command": "sistrix-mcp",      "env": {        "SISTRIX_API_KEY": "YOUR_KEY",        "SISTRIX_COUNTRY": "de"      }    }  }}
Cursor

.cursor/mcp.json (project) or ~/.cursor/mcp.json (global):

json
{  "mcpServers": {    "sistrix": {      "command": "sistrix-mcp",      "env": {        "SISTRIX_API_KEY": "YOUR_KEY",        "SISTRIX_COUNTRY": "de"      }    }  }}
VS Code (GitHub Copilot)

.vscode/mcp.json:

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 / other MCP clients

Any client that speaks MCP over stdio works with the generic shape:

json
{  "command": "sistrix-mcp",  "args": [],  "env": {    "SISTRIX_API_KEY": "YOUR_KEY",    "SISTRIX_COUNTRY": "de"  }}
Docker (any client)
json
{  "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"      }    }  }}

[!TIP] Set SISTRIX_COUNTRY (e.g. de) and every tool call automatically uses that country index unless the model asks for another one.

🧭 Tools

ToolAnswers questions likeCredits*
sistrix_credits"How many API credits do we have left?"free
sistrix_lists"Which country indices / SERP features / AI models exist?"free
sistrix_domain_overview"How is example.com doing overall?"5 flat
sistrix_visibility"Visibility index trend over the last year? All-time high?"1/row
sistrix_keyword_counts"How many keywords do we rank for? Top-10 trend?"1/row
sistrix_competitors"Who are our closest SEO / Ads competitors?"1/row
sistrix_keyword_ideas"Which keywords are just off page 1 with the biggest potential?"1/row
sistrix_domain_structure"Which URLs/subdomains/directories drive our visibility?"1/row
sistrix_domain_rankings"All keywords we rank for on page 2, with traffic."1/row
sistrix_keyword"Volume, CPC, intent, SERP features for 'ergonomic chair'?"1–5/row
sistrix_links"How does our backlink profile look? Top link texts?"1/row–25 flat
sistrix_ai_top"Which brands does AI mention most in our market?"1/row
sistrix_ai_entity"How do ChatGPT & Co. see our brand? Which sources do they cite?"1/row–10 flat
sistrix_ai_tracker"How visible are we in our tracked AI prompts vs. competitors?"1/row
sistrix_project"Optimizer project rankings, onpage crawl results, tracked SERPs."varies
sistrix_amazon"Amazon rankings, price and review history for this ASIN."1/row
sistrix_apiEverything else — ai.check.*, marketplace.keyword.*, project.onpage.*, any documented methodvaries

*Costs as documented by SISTRIX per method; see API credits.

Domain tools accept a target (the domain, host, path, or URL) plus a scope that tells SISTRIX how to interpret it, a country index, and a row limit.

Guided workflows (MCP prompts)

Four ready-made analysis workflows ship as MCP prompts — clients like Claude surface them as one-click commands. Each runs a proven, credit-aware tool sequence and ends in a structured report:

PromptArgumentsWhat you get
seo_health_checktarget, country?Full status: key figures, trend, competitors, quick wins, next actions
keyword_researchkeyword, country?Metrics, intent, SERP features, questions, who ranks — plus a verdict
competitor_comparisontarget, competitor, country?Side-by-side comparison and 3 concrete moves to close the gap
ai_visibility_reportbrand, country?How ChatGPT & Co. see the brand: competitors, prompts, cited sources

Prompts to try

  • "Give me an SEO health check for example.com in Germany."
  • "Which keywords sit on positions 11–20 with the most traffic potential?"
  • "Compare our visibility trend with competitor-a.de over the last 12 months."
  • "Does ChatGPT recommend our brand? Which sources does it cite in our niche?"
  • "What's the search intent and CPC for our top 10 money keywords?"

💳 API credits

SISTRIX API access starts with the Plus package and uses a weekly credit budget. Most methods cost 1 credit per returned row; a few are flat-rate (domain.overview = 5, domain.visibilityindex.overview = 10, links.overview = 25) and keyword.seo.metrics costs 5 per keyword.

sistrix-mcp defaults every list to 25 rows (not SISTRIX's 100–10,000) and tells the model what each call costs, so exploratory conversations stay cheap. Check the balance anytime with sistrix_credits — it's free, as are sistrix_lists and the project/tracker list reports.

The rate limit is 300 requests/minute; sistrix-mcp backs off and retries automatically when it's hit.

⚙️ Configuration

FlagEnvDefaultDescription
--api-keySISTRIX_API_KEY— (required)SISTRIX API key (create here)
--countrySISTRIX_COUNTRYaccount defaultDefault country index (e.g. de, at, us) for all country-aware tools
--timeout-secsSISTRIX_TIMEOUT_SECS30Per-request timeout
--max-response-charsSISTRIX_MAX_RESPONSE_CHARS50000Response budget before truncation
--api-urlSISTRIX_API_URLhttps://api.sistrix.com/API endpoint (testing only)
--check——Verify the API key, print remaining credits, then exit

🆚 How is this different from SISTRIX's official MCP integration?

SISTRIX documents its own MCP bridge for connecting chatbots to the API — and per their docs, requests through it currently don't count against the credit quota. If that covers your needs, use it!

sistrix-mcp is the open-source, self-hosted alternative: a local stdio binary with a curated, fully documented tool surface (17 tools with exact schemas, enums, and per-case validation), an escape hatch to every documented API method including the newest areas (ai.check, marketplace, Optimizer onpage), hard response budgets for the model's context, offline tests, and no dependency on a hosted bridge. MIT-licensed, so you can read exactly what the model can and cannot do with your API key.

🩺 Troubleshooting

"wrong api key" (code 100)

Run sistrix-mcp --api-key ... --check. If it fails, regenerate the key under app.sistrix.com/account/api.

"not enough credits" (code 200)

The weekly budget is exhausted. Credits refill weekly; check the balance with sistrix_credits. Keep limit small — most tools cost 1 credit per row.

"package does not contain api access" (code 5000)

API access starts with the SISTRIX Plus package. Check your plan.

"domain not found" (code 2000)

The domain isn't in the SISTRIX database for the chosen country index. Try another country, or check the spelling.

Responses feel truncated

That's the context guard doing its job. Ask for fewer rows or raise --max-response-chars.

🏗️ Development

bash
git clone https://github.com/Liohtml/sistrix-mcp.gitcd sistrix-mcpcargo test                                  # 59 offline tests, no SISTRIX account neededcargo clippy --all-targets -- -D warningscargo run -- --api-key YOUR_KEY --check

See docs/ARCHITECTURE.md for the design, and docs/sistrix-api-reference.md for a complete, crawled reference of the SISTRIX API (all 91 methods with parameters and credit costs).

Contributions welcome — see CONTRIBUTING.md.

📄 License

MIT © Lionel Machire

  • MCP Registry name: mcp-name: io.github.Liohtml/sistrix-mcp
  • Also listed on Glama:
[sistrix-mcp on Glama]

Not affiliated with or endorsed by SISTRIX GmbH. SISTRIX is a trademark of SISTRIX GmbH.

來源:README.md,提交 0f323f3

工具

0
SourceWeft 尚未在沙箱中啟動過該軟體包,因此其工具未知。

版本歷史

1
  1. v0.1.1最新Sep 16, 2026

評分

已滿足適用檢查項的 50%

該評分衡量此收錄條目的完整程度,依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價,也不表示伺服器安全或目前可用:可連通性是帶日期的檢查結果,評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分

    請保持端點能夠回應 MCP 握手;SourceWeft 每 30 天探測一次。

  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭,或保持端點能夠回應探測,以便判定其認證方式。

  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list,或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分