English Français العربية

io.github.armin5872/optiqra-mcp

السجل الرسمي التسويق والمبيعات

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

الشيفرة المصدرية الموقع التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

NPM package optiqra-mcp
Claude Code 
claude mcp add optiqra-mcp -e 'OPTIQRA_BASE_URL=<OPTIQRA_BASE_URL>' -e 'OPTIQRA_PROVIDER_API_KEY=<your optiqra_provider_api_key>' -e 'OPTIQRA_TIMEOUT_MS=<OPTIQRA_TIMEOUT_MS>' -- npx -y optiqra-mcp@1.0.4
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "optiqra-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "optiqra-mcp@1.0.4"
            ],
            "env": {
                "OPTIQRA_BASE_URL": "<OPTIQRA_BASE_URL>",
                "OPTIQRA_PROVIDER_API_KEY": "<your optiqra_provider_api_key>",
                "OPTIQRA_TIMEOUT_MS": "<OPTIQRA_TIMEOUT_MS>"
            }
        }
    }
}

متغيرات البيئة

  • OPTIQRA_BASE_URL Base 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_MS Request timeout in milliseconds. Defaults to 120000.

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. optiqra-mcp
  2. Install
  3. Configuration (environment variables)
  4. Run it standalone
  5. Wire it into an MCP client

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

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

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):

{
  "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.

الأسئلة الشائعة

ما هو io.github.armin5872/optiqra-mcp؟

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

كيف أثبّت io.github.armin5872/optiqra-mcp؟

يعمل على جهازك. في Claude Code: claude mcp add optiqra-mcp -e 'OPTIQRA_BASE_URL=<OPTIQRA_BASE_URL>' -e 'OPTIQRA_PROVIDER_API_KEY=<your optiqra_provider_api_key>' -e 'OPTIQRA_TIMEOUT_MS=<OPTIQRA_TIMEOUT_MS>' -- npx -y optiqra-mcp@1.0.4. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج io.github.armin5872/optiqra-mcp إلى مفتاح API؟

نعم. يتطلب OPTIQRA_PROVIDER_API_KEY، وتضبطها في إعداداته.

هل io.github.armin5872/optiqra-mcp مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون io.github.armin5872/optiqra-mcp؟

ينشره armin5872. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.