Optiqra Mcp

io.github.armin5872由 GitHub 帳號 armin5872 發布v1.0.4更新於 Oct 24, 2026

MCP server exposing OptiQra's website audit tools: SEO, GEO, AEO, and AI-generated fixes.

已驗證STDIO僅桌面網頁搜尋與抓取開發者工具

概覽

AI 產生的概覽

本機 MCP 伺服器，封裝 OptiQra 的網站稽核 API，讓助理抓取網址檢查 SEO/GEO/AEO 問題並產生 AI 修正建議與洞察。

可以做什麼
抓取指定網址並執行完整的 SEO、GEO、AEO、效能、無障礙與安全稽核，回傳問題與評分報告；針對報告中的單一問題產生 AI 修正方案；依完整報告產生全站 AI 策略摘要；在呼叫 AI 工具前驗證 AI 供應商、API 金鑰與模型的組合是否可用。
適用情境
適合希望助理直接稽核網站在搜尋與 AI 可見性上的準備程度、解讀結果並草擬具體修正方案時使用。也可在執行 AI 修正或洞察工具前驗證供應商金鑰。
執行需求
以 stdio 方式在本機執行，通常透過 npx 或 node 啟動，需要 Node.js。選用環境變數：OPTIQRA_BASE_URL（預設指向公開示範實例）、OPTIQRA_PROVIDER_API_KEY（供 AI 工具使用）、OPTIQRA_TIMEOUT_MS（預設 120000）。需要能連線至 OptiQra 實例與所選 AI 供應商。
安裝前請注意
AI 工具需要 AI 供應商的 API 金鑰；建議在用戶端設定中設定 OPTIQRA_PROVIDER_API_KEY，而非讓模型在對話中傳遞。README 表示金鑰會轉送給供應商且不被儲存，但仍會離開本機。預設請求送往公開示範實例，若稽核資料敏感應將 OPTIQRA_BASE_URL 指向自有部署。整站抓取可能較慢。

安裝

在 SourceWeft 中

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

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

其他 MCP 客戶端

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

README

optiqra-mcp

An MCP (Model Context Protocol) server that exposes every tool in OptiQra's API to MCP-compatible AI clients (Claude Desktop, Claude Code, Cursor, etc.).

OptiQra has four HTTP endpoints. This server wraps all four as MCP tools:

ToolOptiQra endpointWhat it does
optiqra_analyzePOST /api/analyzeCrawls a URL and runs the full SEO/GEO/AEO/perf/a11y/security audit
optiqra_ai_fixPOST /api/ai-fixGenerates an AI-written fix for one issue from a report
optiqra_ai_insightsPOST /api/ai-insightsGenerates a site-wide AI strategy summary across a full report
optiqra_ai_testPOST /api/ai-testVerifies a provider/API key/model combo works before using the two above

By default it talks to the public demo, https://optiqra.vercel.app. Point it at your own deployment (see OptiQra's own DEPLOYMENT.md/Docker setup) with an env var — see below.

Install

bash
npm install

(or, once published, npm install -g optiqra-mcp / run directly with npx optiqra-mcp)

Configuration (environment variables)

VariableRequiredPurpose
OPTIQRA_BASE_URLNoBase URL of the OptiQra instance to call. Defaults to https://optiqra.vercel.app.
OPTIQRA_PROVIDER_API_KEYNoA default AI-provider API key used by optiqra_ai_fix/optiqra_ai_insights/optiqra_ai_test if the model doesn't pass one. Recommended over letting the model handle the key in plaintext.
OPTIQRA_TIMEOUT_MSNoRequest timeout in ms. Defaults to 120000 (full-site crawls can be slow).

Run it standalone

bash
node src/index.js

It speaks MCP over stdio, so you won't see anything happen — it's waiting for an MCP client to connect.

Wire it into an MCP client

Claude Desktop / Claude Code

Add to your MCP config (claude_desktop_config.json, or via claude mcp add for Claude Code):

json
{  "mcpServers": {    "optiqra": {      "command": "node",      "args": ["/absolute/path/to/optiqra-mcp/src/index.js"],      "env": {        "OPTIQRA_BASE_URL": "https://optiqra.vercel.app",        "OPTIQRA_PROVIDER_API_KEY": "sk-..."      }    }  }}
Any other MCP-compatible client (Cursor, Windsurf, etc.) uses the same`command`/`args`/`env` shape — check that client's docs for where the configfile lives.
## Notes on the AI-key tools
`optiqra_ai_fix`, `optiqra_ai_insights`, and `optiqra_ai_test` all need aprovider API key, exactly like pasting one into OptiQra's own UI — OptiQra'sserver forwards it straight to the provider (OpenAI, Anthropic, Google, Groq,OpenRouter, Mistral, DeepSeek, or xAI) and never stores it. This server doesthe same: it never persists keys. Prefer setting `OPTIQRA_PROVIDER_API_KEY`in your MCP client's env config over having the model pass a key throughchat.

來源：README.md，提交 d053955

工具

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

版本歷史

1
  1. v1.0.4最新Sep 16, 2026

評分

已滿足適用檢查項的 50%

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

  • 近 30 天內可連通25 分

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

  • 已宣告認證方式10 分

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

  • 已列出工具15 分

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

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