aeo-grounding-query-mapper

Analyze Google Search grounding queries Gemini fires for single prompts and batch workflows.

9|2|Updated Feb 12, 2026
One-click install
npx skills add https://github.com/psyduckler/aeo-skills --skill aeo-grounding-query-mapper
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: aeo-grounding-query-mapper
Source: https://github.com/psyduckler/aeo-skills/tree/main/aeo-grounding-query-mapper
Command: npx skills add https://github.com/psyduckler/aeo-skills --skill aeo-grounding-query-mapper

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Map and analyze the exact search queries Gemini 3 Flash fires when answering prompts, so you can understand retrieval behavior and influence content strategy.

Core Features & Use Cases

  • Grounding query mapping: process single prompts or batches to collect and analyze queries.
  • Clustering and pattern detection: group similar queries and identify themes across prompts.
  • Cross-prompt insight: compare query sets to reveal core retrieval patterns.

Quick Start

Run the script from this directory using python3 map_queries.py 'your prompt here'.

Frequently Asked Questions about aeo-grounding-query-mapper

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I extract Google Search grounding queries fired by Gemini?

To extract Google Search grounding queries fired by Gemini, you can run a Python script that processes single or batch prompts to collect and analyze the exact search queries used for retrieval. This reveals the underlying query frequency and intent.

What is Google Search grounding query mapping for Gemini prompts?

Grounding query mapping is the process of identifying and analyzing the search queries Gemini fires when answering prompts. It helps you understand retrieval behavior, group similar queries through clustering, and identify themes across various scenarios.

Can I analyze Gemini grounding queries in batch workflows?

Yes, you can analyze Gemini grounding queries in batch workflows. The mapping process applies to both single prompts and batch workflows, implementing a deterministic workflow with concurrent requests to reveal query frequency, intent, and sources across multiple scenarios.

How do I cluster and detect patterns in Gemini search queries?

To cluster and detect patterns in Gemini search queries, the system groups similar queries and identifies themes across prompts. This allows you to compare query sets and reveal core retrieval patterns for downstream dashboards.

Do I need an API key to map Gemini grounding queries?

Yes, you need an API key to map Gemini grounding queries. The deterministic workflow includes an API key gate to authenticate requests before extracting queries, clustering patterns, and generating structured output for downstream analysis.