Como conectar um agente de IA ao Google Search Console: 6 jeitos

Existem seis jeitos práticos de dar a um agente de IA acesso aos dados do Google Search Console: um conector OAuth hospedado, um servidor MCP da comunidade, a API do Search Console direto, a exportação em massa para o BigQuery, uma ponte via planilha ou a própria configuração com IA que já vem no Search Console, sem agente nenhum. Eles levam de dois minutos a quase um dia inteiro, e a escolha certa depende de uma pergunta: você precisa de histórico além de 16 meses?

Essa pergunta é a bifurcação do caminho, então vamos começar por ela. A API Search Analytics devolve no máximo 25.000 linhas por requisição e guarda 16 meses de histórico. Depois de 16 meses, os dados somem: não ficam escondidos, são apagados. Se você precisa de um histórico mais longo, só um método desta lista resolve, e ele precisa estar rodando antes de você precisar dele.

Método 1: um conector OAuth hospedado

Configuração: de 2 a 5 minutos. Sem código.

Você autoriza um produto de agente de SEO na sua conta Google, escolhe a propriedade e pronto: a conexão fica salva no servidor e é reutilizada em toda consulta. É o que a maioria dos profissionais de marketing deveria usar, e não por preguiça. O motivo é que os pontos de falha já vêm resolvidos. Um conector bem feito percebe quando não há conexão e pede para você conectar em vez de chutar, descobre qual propriedade usar quando você tem várias e pagina além do limite de 25.000 linhas sem você nem pensar nisso.

Na nossa implementação, a ferramenta do Search Console é marcada como somente leitura, verifica se existe uma conexão ativa na primeira chamada e, se não houver, mostra um convite interativo para conectar, com link direto para a tela de integrações. Quando você volta, a conversa continua de onde parou.

O porém: você fica com o catálogo de ferramentas que o fornecedor criou. Se quiser um formato de consulta que ele não implementou, não tem como.

Método 2: um servidor MCP para o Search Console

Configuração: de 15 a 45 minutos. Exige alguma familiaridade com desenvolvimento.

O Model Context Protocol é um padrão aberto cliente/servidor para conectar assistentes de IA a sistemas externos. Na prática, qualquer cliente compatível com MCP (Claude Desktop, Claude Code, Cursor e outros) consegue chamar um servidor do Search Console diretamente.

O alerta importante: diferente do GA4, para o qual o Google publica o próprio servidor MCP, não existe servidor MCP oficial do Google para o Search Console. O que existe é um bom conjunto de implementações da comunidade, como o mcp-server-gsc, que puxa dados de search analytics até o limite de 25.000 linhas, com filtro por regex, e é somente leitura.

A configuração é um bloco JSON no seu cliente MCP apontando para o servidor com as suas credenciais:

{
  "mcpServers": {
    "search-console": {
      "command": "npx",
      "args": ["-y", "mcp-server-gsc"],
      "env": { "GOOGLE_APPLICATION_CREDENTIALS": "/path/to/service-account.json" }
    }
  }
}

O porém: você está confiando a um pacote da comunidade as credenciais dos seus dados de busca. Leia o código-fonte, prefira escopos somente leitura e fixe a versão. Vale também conferir se a versão do protocolo que o servidor implementa bate com a que o seu cliente espera.

Método 3: a API do Search Console com uma conta de serviço

Configuração: de 1 a 3 horas. Aqui você escreve código.

É o método com mais controle e também o que dá mais trabalho. O passo a passo:

1. Crie um projeto no Google Cloud ou reaproveite um que já exista.
2. Ative a API do Search Console nesse projeto.
3. Crie uma conta de serviço e baixe a chave JSON.
4. Adicione o e-mail da conta de serviço como usuário na própria propriedade do Search Console, com permissão Restrita (somente leitura).
5. Autentique o seu agente com a chave e chame searchanalytics.query.

O passo 4 é o que todo mundo esquece. Criar uma credencial no Cloud não dá acesso a nenhuma propriedade: são dois sistemas de permissão separados, e pular o segundo gera um 403 genérico que parece problema de ativação da API, quando na verdade é falta de acesso à propriedade. Conte com perder uns vinte minutos com isso pelo menos uma vez.

