Reference
Google Search Console tools
Monitor and optimize your organic search presence with keyword rankings, URL indexing, and sitemap management.
On this page
Before you begin
Connect the relevant Google Search Console account through Accounts, then connect your AI assistant. Confirm the target account and date range before querying data or making changes.
This is the generated catalog. The tools shown in your AI assistant depend on your connected accounts, active workspace, role, write permissions, enabled features and the client's supported tool surface. A listed tool is not a promise that it is enabled in every workspace. See accounts, workspace access and troubleshooting.
Available tools
3 tools.
| Tool | Access | Purpose |
|---|---|---|
gsc_list_sites | Read | List all verified sites and optionally their sitemaps |
gsc_search_analytics | Read | Get search performance data: queries, pages, CTR, position, with flexible filtering |
gsc_manage_url | Write | Inspect URL indexing, submit sitemaps, or delete sitemaps |
Write tools can change account settings, campaigns or workspace content. Confirm the target and proposed changes before running them.
Example questions
Show me my verified Search Console sites
What are my top organic search queries this month?
Which pages get the most organic clicks?
Check if my homepage is properly indexed
Show me queries where I rank on page 2 (positions 11-20)
What's my average CTR for branded vs non-branded queries?
API capabilities
Available fields and combinations depend on the resource, account and campaign type. Adapt the examples to your selected account.
Metrics
| Category | Fields |
|---|---|
| Search Performance | clicks, impressions, ctr, position |
Dimensions
| Category | Fields |
|---|---|
| Search | query, page, country, device, searchAppearance, date |
Query examples
Top Queries by Clicks
Find your highest-traffic search queries
Tool: gsc_search_analytics.
{
"site_url": "https://example.com",
"start_date": "2026-01-01",
"end_date": "2026-01-31",
"dimensions": ["query"],
"row_limit": 25
}
Page Performance Analysis
See which pages get the most organic traffic
Tool: gsc_search_analytics.
{
"site_url": "https://example.com",
"start_date": "2026-01-01",
"end_date": "2026-01-31",
"dimensions": ["page"],
"row_limit": 50
}
URL Indexing Check
Check if a specific URL is indexed and crawlable
Tool: gsc_manage_url.
{
"site_url": "https://example.com",
"inspection_url": "https://example.com/important-page"
}
Technical reference
API endpoint: googleapis.com/webmasters/v3. Status: stable.
Sites/Analytics/Sitemaps use v3, URL Inspection uses v1 (searchconsole.googleapis.com/v1).
Rate limits
| Limit | Scope | Notes |
|---|---|---|
| 2,000 requests/day | URL Inspection API per site | Use sparingly, designed for spot-checking, not bulk scanning |
| 25,000 rows | Search Analytics maximum per query | Paginate with rowLimit + startRow for larger datasets |
Limitations and notes
- Data has a 2-3 day delay (not real-time)
- URL Inspection: 2,000 requests/day per site, use for spot-checking, not bulk
- Search Analytics limited to 16 months of historical data
- Position is an average, actual ranking varies by user, location, device
- data_state='final' excludes the most recent (incomplete) days
