google_search_console_compare_performance
Compare Search Performance (Period Over Period)
GoogleDescription
Compare current vs previous period performance in a single call. Makes 4 parallel API calls internally and returns deltas for clicks, impressions, CTR, and position. Args: site_url (string, required): The Search Console property URL. days (int, optional): Length of each period in days. Range: [1, 90]. Default: 28. current_end_date (string, optional): Override the end date of the current period (YYYY-MM-DD). Default: today minus 3 days. search_type (string, optional): web (default), image, video, news. Returns: currentPeriod, previousPeriod: { startDate, endDate, clicks, impressions, ctr, position } delta: { clicks, clicksPct, impressions, impressionsPct, ctr, position } trend: "improving" (clicks up >10%), "declining" (clicks down >10%), or "stable" topQueries, previousTopQueries: top 50 queries for each period (may be null if sub-query failed) errors: list of sub-query failures (if any) — overall metrics are always present Periods are adjacent and non-overlapping: previousEnd + 1 day = currentStart.
Usage
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "google_search_console_compare_performance",
"arguments": {
"site_url": "https://example.com/",
"days": 28,
"reason": "Compare this period vs previous"
}
}
}
hopkin google ch-console-compare-performance
| Flag | Type | Required | Description |
|---|---|---|---|
--site-url | string | Required | The Search Console property URL (e.g. sc-domain:example.com or just example.com). |
--days | integer | Optional | Window size in days for each period. Default: 28. |
--current-end-date | string | Optional | End date of the current period (YYYY-MM-DD). Default: today - 3 days (data freshness lag). |
--search-type | string | Optional |
{
"mcpServers": {
"google-search-console": {
"url": "https://gsc.mcp.hopkin.ai",
"transport": "sse"
}
}
}
- Compare 28 days
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
site_url |
string |
Required | The Search Console property URL (e.g. sc-domain:example.com or just example.com).minLength: 1 |
reason |
string |
Required | Why this tool call is neededminLength: 1, maxLength: 500 |
Optional parameters (3)
| Name | Type | Required | Description |
|---|---|---|---|
days |
integer |
Optional | Window size in days for each period. Default: 28.min: 1, max: 90 |
current_end_date |
string |
Optional | End date of the current period (YYYY-MM-DD). Default: today - 3 days (data freshness lag). |
search_type |
string |
Optional | web image video news discover googleNews |
Examples
Compare 28 days
{
"site_url": "https://example.com/",
"days": 28,
"reason": "Compare this period vs previous"
}
hopkin google ch-console-compare-performance --site-url https://example.com/ --days 28