Como capturar as consultas de
fundamentação do Google AI Mode
Quando o Google AI Mode decide que uma pergunta precisa da web em direto, escreve as suas próprias pesquisas no Google, executa-as e cita um punhado de domínios. Nem todos os prompts acionam uma pesquisa. Quando um aciona, as pesquisas dizem-lhe para que consultas as suas páginas têm de aparecer. Veja aqui como as ver, com código e com o Moose.
O Gemini usou 6 consultas de fundamentação do Google ao fundamentar este prompt.
melhor software de processamento salarial para uma empresa de 20 pessoas
- melhor software de processamento salarial para pequenas empresas 2026
- preço software de processamento salarial 20 funcionários por mês
- melhores fornecedores de processamento salarial pequenas empresas opiniões
- software de processamento salarial com gestão de benefícios pequenas empresas
- melhor software de processamento salarial para startups preços oficiais
- comparação software de processamento salarial pequenas empresas funcionalidades
- forbes.com
- nerdwallet.com
- g2.com
- capterra.com
- businessnewsdaily.com
- pcmag.com
- techrepublic.com
- usnews.com
- softwareadvice.com
O que é uma consulta de fundamentação?
Uma consulta de fundamentação é uma pesquisa no Google que o modelo escreve para si próprio antes de lhe responder. Lê o seu prompt, avalia se pesquisar tornaria a resposta melhor e, se sim, escreve uma ou mais pesquisas próprias e executa-as. Nunca procura a frase que você escreveu.
Quando pesquisa, voltam duas coisas e ambas são recuperáveis: as consultas que escreveu e os domínios que citou. Uma diz-lhe o que foi pesquisado, a outra quem foi citado. Quando não pesquisa, também vale a pena saber: o modelo respondeu com o que já sabia.
Como capturar consultas de fundamentação com código
Este não é um problema de scraping. Uma resposta fundamentada volta como uma lista de passos, e um deles, google_search_call, contém as consultas exatas que o modelo executou. Cerca de trinta linhas dão-lhe uma captura. O trabalho está em executá-la para muitos prompts ao longo do tempo.
# grounding.py · the queries Google wrote for itself import os, json from google import genai PROMPT = "melhor software de processamento salarial para uma empresa de 20 pessoas" client = genai.Client(api_key=os.environ["GEMINI_API_KEY"]) interaction = client.interactions.create( model="gemini-3.6-flash", input=PROMPT, # search is opt-in here. the model still decides # on its own whether this prompt needs it. tools=[{"type": "google_search"}], ) queries, sources = [], [] for step in interaction.steps: if step.type == "google_search_call": queries += step.arguments["queries"] if step.type == "model_output": for block in step.content: # citations hang off spans of the answer text for a in (block.annotations or []): if a.type == "url_citation": sources.append(a.title) print(json.dumps({ "prompt": PROMPT, "queries": queries, # empty means it never searched "sources": sorted(set(sources)), }, indent=2))
// grounding.mjs · same call, node import { GoogleGenAI } from '@google/genai'; const PROMPT = 'melhor software de processamento salarial para uma empresa de 20 pessoas'; const client = new GoogleGenAI({ apiKey: process.env.GEMINI_API_KEY }); const interaction = await client.interactions.create({ model: 'gemini-3.6-flash', input: PROMPT, // search is opt-in here. the model still decides // on its own whether this prompt needs it. tools: [{ type: 'google_search' }], }); const queries = []; const sources = []; for (const step of interaction.steps) { if (step.type === 'google_search_call') queries.push(...step.arguments.queries); if (step.type === 'model_output') for (const block of step.content) // citations hang off spans of the answer text for (const a of block.annotations ?? []) if (a.type === 'url_citation') sources.push(a.title); } console.log(JSON.stringify({ prompt: PROMPT, queries, // empty means it never searched sources: [...new Set(sources)].sort(), }, null, 2));
Uma captura é um prompt num momento. A versão útil são cinquenta prompts agendados, sem duplicados e comparados com o mês passado.
É o modelo que decide se o prompt precisa da web. Quando decide que não, não há passo de pesquisa nenhum e nada lhe diz porquê. Tem de detetar o caso vazio e decidir se é para repetir ou se é um achado a sério.
As fontes chegam como anotações presas a intervalos de caracteres da resposta, não como uma lista. Chegar aos nove domínios implica percorrer cada anotação e eliminar duplicados.
Nos modelos Gemini 3 cada pesquisa que o modelo executa é faturada à parte, por isso um prompt que se fundamenta seis vezes custa seis pesquisas.
As consultas só significam alguma coisa ao lado da captura anterior, por isso acaba a manter uma base de dados além de um script.
Com o Moose, pede no chat
A mesma chamada, o mesmo campo, sem a canalização. O Moose guarda todas as execuções, por isso vê o que mudou desde o mês passado.
Escreva «capturar consultas de fundamentação do AI Mode», ou use o chip de início rápido na caixa de escrita. Nenhuma chave para colar.
Uma pergunta que o seu comprador escreveria mesmo. O Moose executa-a com fundamentação e retira da resposta as consultas e os domínios citados.
Consultas e fontes ficam na sua biblioteca, exportáveis e comparáveis com todas as capturas anteriores do mesmo prompt.
Tal como a captura de consultas derivadas. A execução tem de ir diretamente ao Google com a fundamentação por pesquisa ativada, e o acesso encaminhado através do OpenRouter remove os metadados de fundamentação antes de lhe chegarem. Nos planos BYOK, todo o resto do Moose continua a funcionar, incluindo a verificação instantânea de visibilidade em cinco motores de pesquisa com IA. Esta funcionalidade em concreto não.
O que fazer com as consultas
Essas pesquisas decidem que páginas são recuperadas e lidas, por isso importam mais do que a formulação exata que o seu comprador escreveu.
Dimensão da empresa, preço, integração, setor: o qualificador que aparece nas consultas de fundamentação é aquele de que o Google acha que a resposta depende. Construa a página à volta desses.
O mesmo prompt, os mesmos nove sites, semana após semana. Se não está entre eles, essa é a distância. Se está, mantenha essa página atualizada.
As consultas mudam à medida que o índice e o modelo mudam. Uma consulta que aparece várias semanas seguidas é um tema que merece uma página.
Consultas derivadas e fundamentação, lado a lado
Os dois motores decompõem a sua pergunta antes de pesquisar. O que expõem, quantas pesquisas executam e como se lá chega são três coisas diferentes.
Perguntas que nos fazem mesmo
São literalmente as consultas que o AI Mode executa?
As consultas vêm dos metadados de fundamentação do Gemini, que são a mesma maquinaria de fundamentação por pesquisa sobre a qual o AI Mode está construído, através da API pública. Na prática, os conjuntos de consultas parecem-se com o que o AI Mode produz, mas não é uma gravação do próprio google.com/aimode, por isso trate-o como uma aproximação próxima.
Porque é que só me voltaram duas consultas?
Porque o modelo decidiu que duas chegavam. As perguntas estreitas, locais ou muito batidas fundamentam-se com uma ou duas pesquisas. As perguntas amplas de comparação puxam muitas vezes seis ou mais. Um prompt que se fundamenta muito é um em que a resposta ainda está disputada.
As consultas mudam se eu repetir o mesmo prompt?
Sim, nas margens. As pesquisas centrais são estáveis, a cauda longa mexe-se, e os domínios citados mexem-se mais depressa do que as consultas. Execute o mesmo prompt de forma agendada e veja o que entra e o que sai.
Porque é que não há uma lista limpa de fontes citadas?
Porque o Google não devolve nenhuma. As citações voltam agarradas a trechos do texto da resposta, cada uma com um URL e um título que normalmente é só o domínio. O Moose percorre cada anotação, elimina duplicados e mostra-lhe os domínios.
Devo escrever uma página por consulta de fundamentação?
Normalmente não. Seis consultas à volta de uma pergunta de compra ficam melhor servidas por uma página forte que cubra as seis. O conjunto de consultas diz-lhe o que tem de estar na página: o preço, o qualificador de dimensão, a comparação, o ângulo das análises independentes.
Mais coisas para perguntar ao Moose
Todos os casos de usoA mesma pergunta para o outro motor. Doze pesquisas por trás de um prompt, e como vê-las.
Uma pergunta, cinco motores, cerca de um minuto. Grátis em todos os planos.
Um índice semântico de cada página, construído e guardado no seu computador. Pergunte-lhe o que cobre.
Os 10 primeiros resultados, as perguntas relacionadas, a AI Overview e as suas fontes, tudo citado no briefing.
Quando a quota desce, o Moose encontra a página, prepara a correção e espera pela sua aprovação.
A lista completa e o que o Moose faz passo a passo em cada um.
Veja as pesquisas por trás
da resposta.
Descarregue o Hi, Moose, abra um chat e peça. A captura de fundamentação precisa do plano gerido. A aplicação é grátis de instalar e as verificações de visibilidade são grátis de executar.