`google_search_console_get_top_queries`

Get Top Search Queries

Google

Description

Get top queries with clicks, impressions, CTR, and position. Automatically identifies high-opportunity queries (position 4-20, impressions >100, CTR <5%). Args: site_url (string, required): The Search Console property URL. days (int, optional): Number of days to look back. Range: [1, 90]. Default: 28. start_date / end_date (string, optional): Explicit date range (overrides days). page_filter (string, optional): Filter to queries for a specific URL (exact match). device (string, optional): Filter by device type. Valid: desktop, mobile, tablet. search_type (string, optional): web (default), image, video, news. row_limit (int, optional): Max queries to return. Default: 25. start_row (int, optional): Pagination offset. Default: 0. Returns: data: top query rows highOpportunityQueries: queries with ranking potential (position 4-20, impressions >100, CTR <5%) site_url, dateRange

Read-onlyOpen-world

Usage

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "google_search_console_get_top_queries",
    "arguments": {
      "site_url": "https://example.com/",
      "days": 28,
      "reason": "Get top queries for last 28 days"
    }
  }
}

hopkin google ch-console-get-top-queries

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	Number of days to look back. Default: 28. Range: 1-90.
`--start-date`	`string`	Optional	Override start date (YYYY-MM-DD). Takes precedence over days if both provided.
`--end-date`	`string`	Optional	Override end date (YYYY-MM-DD). Takes precedence over days if both provided.
`--page-filter`	`string`	Optional	Filter to queries driving traffic to this page (absolute URL or relative path, e.g. "/blog").
`--device`	`string`	Optional	Filter by device type.
`--search-type`	`string`	Optional
`--row-limit`	`integer`	Optional
`--start-row`	`integer`	Optional

{
  "mcpServers": {
    "google-search-console": {
      "url": "https://gsc.mcp.hopkin.ai",
      "transport": "sse"
    }
  }
}

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 (8)

Name	Type	Required	Description
`days`	`integer`	Optional	Number of days to look back. Default: 28. Range: 1-90.min: 1, max: 90
`start_date`	`string`	Optional	Override start date (YYYY-MM-DD). Takes precedence over days if both provided.
`end_date`	`string`	Optional	Override end date (YYYY-MM-DD). Takes precedence over days if both provided.
`page_filter`	`string`	Optional	Filter to queries driving traffic to this page (absolute URL or relative path, e.g. "/blog").minLength: 1
`device`	`string`	Optional	Filter by device type. `desktop` `mobile` `tablet`
`search_type`	`string`	Optional	`web` `image` `video` `news` `discover` `googleNews`
`row_limit`	`integer`	Optional	min: 1, max: 25000
`start_row`	`integer`	Optional	min: 0

Examples

Last 28 days

{
  "site_url": "https://example.com/",
  "days": 28,
  "reason": "Get top queries for last 28 days"
}

hopkin google ch-console-get-top-queries --site-url https://example.com/ --days 28

Filter by page

{
  "site_url": "https://example.com/",
  "days": 28,
  "page_filter": "https://example.com/blog",
  "reason": "Queries for blog section"
}

hopkin google ch-console-get-top-queries --site-url https://example.com/ --days 28 --page-filter https://example.com/blog