# Google Ads keyword research from your terminal.

Adwarp is an open-source MCP server and CLI that asks Google Ads for keyword ideas around your seed terms or a landing page. Each idea comes back with monthly searches, competition and the top-of-page bid range, before any budget is committed.

## What you can ask.

Real requests, answered from your terminal.

### What do people search for around lead routing?

```text
> What do people search for around lead routing?
adwarp.gads_keyword_ideas "lead routing", US, en: 50 ideas
Monthly searches, competition and top-of-page bid range for each, highest volume first
```

### Find keyword ideas from our product page.

```text
> Find keyword ideas from example.com/product.
adwarp.gads_keyword_ideas page example.com/product: 50 ideas
Ideas drawn from what the page says, each with volume, competition and bid range
Want the strongest ones as an EXACT match ad group?
```

### Can we afford these keywords at a 12 USD max CPC?

```text
> Can we afford these keywords at a 12 USD max CPC?
adwarp.gads_keyword_ideas your list, US: bid ranges
Some top-of-page ranges sit above your 12 USD max CPC
Raise the bid for those or drop them before the launch
```

### Which of these keywords have low competition?

```text
> Which of these keywords have low competition?
adwarp.gads_keyword_ideas "pipeline forecasting", US: 50 ideas
Each idea's competition band, low, medium or high, with Google's index for it
Low-competition terms first, ready for the brief.
```

## How it works.

1. Seed it. Give a few seed terms, a landing page, or both. The country is the US and the language English unless you name others.
2. Read the numbers. Each idea comes back with monthly searches, competition and the low and high top-of-page bid, highest volume first.
3. Build from it. Pick the keywords, set match types and negatives, and the same session drafts the Search campaign brief.

## Why it gets better results.

### Sized before you spend

Volume and bid ranges come back before a campaign exists, the way an audience estimate works on LinkedIn.

### Bids checked against your budget

Top-of-page ranges show which keywords your max CPC can reach before you launch.

### Research and build in 1 session

The keywords you size are the ones that go into the brief, with no export in between.

## Questions, answered.

### What access does keyword research need?

Basic access on your Google Ads developer token. Explorer access, which most tokens start with, blocks Google's keyword planning service, so apply for Basic on the same API Center screen. Campaigns and reporting work on Explorer.

### Where do the numbers come from?

From Google Ads. Monthly searches are Google's rounded estimates rather than exact counts, and bid ranges are in your ad account's currency.

### Can it research from a landing page?

Yes. Pass a page with or without seed terms, and Google suggests keywords from what the page says.

### Which countries and languages can I research?

Any country code, several at once, and 1 language per request, so run it again for another language. It uses the US and English when you leave them out.

### Does it work on the hosted endpoint?

No. The Google tools run on your machine, through the local MCP server or the CLI, with your own developer token and OAuth client.

### What does each keyword idea include?

Its text, Google's estimate of monthly searches, a competition band and index, and the top-of-page bid range.

| Field | Meaning |
| --- | --- |
| Keyword | The idea's text, from your seeds or the page. |
| Monthly searches | Google's rounded estimate of average monthly searches, not an exact count. |
| Competition | LOW, MEDIUM or HIGH, or UNSPECIFIED when Google has too little data. |
| Competition index | 0 to 100, finer than the band. |
| Top-of-page bid | The low and high range, in the ad account's currency. |

### Which inputs does a search take?

Seed terms or a landing page, plus the countries, a language and how many ideas to return.

| Input | What it does |
| --- | --- |
| Seed terms | Words or phrases to start from. At least 1, unless you pass a page. |
| Landing page (-u) | A page to draw ideas from, alone or with seeds. |
| Locations (-l) | Country codes, several at once. US when left out. |
| Language (--language) | 1 language per request. English when left out. |
| Limit (-n) | How many ideas to return. 50 when left out, up to 200. |

### Which tools and commands does it use?

3 MCP tools and 2 CLI commands, with what each one does.

| Tool | What it does |
| --- | --- |
| `gads_keyword_ideas` | Monthly searches, competition and top-of-page bid range for seed terms or a landing page |
| `gads_launch_search_campaign` | Turns the chosen keywords into a paused Search campaign |
| `gads_list_accounts` | Every account your sign-in can reach, to check the setup first |

CLI:

```bash
npx adwarp google keywords "lead routing" -u https://example.com/product
npx adwarp google keywords "revops automation" -l US,GB -n 100
```

## Related

- [Search campaigns](https://adwarp.dev/google-ads/search-campaigns): Build from the keywords
- [Reporting](https://adwarp.dev/google-ads/reporting): See which keywords spend
- [Google Ads](https://adwarp.dev/google-ads): Everything it does on Google

Unofficial. Not affiliated with or endorsed by LinkedIn or Google.

Canonical page: https://adwarp.dev/google-ads/keyword-research
Last updated: 2026-10-18