`google_ads_generate_keyword_ideas`

Generate Google Ads Keyword Ideas

Google

Description

Generate keyword suggestions from seed keywords and/or a URL. Returns keyword ideas with average monthly searches, competition level, and estimated bid ranges. Supports pagination for large result sets. Examples: seed with ["running shoes", "athletic footwear"] for shoe campaigns, or provide a competitor URL to discover relevant keywords. Use include_monthly_volumes=true for seasonal trend data.

Read-onlyIdempotentOpen-world

Usage

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "google_ads_generate_keyword_ideas",
    "arguments": {
      "customer_id": "1234567890",
      "keywords": [
        "running shoes",
        "athletic footwear"
      ],
      "reason": "Keyword research for new campaign"
    }
  }
}

hopkin google generate-keyword-ideas

Flag	Type	Required	Description
`--customer-id`	`string`	Required	The Google Ads Customer ID (10 digits, with or without dashes)
`--login-customer-id`	`string`	Optional	MCC (Manager) Customer ID; required for managed accounts
`--keywords`	`array`	Optional	Seed keywords to generate ideas from (max 20). At least one of keywords or url must be provided.
`--url`	`string`	Optional	Seed URL to generate keyword ideas from. At least one of keywords or url must be provided.
`--language`	`string`	Optional	ISO 639-1 language code (e.g., "en", "es"). Default: "en".
`--geo-targets`	`array`	Optional	ISO 3166-1 alpha-2 country codes (e.g., ["US", "GB"]). Default: ["US"].
`--network`	`string`	Optional	Keyword plan network: GOOGLE_SEARCH (default) or GOOGLE_SEARCH_AND_PARTNERS
`--include-adult-keywords`	`boolean`	Optional	Whether to include adult keyword ideas. Default: false.
`--include-monthly-volumes`	`boolean`	Optional	When true, includes per-month search volume history for each keyword. Default: false.
`--limit`	`integer`	Optional	Maximum keyword ideas to return per page (1-1000, default 50)
`--cursor`	`string`	Optional	Opaque pagination cursor from a previous response. Do not construct manually.

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

Parameters

Name	Type	Required	Description
`customer_id`	`string`	Required	The Google Ads Customer ID (10 digits, with or without dashes)pattern: ^[\d-]+$
`reason`	`string`	Required	Why this tool call is neededminLength: 1, maxLength: 500

Optional parameters (10)

Name	Type	Required	Description
`login_customer_id`	`string`	Optional	MCC (Manager) Customer ID; required for managed accountspattern: ^[\d-]+$
`keywords`	`array`	Optional	Seed keywords to generate ideas from (max 20). At least one of keywords or url must be provided.
`url`	`string`	Optional	Seed URL to generate keyword ideas from. At least one of keywords or url must be provided.
`language`	`string`	Optional	ISO 639-1 language code (e.g., "en", "es"). Default: "en".minLength: 2, maxLength: 5
`geo_targets`	`array`	Optional	ISO 3166-1 alpha-2 country codes (e.g., ["US", "GB"]). Default: ["US"].
`network`	`string`	Optional	Keyword plan network: GOOGLE_SEARCH (default) or GOOGLE_SEARCH_AND_PARTNERS `GOOGLE_SEARCH` `GOOGLE_SEARCH_AND_PARTNERS`
`include_adult_keywords`	`boolean`	Optional	Whether to include adult keyword ideas. Default: false.
`include_monthly_volumes`	`boolean`	Optional	When true, includes per-month search volume history for each keyword. Default: false.
`limit`	`integer`	Optional	Maximum keyword ideas to return per page (1-1000, default 50)min: 1, max: 1000
`cursor`	`string`	Optional	Opaque pagination cursor from a previous response. Do not construct manually.

Examples

From seed keywords

{
  "customer_id": "1234567890",
  "keywords": [
    "running shoes",
    "athletic footwear"
  ],
  "reason": "Keyword research for new campaign"
}

hopkin google generate-keyword-ideas --customer-id 1234567890 --keywords running shoes,athletic footwear

From URL

{
  "customer_id": "1234567890",
  "url": "https://example.com/products/shoes",
  "reason": "Find keywords from competitor page"
}

hopkin google generate-keyword-ideas --customer-id 1234567890 --url https://example.com/products/shoes

With monthly volumes

{
  "customer_id": "1234567890",
  "keywords": [
    "yoga mat"
  ],
  "include_monthly_volumes": true,
  "geo_targets": [
    "US",
    "GB"
  ],
  "reason": "Seasonal trend analysis"
}

hopkin google generate-keyword-ideas --customer-id 1234567890 --keywords yoga mat --include-monthly-volumes true --geo-targets US,GB