io.github.AutomateLab-tech/seo-performance-mcp

Official

by AutomateLab-tech · TypeScript

SEO Performance MCP

Per-URL SEO verdicts from GSC, GA4, Matomo, Clarity, AI citations: refresh/expand/merge/kill.

Analyze per-URL SEO performance from GSC, GA4, Matomo and Clarity with AI citation insights.

Topics

aeoai-citationclarityga4geogoogle-search-consolegscmatomomcpmodel-context-protocolseotypescript

Install

Configuration

Environment variables

GSC_SERVICE_ACCOUNT_JSONsecret

Base64-encoded Google service account JSON with Search Console read access.

GSC_SITE_URL

Search Console site URL (e.g. sc-domain:example.com or https://example.com/).

MATOMO_URL

Matomo instance URL (e.g. https://example.com/analytics).

MATOMO_TOKENsecret

Matomo auth token with view access.

MATOMO_SITE_ID

Matomo idSite for the site to query.

GA4_PROPERTY_ID

GA4 property ID (numeric, no G- prefix).

GA4_SERVICE_ACCOUNT_JSONsecret

Base64-encoded Google service account JSON with GA4 Data API access.

CLARITY_PROJECT_ID

Microsoft Clarity project ID.

CLARITY_API_TOKENsecret

Microsoft Clarity Data Export API token.

POSTS_SITEMAP_URL

XML sitemap URL used to enumerate posts. Primary platform-agnostic discovery path.

POSTS_LIST

Optional JSON array overriding sitemap discovery.

GHOST_ADMIN_API_URL

Optional. Ghost Admin API base URL. Pair with GHOST_ADMIN_API_KEY for richer metadata.

GHOST_ADMIN_API_KEYsecret

Optional. Ghost Admin API key in the form id:secret.

CITATION_INTELLIGENCE_URL

Optional URL of a citation-intelligence MCP server to delegate AI-citation queries to.

claude_desktop_config.json

{
  "mcpServers": {
    "seo-performance-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@automatelab/seo-performance-mcp@1.0.0"
      ],
      "env": {
        "GSC_SERVICE_ACCOUNT_JSON": "<YOUR_GSC_SERVICE_ACCOUNT_JSON>",
        "GSC_SITE_URL": "<YOUR_GSC_SITE_URL>",
        "MATOMO_URL": "<YOUR_MATOMO_URL>",
        "MATOMO_TOKEN": "<YOUR_MATOMO_TOKEN>",
        "MATOMO_SITE_ID": "<YOUR_MATOMO_SITE_ID>",
        "GA4_PROPERTY_ID": "<YOUR_GA4_PROPERTY_ID>",
        "GA4_SERVICE_ACCOUNT_JSON": "<YOUR_GA4_SERVICE_ACCOUNT_JSON>",
        "CLARITY_PROJECT_ID": "<YOUR_CLARITY_PROJECT_ID>",
        "CLARITY_API_TOKEN": "<YOUR_CLARITY_API_TOKEN>",
        "POSTS_SITEMAP_URL": "<YOUR_POSTS_SITEMAP_URL>",
        "POSTS_LIST": "<YOUR_POSTS_LIST>",
        "GHOST_ADMIN_API_URL": "<YOUR_GHOST_ADMIN_API_URL>",
        "GHOST_ADMIN_API_KEY": "<YOUR_GHOST_ADMIN_API_KEY>",
        "CITATION_INTELLIGENCE_URL": "<YOUR_CITATION_INTELLIGENCE_URL>"
      }
    }
  }
}