optiqra-mcp

本地服务

optiqra.vercel.app商业与营销011 周前更新

代码仓库访问官网

关于 optiqra-mcp

optiqra-mcp 将 OptiQra 的网站审计和 AI 分析功能封装为 MCP 服务，供兼容 MCP 的 AI 客户端调用。它涵盖 SEO、GEO、AEO、性能、无障碍和安全审计，并可针对报告生成修复建议。

主要功能

01爬取网址并执行综合审计
02为报告问题生成 AI 修复
03生成全站 AI 策略摘要
04测试 AI 提供商配置

适用场景

01检查网站的 SEO 与安全状况
02为审计发现的问题获取修复方案

MCP 相关

该 MCP 服务将 OptiQra API 的四个端点提供为工具，供 MCP 客户端调用。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "armin5872-optiqra": {
      "command": "npx",
      "args": [
        "-y",
        "optiqra-mcp"
      ],
      "env": {
        "OPTIQRA_BASE_URL": "<OPTIQRA_BASE_URL>",
        "OPTIQRA_PROVIDER_API_KEY": "<OPTIQRA_PROVIDER_API_KEY>",
        "OPTIQRA_TIMEOUT_MS": "<OPTIQRA_TIMEOUT_MS>"
      }
    }
  }
}

启动命令npx -y optiqra-mcp

需要配置的环境变量

OPTIQRA_BASE_URLBase URL of the OptiQra instance to call. Defaults to https://optiqra.vercel.app.

OPTIQRA_PROVIDER_API_KEY密钥Default AI-provider API key used by the ai-fix/ai-insights/ai-test tools if the caller doesn't pass one.

OPTIQRA_TIMEOUT_MSRequest timeout in milliseconds. Defaults to 120000.

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npmoptiqra-mcp1.0.4stdio

工具

收录的工具列表 · 更新于 3 周前

参数	类型	必填	说明
url	string	是	要分析的网站 URL，例如 https://example.com

详细介绍

optiqra-mcp

一个 MCP（Model Context Protocol）服务，可向兼容 MCP 的 AI 客户端（Claude Desktop、Claude Code、Cursor 等）开放 OptiQra API 中的所有工具。

OptiQra 有四个 HTTP 端点。此服务将这四个端点封装为 MCP 工具：

工具	OptiQra 端点	功能
`optiqra_analyze`	`POST /api/analyze`	抓取 URL 并运行完整的 SEO/GEO/AEO/性能/无障碍/安全审计
`optiqra_ai_fix`	`POST /api/ai-fix`	针对报告中的一个问题生成 AI 编写的修复方案
`optiqra_ai_insights`	`POST /api/ai-insights`	基于完整报告生成全站 AI 策略摘要
`optiqra_ai_test`	`POST /api/ai-test`	在使用上述两个工具之前，验证服务提供商/API 密钥/模型组合是否可用

默认情况下，它会连接到公共演示站点 https://optiqra.vercel.app。如需连接到你自己的部署（请参阅 OptiQra 自带的 DEPLOYMENT.md/Docker 设置），可通过环境变量指定，见下文。

安装

npm install

（或者，发布后，运行 npm install -g optiqra-mcp / 直接通过 npx optiqra-mcp 运行）

配置（环境变量）

变量	必填	用途
`OPTIQRA_BASE_URL`	否	要调用的 OptiQra 实例的基础 URL。默认为 `https://optiqra.vercel.app`。
`OPTIQRA_PROVIDER_API_KEY`	否	默认 AI 服务提供商 API 密钥；如果模型没有传入密钥，`optiqra_ai_fix`/`optiqra_ai_insights`/`optiqra_ai_test` 将使用此密钥。建议使用此方式，而不是让模型处理明文密钥。
`OPTIQRA_TIMEOUT_MS`	否	请求超时时间，单位为毫秒。默认为 `120000`（全站抓取可能耗时较长）。

独立运行

node src/index.js

它通过标准输入/输出使用 MCP，因此你不会看到任何动静——它正在等待 MCP 客户端连接。

接入 MCP 客户端

Claude Desktop / Claude Code

将以下内容添加到 MCP 配置中（claude_desktop_config.json，或在 Claude Code 中通过 claude mcp add 添加）：

{
  "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 config
file lives.

## Notes on the AI-key tools

`optiqra_ai_fix`, `optiqra_ai_insights`, and `optiqra_ai_test` all need a
provider API key, exactly like pasting one into OptiQra's own UI — OptiQra's
server forwards it straight to the provider (OpenAI, Anthropic, Google, Groq,
OpenRouter, Mistral, DeepSeek, or xAI) and never stores it. This server does
the 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 through
chat.

支持 Markdown

登录后评论