google_search_console_compare_performance

Compare Search Performance (Period Over Period)

Google

Description

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.

Read-onlyOpen-world

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"
    }
  }
}

Parameters

NameTypeRequiredDescription
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)
NameTypeRequiredDescription
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