Google Ads / API Reference
google_ads_keyword_ideas
Google Ads tool. Prefer the actions marked RECOMMENDED for everyday Google Ads workflows. Generate keyword ideas using Google Ads Keyword Planner. Args: customer_id: Google Ads customer ID seed_keywords: Comma-separated seed keywords (e.g. 'running shoes,athletic footwear') language_id: Google language criterion ID (1000=English, 1005=Spanish) country_code: Two-letter country code (default: 'US') limit: Max keyword ideas to return (default: 50)
This is a read-only tool: it returns keyword ideas for your Google Ads account. It changes nothing.
Ask Claude
You do not call this tool yourself. Ask for the outcome and the client picks the tool:
Keyword ideas in my Google Ads account for [seed keywords].
It takes 2 required and 3 optional parameters.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
customer_id | string | Yes | Customer Id |
seed_keywords | string | Yes | Seed Keywords |
language_id | string | No | Language Id |
country_code | string | No | Country Code |
limit | integer | No | Limit |
Related Google Ads tools
google_ads_keyword_forecastgoogle_ads_keyword_performancegoogle_ads_account_overviewgoogle_ads_ad_performancegoogle_ads_ad_schedule_reportgoogle_ads_add_adgroup_negative_keywords
Before you can call it
This tool needs a connected Google Ads account. The Google Ads 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: