gsc_compare_periods
Compare two consecutive Search Console periods and see the biggest movers in clicks, impressions, CTR, or position. Answers 'what changed' in one call, with direction-aware insights for position.
Instructions
Compare two consecutive Search Console periods and return the biggest movers in both directions - the 'what changed' question in one call.
period_days is the length of each window; the current window ends offset_days before the freshest available data, and the comparison window is the period_days immediately before it. metric is clicks, impressions, ctr or position. For position, a DECREASE is an improvement, and the response says so. dimension is usually page or query; query rows are anonymised by Google and will not sum to totals.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "gsc_compare_periods"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| top_n | No | ||
| metric | No | clicks | |
| site_url | No | ||
| dimension | No | page | |
| offset_days | No | ||
| period_days | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||