[Integrations](https://spiral.ai/integrations) › [Claude Code](https://spiral.ai/integrations/claude-code) › [Google keyword difficulty](https://spiral.ai/integrations/claude-code/google-keyword-difficulty)

# How to Use Google keyword difficulty in Claude Code

Returns a 0 to 100 score for the difficulty of reaching Google's top 10 organic results for each keyword. Use it to compare ranking difficulty across an existing keyword shortlist.

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

## Prompts to try with Google keyword difficulty in Claude Code

- Use Google keyword difficulty for 'trail running shoes', 'waterproof running shoes', and 'running shoes for beginners' in the United States, in English. Add the returned scores to our content planning CSV.
- Use Google keyword difficulty to look this up and give me the result as a table. Save the result in ./assets.
- Pull the latest numbers from Google keyword difficulty and tell me what changed since last week.
- Check Google keyword difficulty and summarize what you find in three bullet points.
- Pull the newest data from Google keyword difficulty and give me the result as a table.

## How to set up Google keyword difficulty in Claude Code

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

### Use Spiral's MCP server

1. **Add the hosted server**: This adds Spiral to the current project. Add `--scope user` to use it in every project.

```bash
claude mcp add --transport http spiral https://api.spiral.ai/mcp
```

2. **Sign in**: Start `claude`, type `/mcp`, choose spiral and Authenticate. Sign in to Spiral in the browser and click Authorize. No API key.

### Use the Spiral skill

1. **Send Claude Code 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 keyword difficulty**: 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/difficulty",
    "input": {
      "keywords": [
        "<keywords>"
      ],
      "language_code": "<language_code>",
      "location_code": 1
    }
  }'
```

Then paste one of the prompts above: Claude Code finds Google keyword difficulty on Spiral, shows the price and runs it.

Setup guide in the docs: https://spiral.ai/docs/quickstarts/claude-code

## Google keyword difficulty tools and prices

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

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| 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. |
| location_name |  | — | Full location name, such as United States or London,England,United Kingdom. Use this or location_code. |

## What can you do with Google keyword difficulty in Claude Code?

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.

### Build a help center topic backlog

Expand spreadsheet topics into related subjects and detailed questions. Classify informational searches and compare their organic difficulty before proposing tutorial briefs.

## Overview

- [Alexandria](https://spiral.ai/providers/alexandria)
- [All Claude Code guides](https://spiral.ai/integrations/claude-code)

## Google keyword difficulty in other agents

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

## More Claude Code guides

- [Google company ads](https://spiral.ai/integrations/claude-code/google-company-ads)
- [Google keyword ideas](https://spiral.ai/integrations/claude-code/google-keyword-ideas)
- [Google Trends trending searches](https://spiral.ai/integrations/claude-code/google-trends-trending-searches)
- [Google keyword search intent](https://spiral.ai/integrations/claude-code/google-keyword-search-intent)
- [Google Trends topic suggestions](https://spiral.ai/integrations/claude-code/google-trends-topic-suggestions)
- [Google long-tail keywords](https://spiral.ai/integrations/claude-code/google-long-tail-keywords)

## Questions about Google keyword difficulty in Claude Code

**Can Claude Code use Google keyword difficulty?**

Yes. Add Spiral to Claude Code as an MCP server, and Claude Code can find and run Google keyword difficulty like any built-in tool.

**How much does Google keyword difficulty cost in Claude Code?**

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

**Do I need an Alexandria account to use Google keyword difficulty in Claude Code?**

No. Spiral runs Google keyword difficulty 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 keyword difficulty in Claude Code?**

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

**Does Claude Code wait while Google keyword difficulty runs?**

Google keyword difficulty runs in the background. Claude Code 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.

