English Français العربية

com.metricspot/seo-mcp

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

Six tools for SEO and AI-readability audits. 91 checks, 11 score modules.

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

التثبيت

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

Remote (streamable-http)
Claude Code 
claude mcp add --transport http seo-mcp 'https://mcp.metricspot.com/mcp' --header 'Authorization: <Bearer token from app.metricspot.com/settings/api-keys. Required for 5 of the 6 tools; omit the header to use only run_audit_anonymous.>'
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "seo-mcp": {
            "type": "http",
            "url": "https://mcp.metricspot.com/mcp",
            "headers": {
                "Authorization": "<Bearer token from app.metricspot.com/settings/api-keys. Required for 5 of the 6 tools; omit the header to use only run_audit_anonymous.>"
            }
        }
    }
}
NPM package @metricspot/mcp-server
Claude Code 
claude mcp add seo-mcp -e 'MCP_API_KEY=<your mcp_api_key>' -- npx -y @metricspot/mcp-server@0.1.1
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "seo-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "@metricspot/mcp-server@0.1.1"
            ],
            "env": {
                "MCP_API_KEY": "<your mcp_api_key>"
            }
        }
    }
}

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

  • MCP_API_KEY سري Your MetricSpot API key (ms_live_...) from app.metricspot.com/settings/api-keys. Required for 5 of the 6 tools; omit to use only run_audit_anonymous (1 audit per IP per 24 hours, no auth).

التوثيق

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

المحتويات
  1. @metricspot/mcp-server
  2. Tools
  3. Local install (stdio)
  4. Hosted (Streamable HTTP)
  5. Env vars
  6. Develop
  7. Deploy
  8. License

@metricspot/mcp-server

Model Context Protocol server for MetricSpot. Exposes 6 SEO + AI-readability audit tools to AI agents (Claude, ChatGPT, Gemini, Perplexity, Cursor, Zed, OpenClaw, custom bots).

Tools

ToolAuthDescription
run_audit_anonymousnoneOne-shot audit, 1/IP/24h, no Core Web Vitals
run_auditBearer keyFull audit with PSI, returns audit_id
get_auditBearer keyFetch audit + findings by id
list_auditsBearer keyList the user's recent audits (max 100)
get_audit_pdfBearer keySigned URL for the branded PDF report
get_organic_trafficBearer key28-day GA4 + GSC snapshot (if Google linked)

Local install (stdio)

Claude Code (~/.claude/mcp.json):

{
  "mcpServers": {
    "metricspot": {
      "command": "npx",
      "args": ["-y", "@metricspot/mcp-server"],
      "env": {
        "MCP_API_KEY": "ms_live_xxx"
      }
    }
  }
}

Cursor (~/.cursor/mcp.json) and Zed use the same shape.

Omit MCP_API_KEY to only use run_audit_anonymous.

Hosted (Streamable HTTP)

POST https://mcp.metricspot.com/mcp
Authorization: Bearer ms_live_xxx
Content-Type: application/json

{"jsonrpc":"2.0","id":1,"method":"tools/list"}

Env vars

VarDefaultPurpose
PORT3000HTTP listen port
APP_API_BASE_URLhttps://app.metricspot.comMetricSpot app API base (the dev/dev:stdio scripts override it to http://localhost:3000)
APP_PUBLIC_BASE_URLfalls back to APP_API_BASE_URLUsed to build report_url
MCP_INTERNAL_TOKEN—Service-to-service secret forwarded as X-MCP-Internal-Token
MCP_API_KEY—(stdio only) User API key, sent as Authorization: Bearer to the HTTP layer

Develop

bun install
bun run typecheck
bun test
bun run dev          # Streamable HTTP on :3000
bun run dev:stdio    # stdio loop (send JSON-RPC on stdin)

Deploy

Multi-stage Dockerfile produces a Bun runtime image. Independent Dokku app on the same Hetzner droplet as app/ and web/.

License

MIT

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

ما هو com.metricspot/seo-mcp؟

Six tools for SEO and AI-readability audits. 91 checks, 11 score modules.

كيف أثبّت com.metricspot/seo-mcp؟

يعمل كخادم بعيد. في Claude Code: claude mcp add --transport http seo-mcp 'https://mcp.metricspot.com/mcp' --header 'Authorization: <Bearer token from app.metricspot.com/settings/api-keys. Required for 5 of the 6 tools; omit the header to use only run_audit_anonymous.>'. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج com.metricspot/seo-mcp إلى مفتاح API؟

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

هل com.metricspot/seo-mcp مفتوح المصدر؟

شيفرته علنية على GitHub، لكن المستودع لا يعلن ترخيصًا قياسيًا.

من يصون com.metricspot/seo-mcp؟

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

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