gsc_search_analytics
Query Google Search Console for organic search performance metrics: impressions, clicks, CTR, and average position. Filter by site, dates, dimensions, and search type to analyze SEO trends.
Instructions
Queries Google Search Console search analytics data — impressions, clicks, CTR, and position for queries, pages, countries, and devices.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"site_url": "<site_url>",
"start_date": "<start_date>",
"end_date": "<end_date>"
},
"name": "gsc_search_analytics"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| site_url | Yes | Site URL as defined in GSC (e.g. "https://example.com/" or "sc-domain:example.com") | |
| start_date | Yes | Start date in YYYY-MM-DD format | |
| end_date | Yes | End date in YYYY-MM-DD format | |
| dimensions | No | Dimensions to group by: query, page, country, device, searchAppearance, date | |
| type | No | Search type: web, image, video, news, discover, googleNews | |
| row_limit | No | Max rows to return (default 1000, max 25000) | |
| start_row | No | Zero-based row offset for pagination | |
| dimension_filter_groups | No | Dimension filter groups | |
| aggregation_type | No | How data is aggregated: auto, byProperty, byPage | |
| data_state | No | Data state: final, all (includes partial data) |