[Integrations](https://spiral.ai/integrations) › [Claude Code](https://spiral.ai/integrations/claude-code) › [Serpstat related keywords](https://spiral.ai/integrations/claude-code/serpstat-related-keywords)

# How to Use Serpstat related keywords in Claude Code

Finds semantically related queries with search volume, CPC, difficulty, and a connection score based on shared search results. Use it to expand a topic beyond phrases containing your original words.

|  |  |
| --- | --- |
| Model | Serpstat related keywords |
| 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 Serpstat related keywords in Claude Code

- Use Serpstat related keywords for 'espresso machine' in Google US. Compare the returned queries with our content files and propose five article topics we have not covered.
- Use Serpstat related keywords for 'sourdough starter' in Google US. Group the results by topic and compare them with our recipe files to draft a content backlog.
- Use Serpstat related keywords to look this up and give me the result as a table. Save the result in ./assets.
- Pull the latest numbers from Serpstat related keywords and tell me what changed since last week.
- Check Serpstat related keywords and summarize what you find in three bullet points.

## How to set up Serpstat related keywords 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 Serpstat related keywords**: 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": "serpstat/keywords/related",
    "input": {
      "se": "<se>",
      "keyword": "<keyword>"
    }
  }'
```

Then paste one of the prompts above: Claude Code finds Serpstat related keywords on Spiral, shows the price and runs it.

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

## Serpstat related keywords tools and prices

- [Serpstat · Related keywords](https://spiral.ai/tools/alexandria/serpstat/keywords/related) (Alexandria): Up to $0.17459 per run.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| page | 1 to … | — | 1-based page. Serpstat returns at most the first 60,000 rows of a report. |
| size | 1 to 150 | 15 | Rows per page, from 1 to 150. Serpstat allows up to 1000; this connector stops at 150 so a call stays within 100 Firecrawl credits. Omitting it requests 15. |
| sort |  | — | One sort field and direction, for example {"region_queries_count": "desc"}. |
| filters |  | — | Serpstat filters for this method, combined with AND. Keys include region_queries_count_from, cost_from, difficulty_to, keyword_length_to, weight, and intents_contain. |
| withIntents |  | — | Add keyword intents. Serpstat supports it on g_us and g_ua only. |

## What can you do with Serpstat related keywords in Claude Code?

Turn Serpstat keyword research into a content backlog tied to your site's existing pages. A coding agent can compare returned phrases and available metrics with project content, then draft concrete page and heading changes.

### Build an editorial topic plan

Expand a topic such as espresso brewing into related searches and specific suggested phrases. Check the shortlisted terms' metrics before assigning article briefs.

### Plan ecommerce category pages

Research running shoes, collect related product language and suggested phrases, and compare keyword metrics before proposing category names and buying guides.

### Prepare paid search keyword research

Discover related and suggested searches around accounting software. Check candidate terms for search volume, CPC, and paid competition before selecting phrases for campaign review.

### Research local service topics

Collect suggested phrases around bike repair and inspect detected place names. Explore related service searches and compare metrics for the terms relevant to the business's service area.

### Refresh an existing article

Compare an article's target terms with current keyword metrics. Use related searches and suggestions to propose sections that address additional searches on the same topic.

### Review product terminology

Research phrases such as standing desk and sit stand desk. Compare their metrics and collect related and suggested wording to inform navigation labels and product copy.

## Overview

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

## Serpstat related keywords in other agents

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

## More Claude Code guides

- [Serpstat referring domains](https://spiral.ai/integrations/claude-code/serpstat-referring-domains)
- [Serpstat search suggestions](https://spiral.ai/integrations/claude-code/serpstat-search-suggestions)
- [Serpstat organic search competitors](https://spiral.ai/integrations/claude-code/serpstat-organic-search-competitors)
- [Serpstat top organic pages](https://spiral.ai/integrations/claude-code/serpstat-top-organic-pages)
- [Serpstat keyword metrics](https://spiral.ai/integrations/claude-code/serpstat-keyword-metrics)
- [Similarweb incoming referral domains](https://spiral.ai/integrations/claude-code/similarweb-incoming-referral-domains)

## Questions about Serpstat related keywords in Claude Code

**Can Claude Code use Serpstat related keywords?**

Yes. Add Spiral to Claude Code as an MCP server, and Claude Code can find and run Serpstat related keywords like any built-in tool.

**How much does Serpstat related keywords 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 Serpstat related keywords in Claude Code?**

No. Spiral runs Serpstat related keywords on its own Alexandria account. You sign in to Spiral once and never paste a key.

**How long does it take to set up Serpstat related keywords in Claude Code?**

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

**Does Claude Code wait while Serpstat related keywords runs?**

Serpstat related keywords runs in the background. Claude Code starts the run, checks on it and gives you the json when it's ready.

**Does Serpstat return live search data?**

These keyword methods retrieve Serpstat's stored database data. A new request does not trigger a fresh search-engine crawl.

**How often does Serpstat refresh keyword data?**

Serpstat says high-volume keywords update monthly on average. Low-volume keyword updates can take up to three months, so repeated checks may return unchanged data.

**Can pagination retrieve every result in a large report?**

Serpstat documents a ceiling of the first 60,000 API report results, regardless of pagination. More pages do not make a report larger than that ceiling exhaustive.

**How do related keywords differ from search suggestions?**

Related keywords can include terms that do not contain your seed words, and their connection score uses shared URLs in the top 20 results. Search suggestions uses full-text matching and returns suggestion text with detected place names.

**Can I display raw Serpstat data in a customer-facing product?**

Serpstat says embedding, reselling, or showing raw data in a customer-facing product or dashboard requires a separate data licensing agreement.

