Search Console / API Reference
gsc_compare_periods
Search Console tool. Compare Google Search Console performance between two date ranges side by side. Args: period1_start: Start of first period YYYY-MM-DD (required). period1_end: End of first period YYYY-MM-DD (required). period2_start: Start of second period YYYY-MM-DD (required). period2_end: End of second period YYYY-MM-DD (required). site_url: Site URL. Leave blank to use the default site. dimensions: Comma-separated dimensions, e.g. 'query' or 'page'. Leave blank for totals only. row_limit: Max rows per period. Default 10.
This is a read-only tool: it compares periods from your Search Console account. It changes nothing.
Ask Claude
You do not call this tool yourself. Ask for the outcome and the client picks the tool:
Compare periods in my Search Console account for [period1 start], [period1 end], [period2 start].
It takes 4 required and 3 optional parameters.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
period1_start | string | Yes | Period1 Start |
period1_end | string | Yes | Period1 End |
period2_start | string | Yes | Period2 Start |
period2_end | string | Yes | Period2 End |
site_url | string | No | Site Url |
dimensions | string | No | Dimensions |
row_limit | integer | No | Row Limit |
Related Search Console tools
gsc_core_web_vitalsgsc_country_breakdowngsc_crawl_errorsgsc_date_trendgsc_delete_sitemapgsc_device_breakdown
Before you can call it
This tool needs a connected Search Console account. The Search Console connect guide covers the OAuth flow and the permissions it asks for, and the quickstart gets a client talking to the server in about five minutes.
Workflows that use this
Rather than calling tools one at a time, these skills run a whole procedure against the same account: