Logotipo do Google Search Console

SEO e pesquisa

Conectar Console de pesquisa do Google para Excel, Planilhas Google, IA e REST

Consultas, páginas, países e dispositivos como tabelas. O mesmo conector que o restante do Query Streams usa internamente para seu próprio SEO.

Uma conexão, todas as superfícies

Para onde seus dados do Search Console podem ser enviados

O Query Streams transforma uma propriedade do Search Console em SQL — cada combinação de consulta, página, país e dispositivo como linhas em uma tabela, além de seus sites, sitemaps e resultados de inspeção — legível no Microsoft Excel, Google Sheets, Power BI, assistentes de IA via MCP e um endpoint REST. Ele extrai os dezesseis meses completos que o Google retém na primeira sincronização, que é a parte que a interface do Search Console não fornece de uma só vez.

  1. Para sua equipe, fornecedores e parceiros.
  2. Search Console para Excel Microsoft Excel · Suplemento do Excel

    Importe resultados da Search Console em tempo real diretamente para uma planilha e atualize-os sob demanda — Excel para desktop, Excel Online, Microsoft 365.

    Guia do Search Console
  3. Do Search Console para o Google Sheets Suplemento de planilhas

    Execute uma consulta salva do Search Console na barra lateral e arraste as linhas para a planilha. Os colaboradores que compartilham a planilha podem atualizá-la por conta própria.

    Guia do Search Console
  4. Pergunte à Nova sobre o Search Console. Nova AI · texto para SQL

    Faça uma pergunta em linguagem simples. O Nova já conhece suas tabelas do Search Console, escreve e executa o SQL, explica a resposta e a exibe em um gráfico — sem necessidade de escrever consultas ou fornecer credenciais.

    Como funciona o Nova
  5. Console de pesquisa para visualizador de dados Compartilhamento de resultados · equipe, fornecedores, parceiros · celular, tablet, computador

    Compartilhe um resultado do Search Console em tempo real com qualquer pessoa — um colega, um fornecedor, um parceiro — como uma grade que pode ser adicionada aos favoritos e que é atualizada automaticamente ao ser aberta em um celular, tablet ou computador. Eles veem os resultados, nunca o SQL ou as credenciais.

    Como funciona o Visualizador de Dados
  6. Para aplicativos e sistemas
  7. API REST do Search Console endpoint HTTP

    Publique uma consulta do Search Console como um endpoint JSON autenticado que qualquer aplicativo pode chamar, com uma especificação OpenAPI 3.1 e coleções prontas para uso no Postman, Insomnia e Hoppscotch. Nenhuma porta de banco de dados é aberta.

    Como funciona a API REST
  8. Console de pesquisa para o Power BI Power Query M

    Cole o arquivo M do Power Query gerado no Editor Avançado do Power BI e o relatório lerá os resultados do Search Console em tempo real via HTTPS — sem driver ODBC, sem porta de banco de dados aberta.

    Como funciona o Power BI
  9. Integrar o Search Console ao Airtable Plataforma de automação

    Sincronize as linhas do Search Console com uma base do Airtable de acordo com uma programação ou busque-as dentro de um script de automação do Airtable.

    Guia do Search Console
  10. Pesquisar no console para linha base Plataforma de automação

    Alimente uma tabela do Baserow a partir do Search Console através do endpoint REST — hospedado localmente ou na nuvem do Baserow.

    Guia do Search Console
  11. Search Console para SeaTable Plataforma de automação

    Mantenha uma base de dados do SeaTable atualizada com os dados do Search Console sem exportar um arquivo ou expor o banco de dados.

    Guia do Search Console
  12. Integração do Search Console com o Smartsheet Plataforma de automação

    Exiba os resultados do Search Console em uma grade do Smartsheet para que os planos e relatórios sejam lidos do sistema de origem, e não da exportação da semana passada.

    Guia do Search Console
  13. Pesquise no Search Console para acessar o Anvil Anvil Works · Plataforma de aplicativos

    Faça backup de um aplicativo Anvil Python com o Search Console por meio do endpoint REST, em vez de incorporar as credenciais do banco de dados no aplicativo.

    Guia do Search Console
  14. Para ferramentas de IA
  15. Servidor MCP do Search Console Clientes Claude, Cursor e MCP

    Conceda ao assistente de IA acesso somente leitura ao Search Console com o esquema necessário para escrever SQL corretamente — sem credenciais no chat.

    Guia do Search Console
  16. Entregue às pessoas
  17. Alertas e relatórios do Search Console Slack · Discord · E-mail · Webhook

    Programe uma consulta no Search Console para que os resultados sejam entregues no Slack, Discord, por e-mail ou por um webhook assinado — ou retenha a mensagem até que a contagem de linhas, um limite ou uma variação percentual ultrapasse o valor definido.

    Como funcionam os alertas e relatórios

Como funciona

5 etapas, sem alteração no firewall de entrada

01

Crie uma conta de serviço do Google e adicione-a como um usuário na propriedade do Search Console.

02

Instale o Agente de Rede e forneça a chave da conta de serviço e o URL do site — seja no formato https ou no formato sc-domain.

03

Salvar. A primeira sincronização retrocede dezesseis meses em todos os cinco tipos de pesquisa.

04

Escreva um SQL comum para gsc.search_analytics — ou deixe o Nova escrever para ele.

05

Leia os dados no Excel, Planilhas Google, Power BI, MCP ou REST, integrados à plataforma que armazena seus cadastros e receitas.

Análise detalhada do recurso

O que o Search Console oferece

Dezesseis meses, em uma tabela

O Search Console armazena dados dos últimos dezesseis meses e os exibe em partes. Quando os dados são convertidos para SQL, a comparação ano a ano que a interface não permite é feita com um GROUP BY.

  • gsc.search_analytics apresenta uma linha por consulta, página, país, dispositivo e dia, com cliques, impressões, taxa de cliques (CTR) e posição média.
  • Cinco tipos de pesquisa são sincronizados, não apenas na web. — Imagens, vídeos, notícias e a seção Descobrir também aparecem, cada um com sua respectiva etiqueta.
  • As linhas "Descobrir" e "Notícias" não contêm nenhuma consulta ou dispositivo, porque o Google não informa essas dimensões para elas. As colunas são nulas, em vez de inventadas.
  • As tabelas gsc.sites e gsc.sitemaps são fornecidas separadamente, permitindo a consulta da contagem de sites submetidos em relação aos indexados.

Sincero sobre a lentidão do Google

Os dados do Search Console estão atrasados em cerca de três dias, e os últimos dias continuam mudando após serem publicados. Ambos são comportamentos do Google, e ambos são exibidos de forma visível, em vez de ocultos.

  • A sincronização abrange até três dias atrás, porque solicitar dados mais recentes retorna um número que estará incorreto amanhã.
  • Cada linha contém uma coluna data_state que indica se o estado é parcial ou final, permitindo que um relatório exclua os dias que ainda estão em fase de consolidação, em vez de simplesmente calcular a média desses dias.
  • Cada passagem incremental lê novamente os últimos cinco dias, de modo que uma linha parcial se torna a versão final, em vez de permanecer como a primeira versão vista.

Nós mesmos usamos este.

O Query Streams executa seu próprio SEO neste conector — as mesmas tabelas, o mesmo atraso de três dias, a mesma sinalização de parcial versus final. Não se trata de uma integração de demonstração criada para uma parede de logotipos.

  • Se uma consulta retornar mais de 25 mil linhas por página por dia, o Google exibirá apenas essa parcela; dividi-la em mais dimensões não é automático.
  • A tabela de inspeção de URLs existe e é preenchida sob demanda, em vez de ser sincronizada de forma agendada.

Compartilhado por todos os conectores de API.

Como funciona cada conector de API

  • Sua conta se transforma em mesas — Os endpoints são mapeados para tabelas SQL tipadas com chaves primárias e índices, então você escreve SELECT, JOIN e GROUP BY em vez de percorrer o JSON.
  • Você escolhe o que será sincronizado e com que frequência. — Cada tabela tem seu próprio intervalo, ou nenhum. Quando a API do fornecedor oferece suporte, somente os registros que foram alterados desde a última execução são recuperados.
  • A cópia é sua. — Ele reside em um arquivo DuckDB criptografado com AES-256-GCM, localizado ao lado do agente, em sua máquina. Não está em nossa nuvem.
  • O fornecedor só recebe notícias suas. — o agente chama a API diretamente da sua própria rede, portanto, o Query Streams não precisa do seu token para responder a uma consulta.

Bom saber

  • É uma cópia sincronizada, não um proxy em tempo real. — Uma consulta lê o que já foi buscado, portanto, retorna na velocidade do SQL e nunca consome seu limite de taxa da API. Tabelas selecionadas também podem atualizar uma linha desatualizada à medida que você a lê.
  • Os limites de tarifa são respeitados para você. — cada conector opera bem dentro dos limites publicados pelo fornecedor, portanto, um relatório não pode fazer com que sua conta seja limitada para todos os outros usuários que o utilizam.
  • Nada é desperdiçado. — Os campos que a tabela não nomeia são mantidos em uma coluna JSON raw_data que você ainda pode consultar.
  • Integre-o aos seus bancos de dados. — Uma tabela de API e uma tabela do SQL Server na mesma instrução é uma consulta comum aqui, não um projeto de integração.

SQL entre fontes diferentes

Integre o Search Console ao restante dos seus dados.

O Search Console pode informar qual página gerou o clique. Ele não pode informar qual desses cliques se transformou em uma conta, nem quanto essa conta gastou. Essas duas informações ficam armazenadas em outro lugar, e um único extrato pode abranger as três. Cada fonte processa apenas a parte que consegue, transmite o resultado de volta e a junção ocorre de forma centralizada — as fontes nunca se comunicam entre si e nada é copiado para nenhum lugar.

3 conexões · 3 agentes

Console de pesquisa do Google SEO e pesquisa
PostgreSQL Motor relacional
Listrado Pagamentos e faturamento

Uma declaração

-- cliques do Search Console, cadastros da sua base de dados, receita do Stripe
SELECIONAR   s.page, SUM(s.clicks) AS clicks, SUM(i.amount_due) AS invoiced
DE     site gsc.gsc.search_analytics1 s
JUNTAR     pg_crm.clientes.públicos2       c LIGADO c.landing_page = s.page
JUNTAR     cobrança.stripe.faturas3       i LIGADO i.cliente = c.stripe_id
GRUPO POR s.page
ORDER BY clica em DESC;

As três partes são conexão, esquema e tabela — e o nome da conexão é o nome que você deu a ela. Colunas ilustrativas; suas tabelas serão suas tabelas. Os dados do Search Console abrangem até três dias, o que se deve ao atraso nos relatórios do Google, e não a qualquer adição feita pela sincronização. O modo somente leitura se aplica a todos os componentes: apenas SELECT, WITH e EXPLAIN, com um limite máximo de dados que uma única fonte pode fornecer para uma consulta. Como funcionam as consultas federadas

Detalhes da conexão

O que o Search Console precisa

Autenticação
Uma chave de conta de serviço do Google, adicionada como usuário na propriedade. Escopo somente leitura, mantido no agente.
Propriedade
Um URL de site — https://example.com/ ou sc-domain:example.com. Deixe em branco e todas as propriedades que a conta pode visualizar serão sincronizadas.
Estendeu a mão por cima
HTTPS da sua rede para a API do Search Console. Nada de entrada.
Esquema
gsc — então gsc.search_analytics, gsc.sitemaps
Tabelas
4. search_analytics, sites, sitemaps e url_inspection
Tipos de pesquisa
Web, imagem, vídeo, notícias e descobrir, cada um identificado na linha.
Frescor
A análise abrange os últimos três dias, que é o atraso na atualização dos dados do próprio Google. Os últimos cinco dias são relidos a cada atualização.
História
16 meses após a primeira sincronização — tudo o que o Google retém
Cópia local
Um arquivo DuckDB criptografado com AES-256-GCM ao lado do agente, em sua máquina.

O modo somente leitura é estrutural. Cada chamada feita por este conector é uma leitura, e o token que ele contém tem escopo somente leitura — ele não pode enviar um sitemap nem solicitar indexação.

Em uma consulta entre fontes diferentes, a parte central de uma referência de três partes é gsc. Uma conexão chamada gsc_site que lê análises de pesquisa é escrita como gsc_site.gsc.search_analytics.

Documentação do fornecedor: pesquisa.google.com

Perguntas frequentes

Dúvidas sobre o Google Search Console

Quais ferramentas conseguem ler dados do Google Search Console por meio de fluxos de consulta?

Tudo isso, a partir de uma única conexão: Excel, Planilhas Google, MCP, API REST, Airtable, Baserow, SeaTable, Smartsheet, Anvil, Power BI, alertas e relatórios agendados. Conecte a conta uma única vez e todas as plataformas lerão a mesma conexão somente leitura — não há configuração por ferramenta nem necessidade de uma segunda cópia dos dados.

Preciso abrir uma porta no firewall para minha conta do Google Search Console?

Não. O Agente de Rede do Query Streams é executado dentro da sua rede e abre uma única conexão criptografada de saída. Nada fica à escuta do tráfego de entrada, nenhuma VPN é necessária e a conta mantém suas regras de firewall existentes.

Os fluxos de consulta podem alterar dados no Google Search Console?

Não. O agente impõe o modo somente leitura no ponto de execução — uma instrução por vez, apenas SELECT e similares. As credenciais permanecem no agente e nunca são enviadas para o Query Streams.

O que o Query Streams precisa para se conectar ao Google Search Console?

Um host acessível, uma função e sua senha — o agente carrega o driver, portanto, nada é instalado na conta. Autenticação: uma chave de conta de serviço do Google, adicionada como um usuário na propriedade. Escopo somente leitura, mantido no agente. Propriedade: um URL do site — https://example.com/ ou sc-domain:example.com. Deixe em branco e todas as propriedades que a conta pode ver serão sincronizadas. Acesso via: HTTPS da sua rede para a API do Search Console. Nada de entrada. Esquema: gsc — portanto, gsc.search_analytics, gsc.sitemaps.

Posso associar o Google Search Console a outro banco de dados na mesma consulta?

Sim, trata-se de uma consulta federada. Uma única instrução pode referenciar o Google Search Console e suas outras conexões simultaneamente, escritas como conexão.esquema.tabela. Cada origem executa apenas a parte que consegue e transmite o resultado de volta; a junção ocorre centralmente, portanto, as origens nunca se conectam entre si e nada é copiado ou agendado. O modo somente leitura se aplica a cada parte — apenas SELECT, WITH e EXPLAIN — e há um limite para a quantidade de dados que uma origem pode fornecer em uma única consulta. Consultas federadas são um recurso do plano; a página de consultas federadas exibe os limites atuais de origem e tamanho.

Coloque o Search Console onde o trabalho acontece.

Instale o agente, aponte-o para sua conta e escolha um destino.

Somente leitura Apenas envio As credenciais permanecem com o agente.