compare_search_periods
Compare Google Search Console performance metrics between two date ranges. Get total clicks, impressions, CTR, and position with absolute and percentage changes, plus optional breakdown by query, page, or device to identify top movers.
Instructions
Compare search performance between two time periods: overall totals with absolute and percentage changes, plus an optional per-dimension breakdown of the biggest movers.
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": {
"siteUrl": "<siteUrl>",
"period1StartDate": "<period1StartDate>",
"period1EndDate": "<period1EndDate>",
"period2StartDate": "<period2StartDate>",
"period2EndDate": "<period2EndDate>"
},
"name": "compare_search_periods"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| siteUrl | Yes | Property URL exactly as registered in Search Console: "https://example.com/" for URL-prefix properties or "sc-domain:example.com" for domain properties | |
| rowLimit | No | Max breakdown rows to return, sorted by biggest click change (default 25). | |
| dimension | No | Optional dimension (e.g. "query" or "page") to break the comparison down by. | |
| period1EndDate | Yes | First (earlier) period end, YYYY-MM-DD | |
| period2EndDate | Yes | Second (later) period end, YYYY-MM-DD | |
| period1StartDate | Yes | First (earlier) period start, YYYY-MM-DD | |
| period2StartDate | Yes | Second (later) period start, YYYY-MM-DD |