Um corpo de consulta mínimo, já com paginação, fica assim:

{
  "startDate": "2026-04-01",
  "endDate":   "2026-06-30",
  "dimensions": ["query", "page"],
  "rowLimit":  25000,
  "startRow":  0
}

Aumente o startRow em 25.000 a cada página e pare quando a resposta trouxer menos linhas do que você pediu. Todo o resto (controle de cota, novas tentativas, renovação de token) passa a ser trabalho seu.

O porém: flexibilidade total, mas agora o controle de cota, a paginação, as novas tentativas e a renovação de token são responsabilidade sua. Escolha este caminho quando o agente precisar de um formato de consulta que nenhum conector oferece, ou quando os dados tiverem de ficar dentro da sua própria infraestrutura.

Método 4: exportação em massa para o BigQuery

Configuração: cerca de uma hora, mais até 48 horas até a primeira exportação chegar.

É o único método que resolve o problema dos 16 meses, e é o que você deveria configurar hoje mesmo, ainda que não precise dele agora. O motivo: ele acumula histórico daqui para frente, não para trás.

Segundo a documentação de exportação de dados em massa do Google, a sequência é esta:

1. Crie ou escolha um projeto no Google Cloud com faturamento ativado. Isso não é opcional.
2. Ative a API do BigQuery e a API BigQuery Storage nesse projeto.
3. Dê à conta de serviço do Search Console dois papéis no projeto: BigQuery Job User e BigQuery Data Editor.
4. No Search Console, abra Configurações, depois Exportação de dados em massa, e informe o ID do projeto no Cloud e a localização do conjunto de dados.
5. Espere. A primeira exportação chega em até 48 horas, e depois disso as exportações rodam todo dia.

Dois detalhes que vale saber antes de se comprometer. As consultas anonimizadas ficam de fora da exportação por questões de privacidade, então os totais do BigQuery não vão bater exatamente com a interface do Search Console. Isso é esperado, não é bug, mas um agente que compare os dois vai apontar uma divergência que não existe se ninguém avisar. E a localização do conjunto de dados não pode ser alterada depois sem começar do zero, então escolha com calma.

Com os dados no BigQuery, o seu agente consulta em SQL em vez de usar a API do Search Console, e isso elimina de uma vez o limite de linhas e a janela de retenção. Para sites pequenos, os custos ficam dentro do nível gratuito do BigQuery; para sites grandes, eles passam a pesar. Por isso, oriente o agente a filtrar pela coluna de data da partição em vez de varrer a tabela inteira: um agente que solta um SELECT * sem limite em três anos de dados de uma propriedade grande vai gerar uma fatura difícil de esquecer.

O porém: custa dinheiro, é a opção que mais exige infraestrutura e não entrega nada no primeiro dia. Mas também é o único caminho para análises de vários anos.

Método 5: uma ponte via planilha

Configuração: de 10 a 20 minutos. Sem código.

Exporte os dados do Search Console para o Google Sheets de forma agendada, com um complemento ou com Apps Script, e aponte para a planilha um agente que tenha acesso ao Sheets. É a saída pragmática quando o seu agente já lê planilhas e você quer os dados na frente dele ainda hoje à tarde.

O porém: os dados só são tão atuais quanto a última exportação, tudo vem pré-filtrado por quem montou a planilha, e o agente não consegue fazer uma consulta de acompanhamento que ninguém previu. E essa é justamente a capacidade pela qual você contratou um agente. Trate como um quebra-galho.

Método 6: sem conexão nenhuma

Configuração: nenhuma.

O Search Console já tem IA embutida. A configuração com IA do Google permite descrever em linguagem natural a análise que você quer e transforma o pedido em filtros de relatório, comparações e seleção de métricas. Algo como “compare o tráfego das minhas páginas que contêm /blog neste trimestre com o mesmo trimestre do ano passado” se configura sozinho.

Conheça os limites, que o próprio Google deixa claros: funciona só nos relatórios de Desempenho dos resultados da Pesquisa, não no Discover nem no News; configura filtros, comparações e métricas, mas não ordena tabelas nem exporta dados; e o Google avisa que a IA pode interpretar mal um pedido, então confira os filtros aplicados antes de confiar na análise. Além disso, ela só configura: não cruza GA4 com Search Console nem investiga a causa de nada.

