[Integrations](https://spiral.ai/integrations) › [Gemini CLI](https://spiral.ai/integrations/gemini-cli) › [Google Ads keyword search volume](https://spiral.ai/integrations/gemini-cli/google-ads-keyword-search-volume)

# How to Use Google Ads keyword search volume in Gemini CLI

Returns Google Ads search volume, monthly search history, and advertiser competition for specified keywords. Use it to compare demand and seasonality before choosing topics or campaign terms.

|  |  |
| --- | --- |
| Model | Google Ads keyword search volume |
| Available through | Alexandria |
| Category | SEO |
| Price | Up to $0.0768196 per run. |
| Returns | json |
| Runs | In the background |
| Setup | About 2 minutes, no API key |

## Prompts to try with Google Ads keyword search volume in Gemini CLI

- Use Google Ads keyword search volume for 'Christmas decorations', 'Christmas tree lights', and 'outdoor Christmas decorations' in the United States, in English. Add a monthly demand chart to our editorial planning report.
- Use Google Ads keyword search volume to look this up and give me the result as a table. Save the result in ./assets.
- Pull the latest numbers from Google Ads keyword search volume and tell me what changed since last week.
- Check Google Ads keyword search volume and summarize what you find in three bullet points.
- Pull the newest data from Google Ads keyword search volume and give me the result as a table.

## How to set up Google Ads keyword search volume in Gemini CLI

Pick the way that suits you. Each takes about two minutes.

### Use Spiral's MCP server

1. **Add the server**: Or add it to `~/.gemini/settings.json` yourself:

```bash
gemini mcp add --scope user --transport http spiral https://api.spiral.ai/mcp
```

2. **Sign in**: Start `gemini` and run:

```text
/mcp auth spiral
```

3. **Check it**: In Gemini CLI, run `/mcp`. From your shell:

```bash
gemini mcp list
```

### Use the Spiral skill

1. **Send Gemini CLI this message**: Your agent reads Spiral's skill and sets itself up.

```
set up https://spiral.ai/SKILL.md
```

2. **Sign in or paste a key**: Approve Spiral in the browser, or give the agent a key from the console.

### Use the Spiral CLI

1. **Install and sign in**: Installs the Spiral CLI, signs you in and adds its skill to your coding agents.

```bash
npx -y spiral-cli@latest init
```

### Call the Spiral API

1. **Create an API key**: In the console, under API keys.

2. **Run Google Ads keyword search volume**: One request; the result comes back by polling or a webhook.

```bash
curl https://api.spiral.ai/v1/runs \
  -H "Authorization: Bearer $SPIRAL_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "provider": "alexandria",
    "model": "dataforseo/keywords/search-volume",
    "input": {
      "keywords": [
        "<keywords>"
      ]
    }
  }'
```

Then paste one of the prompts above: Gemini CLI finds Google Ads keyword search volume on Spiral, shows the price and runs it.

Setup guide in the docs: https://spiral.ai/docs/quickstarts/gemini-cli

## Google Ads keyword search volume tools and prices

- [DataForSEO · Keyword search volume](https://spiral.ai/tools/alexandria/dataforseo/keywords/search-volume) (Alexandria): Up to $0.0768196 per run.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| date_to |  | — | End of the range, yyyy-mm-dd. Google Ads has no data for the current month. |
| sort_by | relevance, search_volume, competition_index, low_top_of_page_bid, high_top_of_page_bid | — | Sort order, descending. Default relevance. |
| date_from |  | — | Start of the range, yyyy-mm-dd, up to 4 years back. Default is the last 12 months. |
| language_code |  | — | Language code, such as en. Use this or language_name. |
| language_name |  | — | Full language name, such as English. Use this or language_code. |
| location_code |  | — | DataForSEO location code, such as 2840 for the United States. Use this or location_name. |

## What can you do with Google Ads keyword search volume in Gemini CLI?

Turn the project's content inventory into a keyword research table with DataForSEO demand, difficulty, or intent data. Match returned phrases to existing pages to propose content updates and new briefs.

### Choose the next articles to commission

Expand running shoe topics with category ideas and longer phrases. Compare search demand and organic difficulty, then use intent labels to separate buying guides from informational articles.

### Plan ecommerce category pages

Research terms around espresso machines, including related product categories and specific buying queries. Use demand, difficulty, and search intent to propose category pages and supporting guides.

### Compare keyword opportunities across markets

Research English-language standing desk queries separately for the United States and United Kingdom. Compare discovered phrases, demand, and country-specific difficulty, then classify the shortlisted terms by intent.

### Prioritize existing content updates

Take the topics from an existing cycling guide library and look for related searches and more specific phrases. Combine demand, difficulty, and intent with your content inventory to recommend which pages to expand first.

### Schedule seasonal content

Discover searches around Christmas decorations, then inspect monthly search history for the shortlisted terms. Use the observed seasonal pattern to propose publication months.

### Prepare a paid search research brief

Find category terms and detailed searches around accounting software. Compare demand and advertiser competition, then use intent labels to identify terms worth reviewing for an acquisition campaign.

## Overview

- [Alexandria](https://spiral.ai/providers/alexandria)
- [All Gemini CLI guides](https://spiral.ai/integrations/gemini-cli)

## Google Ads keyword search volume in other agents

- [Amp](https://spiral.ai/integrations/amp/google-ads-keyword-search-volume)
- [ChatGPT](https://spiral.ai/integrations/chatgpt/google-ads-keyword-search-volume)
- [Claude](https://spiral.ai/integrations/claude-desktop/google-ads-keyword-search-volume)
- [Claude Code](https://spiral.ai/integrations/claude-code/google-ads-keyword-search-volume)
- [Cline](https://spiral.ai/integrations/cline/google-ads-keyword-search-volume)
- [Codex](https://spiral.ai/integrations/codex/google-ads-keyword-search-volume)
- [Cursor](https://spiral.ai/integrations/cursor/google-ads-keyword-search-volume)
- [Devin](https://spiral.ai/integrations/devin/google-ads-keyword-search-volume)
- [dots](https://spiral.ai/integrations/dots/google-ads-keyword-search-volume)
- [Factory Droid](https://spiral.ai/integrations/factory-droid/google-ads-keyword-search-volume)
- [Gemini](https://spiral.ai/integrations/gemini/google-ads-keyword-search-volume)
- [Google Antigravity](https://spiral.ai/integrations/antigravity/google-ads-keyword-search-volume)
- [goose](https://spiral.ai/integrations/goose/google-ads-keyword-search-volume)
- [Grok](https://spiral.ai/integrations/grok/google-ads-keyword-search-volume)
- [Grok Build](https://spiral.ai/integrations/grok-build/google-ads-keyword-search-volume)
- [Hermes](https://spiral.ai/integrations/hermes/google-ads-keyword-search-volume)
- [Instinct](https://spiral.ai/integrations/instinct/google-ads-keyword-search-volume)
- [Manus](https://spiral.ai/integrations/manus/google-ads-keyword-search-volume)
- [Muse](https://spiral.ai/integrations/muse/google-ads-keyword-search-volume)
- [Muse Code](https://spiral.ai/integrations/muse-code/google-ads-keyword-search-volume)
- [n8n](https://spiral.ai/integrations/n8n/google-ads-keyword-search-volume)
- [Notion](https://spiral.ai/integrations/notion/google-ads-keyword-search-volume)
- [OpenClaw](https://spiral.ai/integrations/openclaw/google-ads-keyword-search-volume)
- [opencode](https://spiral.ai/integrations/opencode/google-ads-keyword-search-volume)
- [Perplexity](https://spiral.ai/integrations/perplexity/google-ads-keyword-search-volume)
- [Raycast](https://spiral.ai/integrations/raycast/google-ads-keyword-search-volume)
- [VS Code](https://spiral.ai/integrations/vscode/google-ads-keyword-search-volume)
- [Windsurf](https://spiral.ai/integrations/windsurf/google-ads-keyword-search-volume)
- [Zapier](https://spiral.ai/integrations/zapier/google-ads-keyword-search-volume)

## More Gemini CLI guides

- [Firecrawl website branding](https://spiral.ai/integrations/gemini-cli/firecrawl-website-branding)
- [Google Trends interest over time](https://spiral.ai/integrations/gemini-cli/google-trends-interest-over-time)
- [DataForSEO referring domains](https://spiral.ai/integrations/gemini-cli/dataforseo-referring-domains)
- [Google Trends regional interest](https://spiral.ai/integrations/gemini-cli/google-trends-regional-interest)
- [DataForSEO backlinks](https://spiral.ai/integrations/gemini-cli/dataforseo-backlinks)
- [Google Trends related searches](https://spiral.ai/integrations/gemini-cli/google-trends-related-searches)

## Questions about Google Ads keyword search volume in Gemini CLI

**Can Gemini CLI use Google Ads keyword search volume?**

Yes. Add Spiral to Gemini CLI as an MCP server, and Gemini CLI can find and run Google Ads keyword search volume like any built-in tool.

**How much does Google Ads keyword search volume cost in Gemini CLI?**

Up to $0.0768196 per run. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your Gemini CLI plan is separate.

**Do I need an Alexandria account to use Google Ads keyword search volume in Gemini CLI?**

No. Spiral runs Google Ads keyword search volume on its own Alexandria account. You sign in to Spiral once and never paste a key.

**How long does it take to set up Google Ads keyword search volume in Gemini CLI?**

About two minutes: add the server, then sign in, then check it.

**Does Gemini CLI wait while Google Ads keyword search volume runs?**

Google Ads keyword search volume runs in the background. Gemini CLI starts the run, checks on it and gives you the json when it's ready.

**How fresh is DataForSEO's keyword data?**

The keyword database follows a monthly refresh cycle tied to Google Ads. Search results used by DataForSEO Labs refresh on a separate cycle of 30 to 90 days, depending on the query and location.

**Are search volumes exact counts for each phrase?**

Google groups similar keywords and can report their combined search volume. That makes these figures unsuitable for measuring small differences between closely related spellings or phrases.

**Does competition mean organic ranking difficulty?**

Google Ads competition measures competition among advertisers in paid search. Organic difficulty is a separate DataForSEO score from 0 to 100 for reaching Google's top 10 organic results.

**How much monthly history is available?**

Google Ads keyword search volume offers up to four years of history. Keyword discovery results include a shorter history covering the previous 12 months.

**Does DataForSEO cover every country?**

No. DataForSEO says locations in Russia and Belarus are no longer supported across its services.

