SC-MCP 2026: Claude Lê SEO dos Posts X

8 de Julho, 2026 · 11 min read · Guide

Na primeira semana de julho de 2026, dois anúncios do Google caíram com cinco dias de diferença e, juntos, redesenharam silenciosamente o mapa de SEO para criadores de X e Bluesky. Em 2 de julho, o feed Show HN apresentou o search-console-mcp, um servidor Model Context Protocol open-source que permite ao Claude, Codex e outros agentes compatíveis com MCP puxar dados ao vivo do Google Search Console sem copiar e colar. Cinco dias depois, em 7 de julho, o Google disponibilizou o novo painel de plataformas sociais/vídeo dentro do próprio Search Console, expondo impressões do YouTube, TikTok, LinkedIn e X como um filtro de primeira classe ao lado da busca web tradicional.

Os dois lançamentos não estão relacionados por nenhum post oficial do Google, mas se alinham. O SC-MCP é o caminho de leitura que torna os novos dados sociais/vídeo acionáveis: agora você pode pedir a um agente "quais dos meus threads do X estão recebendo descoberta no estilo TikTok esta semana" e obter uma resposta real sem planilha no loop. Para um criador cujos analytics vivem em cinco dashboards diferentes, esta é a primeira vez que os dados estão num lugar onde uma ferramenta de IA pode agir sobre eles.

O que o Search Console MCP Realmente Faz

O Search Console MCP é um pequeno servidor Python que expõe a API do Google Search Console como um conjunto de ferramentas MCP. Um cliente compatível com MCP (Claude Code, Codex, Cline, Continue, Roo Code) pode chamar essas ferramentas diretamente, sem ginástica de auth no lado do agente e sem exportação manual da UI web do GSC. Da perspectiva do criador, a diferença entre "com SC-MCP" e "sem SC-MCP" é a diferença entre fazer uma pergunta no chat e copiar linhas de um CSV.

O repositório é github.com/sudomichael/search-console-mcp, licenciado MIT, ~600 linhas de Python. Ele implementa os endpoints read-side que a Search Analytics API expõe: queries, pages, devices, countries, dates e search appearance. Não implementa endpoints write-side (sem submissão de sitemaps, sem remoção de URL), e não expõe os novos dados sociais/vídeo diretamente — esses dados vivem atrás de um filtro diferente que o SC-MCP adicionou em 7 de julho, mesmo dia em que o Google disponibilizou o painel.

O que você recebe, de ponta a ponta, é um Google Search Console acessível por chat. Esse é o produto inteiro, e essa é exatamente a camada que estava faltando antes.

Por que a Atualização do GSC de 7 de Julho Muda a Conta

Antes de 7 de julho de 2026, o GSC só mostrava desempenho de busca web. Um criador publicando em X, Bluesky, LinkedIn, YouTube ou TikTok tinha que instrumentar cada plataforma separadamente: X Analytics para X, Bluesky stats para Bluesky, LinkedIn Page analytics para LinkedIn, YouTube Studio para YouTube, TikTok Creator Portal para TikTok. Nenhuma dessas plataformas tinha uma lente unificada de desempenho de busca porque cada uma definia "busca" de forma diferente, e o Google não tinha como ver dados de criadores cross-platform como um corpus único.

A atualização de 7 de julho muda isso. O novo painel de plataformas sociais/vídeo dentro do GSC expõe impressões, cliques, CTR e posição para:

• Busca no YouTube — impressões, cliques e posição média na busca interna do YouTube.
• Busca no TikTok — mesmo formato, com escopo na camada de busca do TikTok.
• Busca no LinkedIn — descoberta de posts e artigos dentro da busca do LinkedIn.
• Busca no X — a busca interna do x.com, incluindo busca de tópicos e pessoas.

Essa é a primeira vez que um criador pode sentar em uma única UI do Google e ver "meu thread do X sobre federação AT Protocol" ao lado de "meu post do LinkedIn sobre o mesmo tópico" com o mesmo formato de métrica. O SC-MCP, que já estava conectado à API do GSC, pega os novos dados sociais/vídeo no dia um. Os dois lançamentos caem juntos porque ambos os lados da stack precisavam do outro para serem úteis.

As 4 Consultas que Valem a Pena Rodar Primeiro

Uma vez que o SC-MCP está conectado ao Claude Code (configuração abaixo), a parte produtiva são as consultas que você roda contra ele. As quatro que produziram o sinal mais acionável na primeira semana de julho de 2026 são estas.

Consulta 1: Impressões Cross-Platform para um Tópico

