GSC Query Tool
The GSC Query tool connects to your Google Search Console and lets you analyze search performance data through natural language — no SQL or dashboards required.
What It Does
The GSC Query tool is the foundation of data-driven analysis in Agentic SEO. When you ask a question about your search performance, the agent automatically calls this tool to fetch real data from your connected Google Search Console property.
You don't need to write API queries or navigate dashboards. Just ask in plain English and the agent translates your question into the right GSC API call, fetches the data, and presents it in a clear format with analysis.
Data Available
Dimensions
The tool can break down data by:
- Query — the search terms people use to find your site
- Page — which URLs appear in search results
- Country — where your search traffic comes from
- Device — desktop, mobile, or tablet
- Date — daily breakdown for trend analysis
Metrics
| Metric | What it means | Why it matters |
|---|---|---|
| Clicks | Number of times users clicked through to your site | Direct measure of organic traffic |
| Impressions | Number of times your pages appeared in search results | Indicates keyword visibility and potential reach |
| CTR | Click-through rate (clicks / impressions) | Measures how compelling your listings are |
| Position | Average ranking position in search results | Tracks ranking changes over time |
Example Queries
Here are some of the most useful things you can ask:
“Show me my top 20 keywords by clicks for the last 28 days”
Basic keyword performance overview — great for a quick health check.
“Which pages have high impressions but low CTR? Suggest title improvements.”
Finds underperforming listings where better titles/meta descriptions could win more clicks.
“Compare my traffic this month vs last month — what changed?”
Period-over-period comparison to spot trends, gains, and losses.
Date Ranges
You can specify any date range in natural language. The agent understands relative dates like “last 7 days”, “last month”, “past 90 days”, or specific ranges like “January 2026”.
Google Search Console data has a 2-3 day delay. The most recent complete data is usually from 3 days ago. The agent accounts for this automatically.
Filters and Comparisons
You can filter by any combination of dimensions. Ask for specific pages, keyword patterns, countries, or devices:
“Show me all keywords containing 'seo' where I rank between positions 5-15 on mobile”
Combines keyword filter, position range, and device filter in a single query.
For comparisons, just describe what you want to compare. The agent will run multiple queries and calculate the differences:
"How is my SEO doing?"
"Compare my top 20 keywords by clicks this month vs last month. Highlight any that dropped more than 20%."
Tips for Better Results
- Be specific about metrics — say “by clicks” or “by impressions” so the agent knows how to sort
- Specify date ranges — “last 28 days” gives more reliable data than “last 7 days”
- Ask for analysis, not just data — “What should I focus on?” gets better results than “show me data”
- Chain questions — after seeing initial data, ask follow-up questions to drill deeper
- Combine with other tools — ask the agent to use GSC data to generate content briefs or find linking opportunities
The most powerful use of the GSC Query tool is combining it with other tools. For example: “Find my top declining keywords, then generate a content brief to recover them.”
Try these prompts
© 2026 Agentic SEO. All rights reserved.