À parte disso, o Search Console agora tem relatórios de desempenho de IA generativa para o tráfego vindo das superfícies de IA do Google. Se a sua dúvida é sobre visibilidade nessas superfícies, essa é a fonte oficial, e nenhuma estimativa de terceiros substitui esses dados.

Qual método escolher

Método	Configuração	Supera 16 meses	Ideal para
Conector hospedado	2-5 min	Não	Profissionais de marketing que querem respostas hoje
Servidor MCP	15-45 min	Não	Desenvolvedores que já usam um cliente MCP
API direta	1-3 h	Não	Formatos de consulta sob medida, dados dentro de casa
Exportação para o BigQuery	1 h + 48 h	Sim	Análises de vários anos, sites grandes
Ponte via planilha	10-20 min	Não	Solução temporária
Configuração com IA nativa	Nenhuma	Não	Montar relatórios mais rápido, não investigar

A combinação em que a maioria das equipes acaba chegando é um conector hospedado para as perguntas do dia a dia mais uma exportação para o BigQuery rodando quietinha em segundo plano, para que daqui a um ano elas tenham um histórico que mais ninguém tem. Uma coisa não compete com a outra.

É seguro dar a um agente acesso ao Search Console?

Razoavelmente, desde que você cumpra três condições. Libere só leitura. As permissões do Search Console incluem enviar sitemaps e pedir remoções, e um agente não precisa de nada disso. Prefira uma conta de serviço com escopo limitado a uma autorização OAuth pessoal, para que revogar o acesso não dependa da conta de um funcionário. E mantenha as ferramentas de escrita separadas das ferramentas que buscam conteúdo na web: um agente que lê a página de um concorrente coloca um texto escrito por terceiros na mesma janela de contexto das suas instruções, e se essa página trouxer comandos injetados, um agente ingênuo pode executá-los. O nosso runtime isola o conteúdo buscado como não confiável, marca aquele turno como contaminado e recusa qualquer ferramenta marcada como de escrita até o fim dele, a menos que uma pessoa aprove. As consultas ao Search Console são marcadas como de leitura, então são seguras de qualquer jeito.

Erros comuns de configuração e o que eles realmente significam

Sintoma	Causa mais comum	Solução
403 em toda consulta, mesmo com a API ativada	A conta de serviço nunca foi adicionada como usuário na propriedade	Adicione o e-mail dela nas configurações da propriedade no Search Console, com permissão Restrita
Resultado vazio, sem nenhum erro	URL da propriedade não confere: propriedade de domínio versus propriedade com prefixo de URL, ou falta a barra no final	Copie o identificador da propriedade exatamente como o Search Console mostra
O agente mostra totais redondos demais	Resultado cortado no limite de 25.000 linhas e tratado como completo	Pagine com startRow ou exija que o agente sinalize o corte
Os números não batem com a interface do Search Console	Consultas anonimizadas excluídas da exportação para o BigQuery, ou um recorte de datas diferente	No BigQuery, é esperado; nos outros casos, confira o fuso horário e use datas absolutas
Exportação em massa configurada, mas nenhum conjunto de dados aparece	Ainda dentro da janela de 48 horas, ou faturamento não ativado no projeto	Espere e depois confira o faturamento e os dois papéis do IAM
O servidor MCP sobe, mas não expõe nenhuma ferramenta	Caminho das credenciais errado ou versão do protocolo incompatível com o cliente	Confira se o caminho no env resolve e qual versão da especificação o servidor suporta

Dois cuidados que valem para qualquer método

Trate a paginação com honestidade. Um agente que pede 25.000 linhas, recebe exatamente 25.000 e apresenta um total está reportando um corte. Instrua o agente a paginar ou a dizer que o resultado bateu no limite.

Use datas absolutas. Expressões relativas como “mês passado” são resolvidas com base no fuso horário da propriedade e no momento em que a consulta rodou. Essa é a causa mais comum de uma análise do Search Console confiante, coerente e errada.

Com a conexão no ar, o artigo sobre o que um agente consegue de fato descobrir nos dados do Search Console mostra as análises que valem a pena rodar, e o Autopilot implementa o caminho do conector hospedado descrito no método 1.