GSC PAP — Google Search Console para Claude
aliarifsoydas/gsc-pap-claude-plugin
30 ferramentas SEO: GSC + GA4 + PageSpeed em um MCP hosted plug & play
Ver no GitHubMCP server que expõe 30 ferramentas de SEO integrando Google Search Console, Google Analytics 4 e PageSpeed Insights. Identifica oportunidades rápidas de otimização, rastreia decay de conteúdo, diagnostica problemas de indexação e correlaciona dados de busca com conversões — sem necessidade de projeto GCP ou configuração complexa.
Instalação
npx convez-ai aliarifsoydas/gsc-pap-claude-plugin1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Identificar páginas em posição 11-20 com alto potencial de otimização (quick wins)
- Detectar canibalização de conteúdo e decay de tráfego orgânico
- Auditar performance e Core Web Vitals com Lighthouse
- Correlacionar cliques do Search Console com conversões e receita do GA4
- Acessar histórico completo de dados GSC além do limite de 16 meses
Veredito

MCP robusto e bem arquitetado que democratiza análise SEO avançada dentro do Claude, eliminando fricção de integração com GCP. Particulamente valioso pela correlação GSC↔GA4 e arquivo histórico além de 16 meses — caso de uso real que resolve dor legítima de profissionais.
README
A tradução para o português deste README ainda está na fila.
GSC PAP — Google Search Console for Claude Code
Ask 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.
What it adds
A single MCP server (gsc-pap) exposing 30 tools over the Google Search Console + Google Analytics 4 + PageSpeed Insights APIs:
Spot quick SEO wins
find_quick_wins— pages ranking positions 11–20 with high impressions (best ROI for optimization)find_cannibalization— multiple pages competing for the same query, splitting CTR
Find what's losing traffic
find_content_decay— pages losing organic traffic over timehistorical_position_trend— long-term position trajectory for a query/pagecompare_periods— diff any two windows (e.g. last 28 days vs prior 28)
Beat the 16-month limit
search_analytics_archive— query your full GSC history beyond Google's 16-month retentionarchive_status— per-site archive coverage (earliest/latest date, row count, last run)
Diagnose performance & Core Web Vitals (new in v0.3)
pagespeed_insights— Lighthouse audit: Performance / Accessibility / Best Practices / SEO scores + CWV + top opportunitiespagespeed_field_data— real-user CrUX metrics (LCP / INP / CLS p75) for URL and origin level
Diagnose indexing issues
get_index_coverage_summary— account-wide breakdown of indexing statesinspect_url— single-URL deep dive (URL Inspection API result)batch_inspect_urls— bulk URL Inspection up to 2,000 URLs
Pull performance data
get_performance_overview— clicks, impressions, CTR, position snapshotsearch_analytics_query— full Search Analytics API surface (any dimension + filter)get_search_by_page_query— drill into a page's query mix
Connect search to engagement & revenue (GA4) (new in v0.4)
list_ga4_properties— discover the GA4 property_id needed for the other GA4 toolsga4_overview— users / sessions / page views / bounce / engagement, with daily breakdownga4_top_pages— top landing pages by sessionsga4_traffic_sources— by channel / source / medium / campaignga4_realtime— last 30 minutes active usersga4_conversions_by_source— source × medium with conversions + revenuega4_user_demographics— country, device, browser slicesga4_engagement— per-page engagement rate, duration, bouncega4_compare_periods— diff any window for any GA4 metric (WoW, MoM)correlate_gsc_to_ga4— KILLER cross-tool: GSC clicks per page joined to GA4 sessions, conversions, revenue per page
Manage sites & sitemaps
list_sites,get_site_details— verified property managementlist_sitemaps,get_sitemap_details— sitemap healthdetect_duplicate_properties— find domain/URL property duplicates that split your reporting
Use it in chat:
Show me my 5 worst-decaying pages last 30 days, with the queries they used to rank for.
Which pages are stuck at position 11–20 with 1k+ impressions? Suggest content tweaks for the top 3.
Run a Lighthouse audit on https://example.com/pricing and list the top 3 opportunities by potential ms savings.
Pull my GSC data from January 2024 — that's beyond Google's 16-month retention.
Correlate my Search Console pages with GA4 conversions for the last 28 days — which top-clicked pages bring zero conversions?
Install
Easiest: let Claude install itself (~30 seconds)
- Open https://gscpap.com → Sign in with Google (read-only Search Console scope)
- Pick which sites to grant access to (per-site allowlist on top of the OAuth scope)
- On https://app.gscpap.com/account/tokens, hit + New token, then in the install widget click "Copy install prompt" under the Claude Code tab
- Paste that prompt into any Claude Code session — Claude runs the install command itself, verifies, and lists your sites so you know it works
Manual install
If you prefer to drive the CLI yourself:
claude mcp add --transport http --scope user gsc-pap https://mcp.gscpap.com/mcp \
--header "Authorization: Bearer YOUR_TOKEN_HERE"
Or via the marketplace once approved:
claude /plugin install gsc-pap
This plugin variant uses a ${GSC_PAP_TOKEN} env var. Set it once:
# macOS / Linux
echo 'export GSC_PAP_TOKEN="paste-your-token-here"' >> ~/.zshrc
source ~/.zshrc
# Windows (PowerShell, persistent)
[Environment]::SetEnvironmentVariable("GSC_PAP_TOKEN", "paste-your-token-here", "User")
Restart Claude Code (or run claude mcp list to verify) and the gsc-pap server will appear as Connected.
How it works
- Hosted bridge:
mcp.gscpap.comexposes a streamable-HTTP MCP endpoint. We do the OAuth dance with Google on your behalf and store an encrypted refresh token. - 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. - 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.
- 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.
- Audit log: every tool call is logged in your account at https://app.gscpap.com/account.
- Read-only: nothing in the API can modify your sites, sitemaps, or settings. Search Console data only.
Privacy & data
- Your refresh token is encrypted at rest with AES-256-GCM
- Aggregate analytics via Google Analytics 4 with IP anonymisation; no marketing pixels, no third-party ad networks. See Privacy Policy
- Revoke any time at https://app.gscpap.com/account/tokens or directly via Google account permissions
Pricing
Free during beta. See gscpap.com/faq for limits.