A consulta SC-MCP mais básica também é a mais poderosa: peça impressões totais em todas as plataformas para um cluster de tópicos nos últimos 28 dias. O SC-MCP retorna o mesmo formato da UI web do GSC, mas faz o join de dimensões automaticamente (web + YouTube + TikTok + LinkedIn + X) sem você precisar clicar em cinco abas.

gsc_query(
  site_url="https://yourdomain.com",
  start_date="2026-06-10",
  end_date="2026-07-08",
  dimensions=["date"],
  filters={"query_contains": "at protocol"}
)

A resposta te dá uma série de impressões agrupadas por data. A partir daí você pode pedir ao Claude para plotar, resumir picos ou correlacionar com uma URL específica de thread do X. Esse último movimento — "agora correlacione isso com meu post do X de 14 de junho" — é o workflow matador porque conecta o lado GSC ao lado plataforma sem nenhuma contabilidade manual.

Consulta 2: Descoberta de Thread do X vs Descoberta Web

A segunda consulta separa impressões de busca no X de impressões de busca web para a mesma query. A razão disso importar: um criador publicando um thread no X e um post de blog no mesmo tópico frequentemente vai ver um deles dominar a busca enquanto o outro fica silencioso. A divisão diz qual plataforma é a superfície de descoberta para um dado tópico e onde investir o próximo post.

gsc_query(
  site_url="https://yourdomain.com",
  start_date="2026-06-10",
  end_date="2026-07-08",
  dimensions=["query", "searchAppearance"],
  filters={"searchAppearance": ["X_SEARCH", "WEB"}]
)

Para um criador que trata X como a camada de broadcast e o blog como o registro durável, essa consulta é a coisa mais próxima de um dashboard de publicação. Você vê as queries que atingem o post do blog, as queries que atingem o thread do X, e pode parar de adivinhar onde o leitor realmente te encontrou.

Consulta 3: Detecção de Drift Entre Plataformas

Detecção de drift é o workflow que transformou o SC-MCP de curiosidade em ferramenta diária. Você pede ao Claude para comparar as impressões sociais/vídeo desta semana com as da semana passada, sinalizar qualquer coisa abaixo de 30 por cento, e propor um thread do X ou post do Bluesky que poderia recuperar o alcance perdido. A consulta tem o mesmo formato da Consulta 1, mas com dois intervalos de datas e um pequeno prompt para Claude fazer a comparação.

last_week = gsc_query(site_url, "2026-07-01", "2026-07-07", dimensions=["date"])
this_week = gsc_query(site_url, "2026-06-24", "2026-06-30", dimensions=["date"])
# Claude compares: which platform, which date, which query dropped the most?
# Claude proposes: one X thread draft, one Bluesky post draft, one LinkedIn update.

Esse é o loop de criador de nível de produção em 2026: uma leitura de 7 dias, um prompt de comparação de uma linha, e três posts de rascunho na saída. Você saiu de cinco dashboards e uma planilha para uma mensagem de chat em 90 segundos.

Consulta 4: Auditoria de Cross-Link Entre X e Blog

A quarta consulta é o movimento de disciplina de SEO: peça ao Claude para enumerar toda URL de post do X que você referenciou em um post de blog nos últimos 90 dias, depois cheque a dimensão de página do GSC para cada uma. Se um post de blog tem um link outbound para um thread do X e o thread tem zero impressões X_SEARCH, você tem um problema de auditoria de cross-link: o link não está puxando seu peso no novo mundo X-search.

# Step 1: list all outbound x.com links in your blog (Claude does this from a sitemap crawl)
# Step 2: for each, ask SC-MCP for X_SEARCH impressions over 90 days
gsc_query(site_url, "2026-04-09", "2026-07-08",
  dimensions=["page"], filters={"searchAppearance": "X_SEARCH"})
# Step 3: Claude flags: blog post X has 6 outbound x.com links, 4 of them have 0 X impressions.
# Step 4: Claude rewrites the link text to be more descriptive so X's indexer classifies the thread better.

A auditoria é o tipo de coisa que um criador nunca faria à mão, e uma agência de marketing cobraria $5.000. Com o SC-MCP é uma sessão de chat de 10 minutos, repetível semanalmente.

A Configuração de 5 Minutos

Conectar o SC-MCP ao Claude Code leva cerca de cinco minutos se você já tem uma propriedade verificada do Google Search Console e um Claude Code funcionando. O formato é o mesmo de qualquer servidor MCP: uma linha de config em ~/.config/claude/mcp_servers.json e uma chave de service account em disco.

