{
  "markdown": "# GSC PAP — Google Search Console for Claude Code\n\nAsk Claude about your Google Search Console data — top queries, decaying pages, ranking trends, quick wins, content cannibalization. **Plug & play hosted MCP, no GCP project, no Python, no JSON files to manage.**\n\n## What it adds\n\nA single MCP server (`gsc-pap`) exposing 30 tools over the Google Search Console + Google Analytics 4 + PageSpeed Insights APIs:\n\n**Spot quick SEO wins**\n- `find_quick_wins` — pages ranking positions 11–20 with high impressions (best ROI for optimization)\n- `find_cannibalization` — multiple pages competing for the same query, splitting CTR\n\n**Find what's losing traffic**\n- `find_content_decay` — pages losing organic traffic over time\n- `historical_position_trend` — long-term position trajectory for a query/page\n- `compare_periods` — diff any two windows (e.g. last 28 days vs prior 28)\n\n**Beat the 16-month limit**\n- `search_analytics_archive` — query your full GSC history beyond Google's 16-month retention\n- `archive_status` — per-site archive coverage (earliest/latest date, row count, last run)\n\n**Diagnose performance & Core Web Vitals** *(new in v0.3)*\n- `pagespeed_insights` — Lighthouse audit: Performance / Accessibility / Best Practices / SEO scores + CWV + top opportunities\n- `pagespeed_field_data` — real-user CrUX metrics (LCP / INP / CLS p75) for URL and origin level\n\n**Diagnose indexing issues**\n- `get_index_coverage_summary` — account-wide breakdown of indexing states\n- `inspect_url` — single-URL deep dive (URL Inspection API result)\n- `batch_inspect_urls` — bulk URL Inspection up to 2,000 URLs\n\n**Pull performance data**\n- `get_performance_overview` — clicks, impressions, CTR, position snapshot\n- `search_analytics_query` — full Search Analytics API surface (any dimension + filter)\n- `get_search_by_page_query` — drill into a page's query mix\n\n**Connect search to engagement & revenue (GA4)** *(new in v0.4)*\n- `list_ga4_properties` — discover the GA4 property_id needed for the other GA4 tools\n- `ga4_overview` — users / sessions / page views / bounce / engagement, with daily breakdown\n- `ga4_top_pages` — top landing pages by sessions\n- `ga4_traffic_sources` — by channel / source / medium / campaign\n- `ga4_realtime` — last 30 minutes active users\n- `ga4_conversions_by_source` — source × medium with conversions + revenue\n- `ga4_user_demographics` — country, device, browser slices\n- `ga4_engagement` — per-page engagement rate, duration, bounce\n- `ga4_compare_periods` — diff any window for any GA4 metric (WoW, MoM)\n- `correlate_gsc_to_ga4` — KILLER cross-tool: GSC clicks per page joined to GA4 sessions, conversions, revenue per page\n\n**Manage sites & sitemaps**\n- `list_sites`, `get_site_details` — verified property management\n- `list_sitemaps`, `get_sitemap_details` — sitemap health\n- `detect_duplicate_properties` — find domain/URL property duplicates that split your reporting\n\nUse it in chat:\n\n> Show me my 5 worst-decaying pages last 30 days, with the queries they used to rank for.\n\n> Which pages are stuck at position 11–20 with 1k+ impressions? Suggest content tweaks for the top 3.\n\n> Run a Lighthouse audit on https://example.com/pricing and list the top 3 opportunities by potential ms savings.\n\n> Pull my GSC data from January 2024 — that's beyond Google's 16-month retention.\n\n> Correlate my Search Console pages with GA4 conversions for the last 28 days — which top-clicked pages bring zero conversions?\n\n## Install\n\n### Easiest: let Claude install itself (~30 seconds)\n\n1. Open https://gscpap.com → **Sign in with Google** (read-only Search Console scope)\n2. Pick which sites to grant access to (per-site allowlist on top of the OAuth scope)\n3. On **https://app.gscpap.com/account/tokens**, hit **+ New token**, then in the install widget click **\"Copy install prompt\"** under the Claude Code tab\n4. Paste that prompt into any Claude Code session — Claude runs the install command itself, verifies, and lists your sites so you know it works\n\n### Manual install\n\nIf you prefer to drive the CLI yourself:\n\n```bash\nclaude mcp add --transport http --scope user gsc-pap https://mcp.gscpap.com/mcp \\\n  --header \"Authorization: Bearer YOUR_TOKEN_HERE\"\n```\n\nOr via the marketplace once approved:\n\n```bash\nclaude /plugin install gsc-pap\n```\n\nThis plugin variant uses a `${GSC_PAP_TOKEN}` env var. Set it once:\n\n```bash\n# macOS / Linux\necho 'export GSC_PAP_TOKEN=\"paste-your-token-here\"' >> ~/.zshrc\nsource ~/.zshrc\n\n# Windows (PowerShell, persistent)\n[Environment]::SetEnvironmentVariable(\"GSC_PAP_TOKEN\", \"paste-your-token-here\", \"User\")\n```\n\nRestart Claude Code (or run `claude mcp list` to verify) and the `gsc-pap` server will appear as Connected.\n\n## How it works\n\n- **Hosted bridge**: `mcp.gscpap.com` exposes a streamable-HTTP MCP endpoint. We do the OAuth dance with Google on your behalf and store an encrypted refresh token.\n- **Per-site allowlist**: even though Google's OAuth scope is account-wide (`webmasters.readonly`), our server enforces a per-user, per-site authorization layer on top — you decide which properties Claude can see.\n- **Per-token site scope (v0.2)**: each token can be further narrowed to a subset of your authorized sites via **https://app.gscpap.com/account/tokens** → **Edit access**. Useful for per-client tokens, scoped CI tokens, or limiting blast radius if a token leaks.\n- **Per-token rate limit (v0.2)**: 30 requests/minute and 500/hour per token. The account-level cap is 60/min and 1000/hour aggregate. Live usage shown on **https://app.gscpap.com/account**.\n- **Audit log**: every tool call is logged in your account at https://app.gscpap.com/account.\n- **Read-only**: nothing in the API can modify your sites, sitemaps, or settings. Search Console data only.\n\n## Privacy & data\n\n- Your refresh token is encrypted at rest with AES-256-GCM\n- Aggregate analytics via Google Analytics 4 with IP anonymisation; no marketing pixels, no third-party ad networks. See [Privacy Policy](https://gscpap.com/privacy)\n- Revoke any time at https://app.gscpap.com/account/tokens or directly via Google account permissions\n\n## Pricing\n\nFree during beta. See [gscpap.com/faq](https://gscpap.com/faq) for limits.\n\n## Support\n\n- Docs: https://gscpap.com/guides\n- FAQ: https://gscpap.com/faq\n- Issues: https://github.com/aliarifsoydas/gsc-pap-claude-plugin/issues\n",
  "bytes": 6321,
  "sha": "418c6f23404b05daeab48059a8194138caa2b593ea19c9041cc913a59b7884f2",
  "repo_slug": "aliarifsoydas/gsc-pap-claude-plugin",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_aliarifsoydas_gsc_pap_claude_plugin_gsc__47436408/readme"
}