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 分