Conecte o Search Console ao Claude Code com um comando
Claude Code
Para conectar o Search Console ao Claude Code, adicione o PaidSync.ai: rode claude mcp add --transport http paidsync https://mcp.paidsync.ai/mcp, digite /mcp e entre com seu login do PaidSync.
O Claude Code passa então a acessar suas propriedades do Search Console por 6 ferramentas: cliques, impressões, CTR e posição por consulta, página, país e dispositivo, além da cobertura de índice dos sitemaps. O Claude Code pergunta antes de executar cada ferramenta.
Nível Watch. O Search Console é somente leitura no PaidSync, então o Claude Code lê seus dados de busca e não altera nada.
O comando
O Claude Code se comunica com servidores MCP remotos por Streamable HTTP. O PaidSync é um deles. Adicione uma vez e o mesmo terminal que edita seu código também pode gerar relatórios e gerenciar suas campanhas do Search Console.
claude mcp add --transport http paidsync https://mcp.paidsync.ai/mcpPor padrão, isso registra o servidor só para o projeto atual. Adicione --scope user para disponibilizá-lo em todos os projetos da sua máquina.
Execute claude mcp list para confirmar que ele está lá, depois inicie uma sessão e digite /mcp para entrar.
Configuração em 5 passos
1Cadastre-se em paidsync.ai/signup
Leva 10 segundos. Login com Google ou e-mail. O plano gratuito tem 100 tarefas por mês, no valor de $50, por $0, sem cartão.
2Conecte o Search Console no painel do PaidSync
Clique em Conectar no Search Console e entre com a conta do Google que tem acesso às suas propriedades. O Search Console autoriza via Google OAuth, e o PaidSync nunca vê sua senha do Google.
Já está dentro do Claude Code? Peça para ele executar connect_google_search_console. A ferramenta retorna um link para abrir no navegador.
3Escolha a conta de anúncios em que o Claude Code deve trabalhar
Dentro de uma sessão, list_gsc_properties mostra todas as propriedades que seu login do Google consegue abrir. Informe a propriedade no seu prompt.
4Adicione o PaidSync ao Claude Code
No seu terminal, rode:
claude mcp add --transport http paidsync https://mcp.paidsync.ai/mcpInicie uma sessão, digite /mcp, escolha paidsync e entre com o seu login do PaidSync na janela do navegador que abrir. O Claude Code guarda o token OAuth para você. Nenhuma chave é colada em lugar nenhum.
Configurando para uma equipe? Faça commit de um .mcp.json na raiz do repositório para que todo engenheiro receba o mesmo conector:
{
"mcpServers": {
"paidsync": { "type": "http", "url": "https://mcp.paidsync.ai/mcp" }
}
}Prefere uma chave de API, por exemplo para execuções sem interface? Envie-a em um cabeçalho, nunca na URL, onde ela iria parar nos logs:
claude mcp add --transport http paidsync https://mcp.paidsync.ai/mcp --header "Authorization: Bearer $PAIDSYNC_API_KEY"Em um .mcp.json commitado, adicione "headers": { "Authorization": "Bearer ${PAIDSYNC_API_KEY}" } para que a chave fique no ambiente de cada engenheiro e nunca entre no git. Aplicar uma alteração no Google Ads ainda exige o login OAuth. Em outras plataformas, uma chave também pode aplicar alterações, então trate-a como uma senha e prefira OAuth.
5Teste a conexão
Em uma sessão do Claude Code, peça: “Quais são minhas 20 principais consultas orgânicas por cliques neste mês, com a posição média de cada uma”
O Claude Code retorna cliques, impressões, CTR e posição média de cada consulta. A conexão está ativa.
O plano gratuito inclui 100 tarefas por mês. Pro a partir de $99 por mês, Team a partir de $249.
Prompts de Search Console no Claude Code
Cada prompt abaixo corresponde a ferramentas do grupo Search Console do PaidSync. O Claude Code escolhe a ferramenta. A última coluna indica se a chamada pode alterar algo na conta de anúncios.
| Pedido | Ferramentas que chama | Altera sua conta? |
|---|---|---|
| “Liste minhas propriedades do Search Console” | list_gsc_properties | Não |
| “Quais são minhas 20 principais consultas orgânicas por cliques neste mês” | get_gsc_search_analytics | Não |
| “Quais páginas têm muitas impressões, mas uma taxa de cliques baixa” | get_gsc_search_analytics | Não |
| “Quantas das URLs dos meus sitemaps estão indexadas” | get_gsc_index_coverage | Não |
| “Compare meu desempenho orgânico neste mês com o mesmo mês do ano passado” | get_gsc_search_analytics | Não |
| “Por quais palavras-chave do Google Ads estou pagando mesmo já ranqueando entre os cinco primeiros” | analyze_paid_organic_overlap | Não |
| “Detalhe meus cliques e impressões orgânicos por país nos últimos 90 dias” | get_gsc_search_analytics | Não |
Execute em modo headless com claude -p
A flag -p executa o Claude Code sem a sessão interativa. Entre uma vez por /mcp e o token OAuth guardado continua valendo. Um relatório que cai em um arquivo fica assim:
claude -p "Pull last 28 days Search Console top queries by clicks and list the pages with high impressions and low CTR." \
--allowedTools "mcp__paidsync" \
--output-format json > reports/search-console-$(date +%F).jsonAs leituras rodam direto, e as escritas também. --allowedTools "mcp__paidsync" permite todas as ferramentas do PaidSync, escritas incluídas, sem prompt.
Em uma tarefa sem supervisão, permita só as ferramentas de leitura de que ela precisa, cada uma pelo nome como mcp__paidsync__tool_name.
O que lê e o que grava
O Search Console é somente leitura no PaidSync: nenhuma das 6 ferramentas de Search Console pode gravar.
Elas cobrem a listagem de propriedades, a análise de busca por consulta, página, país e dispositivo e a cobertura de índice dos sitemaps. O Search Console guarda 16 meses de dados.
Ler mais
Via MCP, a etapa de aprovação é o próprio prompt do Claude Code. Ele pergunta antes de executar uma ferramenta, a menos que você a tenha permitido com --allowedTools ou nas suas configurações. O PaidSync acrescenta verificações do seu lado. Exclusões, pausas e alterações de orçamento exigem confirm_destructive, e uma verificação de regras antes da gravação bloqueia argumentos inseguros. O cartão de aprovação, e o Undo em um cartão aplicado cuja alteração tem inverso seguro, valem apenas no workspace do PaidSync.
Adicionar ao ChatGPT: abra o PaidSync.ai no diretório de plugins do ChatGPT, instale e faça login.
Adicionar ao Claude: abra o PaidSync.ai no diretório de conectores do Claude, clique em Conectar e faça login.
O que o Claude Code não faz no Search Console
- O PaidSync nunca altera sua propriedade. A API do próprio Google também pode enviar sitemaps e adicionar sites; o PaidSync não faz isso.
- O PaidSync não lê o relatório de indexação de páginas nem a Inspeção de URL.
- A análise de busca retorna um detalhamento por solicitação, por exemplo por país ou por dispositivo.
- A cobertura de índice dos sitemaps compara o número de páginas enviadas com o de indexadas em cada sitemap.
- As comparações entre pago e orgânico exigem que o Google Ads também esteja conectado.
Perguntas frequentes
Como conectar o Search Console ao Claude Code?
Cadastre-se em paidsync.ai, conecte o Search Console no painel e depois execute claude mcp add --transport http paidsync https://mcp.paidsync.ai/mcp no seu terminal. Digite /mcp dentro de uma sessão, escolha paidsync e entre com seu login do PaidSync.
O Claude Code pode alterar minha propriedade do Search Console?
Não. O Search Console é somente leitura no PaidSync. O Claude Code lê seus dados de busca e nunca altera sua propriedade.
O Claude Code pode comparar o Search Console com o Google Ads?
Sim. Com o Google Ads também conectado, analyze_paid_organic_overlap estima o gasto mensal em palavras-chave nas quais você já ranqueia entre os cinco primeiros, e o Claude Code pode comparar as principais consultas orgânicas com suas palavras-chave pagas.
Funciona em modo headless com claude -p?
Sim. Depois de entrar por /mcp, o claude -p reutiliza o token OAuth guardado. As leituras rodam direto. As escritas exigem cuidado. Ninguém está lá para responder ao prompt do Claude Code, então qualquer ferramenta de escrita que você permitiu com --allowedTools roda direto. Em uma tarefa sem supervisão, permita só as ferramentas de leitura de que ela precisa.
É grátis?
Sim. O plano gratuito custa $0 para 100 tarefas por mês, sem cartão. O Pro começa em $99 por mês e o Team em $249 por mês.
Relatórios do Search Console. Um comando no Claude Code.