Launching the seo-performance MCP

DEV Community

posts.verdict: Run the rule-based verdict engine on one URL. Returns verdict, reason codes, and confidence.

posts.refresh_brief: Produce a markdown brief for a human or downstream LLM editor: verdict, reasons, raw numbers, top queries, suggested actions.

posts.cite_loss: Return the list of LLMs that previously cited this URL but no longer do, with the prior query and last-seen date. Optionally identifies the URL that replaced yours.

cohort.report: Run the verdict engine across a cohort filtered by tag and minimum age. Returns a ranked table sorted by verdict priority then confidence. Answers "which three posts should I refresh this week?"

gsc.quick_wins: Scan GSC for (page, query) pairs at positions 5 to 15 with non-trivial impressions and a CTR below the position-expected curve. The fastest title-rewrite wins. Platform-agnostic pure GSC pull.

Three discoverable prompts ship alongside: audit_cohort, find_quick_wins, citation_loss_sweep. No skill loader required; any MCP-capable client picks them up.

Install

Requires Node 20+. Add the server to your MCP host config (~/.cursor/mcp.json for Cursor, claude_desktop_config.json for Claude Desktop, .mcp.json for Claude Code), then restart the host.


json
{
 "mcpServers": {
 "seo-performance": {
 "command": "npx",
 "args": ["-y", "@automatelab/seo-performance-mcp"],
 "env": {
 "GSC_SERVICE_ACCOUNT_JSON": "/abs/path/to/gsc-service-account.json",
 "GSC_SITE_URL": "sc-domain:example.com",
 "MATOMO_BASE_URL": "https://example.com/analytics",
 "MATOMO_TOKEN": "...",
 "MATOMO_SITE_ID": "1",
 "GA4_PROPERTY_ID": "123456789",
 "CLARITY_PROJECT_ID": "...",
 "GHOST_ADMIN_KEY": "id:secret"
 }
 }
 }
}