Passo 1: Instale o Pacote

Clone ou pip-install o servidor SC-MCP. O caminho recomendado é a release do GitHub, não PyPI, porque o Google atualizou o contrato da API em 7 de julho e a tag de release acompanha os endpoints GSC ao vivo.

git clone https://github.com/sudomichael/search-console-mcp.git
cd search-console-mcp
uv sync
# This pulls the MCP SDK + google-api-python-client + auth libs

Se você não tem o uv instalado, o repo cai para pip install -e . em Python 3.11+. O ambiente completo é ~80 MB.

Passo 2: Service Account + Acesso à Propriedade GSC

O SC-MCP autentica com um service account do Google, não OAuth. Crie um service account no Google Cloud, baixe a chave JSON, e adicione o email do service account como usuário (qualquer papel, "Full" funciona) dentro da propriedade Search Console que você quer consultar. Esse é o mesmo fluxo que qualquer automação GSC usa; nenhum escopo especial é necessário além de webmasters.readonly.

# 1. Service account JSON at: ~/keys/gsc-service-account.json
# 2. In GSC UI: Settings → Users and permissions → Add user
#    Paste the service account email: [email protected]
#    Permission level: Full (read-only is enough for SC-MCP, but Full is harmless)

O fluxo de service account é a diferença entre o SC-MCP e outras ferramentas GSC: não há dança de OAuth no browser, não há refresh de token no meio de uma sessão. O servidor MCP lê a chave em disco e está pronto.

Passo 3: Conecte ao Claude Code

Adicione o servidor SC-MCP ao config MCP do Claude Code. O arquivo de config está em ~/.config/claude/mcp_servers.json no Linux e macOS, e o mesmo caminho sob %APPDATA% no Windows.

{
  "mcpServers": {
    "gsc": {
      "command": "uv",
      "args": ["run", "--directory", "/path/to/search-console-mcp", "python", "-m", "search_console_mcp"],
      "env": {
        "GOOGLE_APPLICATION_CREDENTIALS": "/home/you/keys/gsc-service-account.json",
        "GSC_DEFAULT_SITE": "https://yourdomain.com"
      }
    }
  }
}

Reinicie o Claude Code. Na primeira vez que iniciar uma sessão, digite /mcp e confirme que o servidor GSC está listado e mostra as ferramentas disponíveis. Se você vir gsc_query na lista de ferramentas, a configuração está pronta.

Passo 4: Consulta de Sanidade Inicial

Peça ao Claude para fazer um pull de 7 dias e confirme que os números batem com a UI web do GSC. Esses são os mesmos dados que o dashboard GSC mostra, então a comparação é um teste literal de ponta a ponta da conexão.

Use gsc_query to fetch the last 7 days of search analytics for https://yourdomain.com,
grouped by date. Show me the total impressions and clicks for each day.
Then compare it to what I see in the GSC Performance tab.
They should match exactly.

Se os números batem, a configuração está verificada. Se não, o culpado mais comum é o formato da URL do site: o GSC aceita https://seudominio.com (propriedade de domínio) ou sc-domain:seudominio.com (propriedade de prefixo de URL), e o SC-MCP precisa da string exata com a qual a propriedade foi registrada. A ferramenta gsc_list_sites no README do repo lista toda propriedade que seu service account pode ver; use isso para copiar a URL certa.

Onde o ThreadGrab se Encaixa Nesse Quadro

O ThreadGrab é uma ferramenta de arquivamento social read-side: cole qualquer URL pública do X e você recebe uma página Markdown estável e estruturada que crawlers e agentes de IA podem buscar. O pareamento natural com o SC-MCP é que toda impressão GSC em uma página mirror do threadgrab.com é uma candidata confirmada a citação por IA. Quando você roda a Consulta 1 do SC-MCP (impressões cross-platform para um tópico), as páginas mirror em threadgrab.com vão aparecer na dimensão de página. Isso diz qual dos seus threads arquivados está sendo captado pela camada de citação, e qual ainda depende do x.com diretamente.

Para um criador que já roda o ThreadGrab, o SC-MCP é a resposta read-side que faltava para a pergunta que o ThreadGrab responde no lado write: onde meu conteúdo está realmente sendo descoberto? As duas ferramentas juntas fecham o loop de publicar (X) para mirror (ThreadGrab) para descoberta (GSC) para ação (próximo post rascunhado pelo Claude). Esse é o stack de criador de nível de produção para o segundo semestre de 2026.

Perguntas Frequentes