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

# How to Use Serpstat referring domains in Claude Code

Returns linking domains with referring page counts and Serpstat Domain Rank. Use it to compare the websites behind a backlink profile without reviewing every individual link.

|  |  |
| --- | --- |
| Model | Serpstat referring domains |
| 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 referring domains in Claude Code

- Use Serpstat referring domains for shopify.com and bigcommerce.com. Write a CSV of domains found only for bigcommerce.com, including referring page counts and SDR.
- Use Serpstat referring domains for canva.com. Save the returned domains and referring page counts, then chart which websites contribute the most referring pages.
- Use Serpstat referring domains to look this up and give me the result as a table. Save the result in ./assets.
- Pull the latest numbers from Serpstat referring domains and tell me what changed since last week.
- Check Serpstat referring domains and summarize what you find in three bullet points.

## How to set up Serpstat referring domains 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 referring domains**: 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/backlinks/referring-domains",
    "input": {
      "query": "<query>"
    }
  }'
```

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

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

## Serpstat referring domains tools and prices

- [Serpstat · Referring domains](https://spiral.ai/tools/alexandria/serpstat/backlinks/referring-domains) (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 | domain_links, domain_from, domain_rank, check | — | Sort field. Serpstat's default is check. |
| order | asc, desc | — | Sort direction. |
| searchType | domain, domain_with_subdomains, url, part_url | domain_with_subdomains | domain, domain_with_subdomains (sent when omitted), url, or part_url (URLs that start with query). |
| complexFilter |  | — | One group of conditions combined with AND, such as {field, compareType, value} or {additional_filters}. Sent to Serpstat as complexFilter: [group]. |

## What can you do with Serpstat referring domains in Claude Code?

Build a competitor backlink report for business domains in your project. Turn Serpstat profile totals or linking-source records into comparisons your team can review.

### Compare competitor backlink profiles

Compare shopify.com and bigcommerce.com using profile totals, unique linking websites, and individual backlink evidence. Build a brief that separates link volume from the breadth of linking sources.

### Prepare a monthly SEO report

Compare saved results for a business domain across reporting dates. Summarize changes in profile totals, identify changes in linking websites, and include example source pages where available.

### Review a content campaign

Review a business domain after publishing a research report or guide. Use aggregate metrics for context, linking websites for source diversity, and individual links to inspect the pages receiving coverage.

### Establish a migration baseline

Save a domain's backlink profile before a site migration. Preserve totals, linking domain records, and available source-to-target link records for comparison after the move.

### Scope a business SEO audit

Assess a prospective client's backlink profile before planning an audit. Start with domain totals, examine the linking websites, and review individual links to choose where deeper investigation is useful.

### Investigate concentrated link sources

Compare backlink volume with unique linking website counts. Use referring page counts and individual source URLs to investigate whether a small number of websites accounts for much of the observed profile.

### Find websites for outreach research

Compare the linking websites of buffer.com and hootsuite.com. Identify websites appearing in only one result set, then inspect available backlink pages before deciding whether they suit an outreach campaign.

## Overview

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

## Serpstat referring domains in other agents

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

## More Claude Code guides

- [Serpstat organic search competitors](https://spiral.ai/integrations/claude-code/serpstat-organic-search-competitors)
- [Serpstat related keywords](https://spiral.ai/integrations/claude-code/serpstat-related-keywords)
- [Serpstat keyword metrics](https://spiral.ai/integrations/claude-code/serpstat-keyword-metrics)
- [Serpstat search suggestions](https://spiral.ai/integrations/claude-code/serpstat-search-suggestions)
- [Serpstat domain organic keywords](https://spiral.ai/integrations/claude-code/serpstat-domain-organic-keywords)
- [Serpstat top organic pages](https://spiral.ai/integrations/claude-code/serpstat-top-organic-pages)

## Questions about Serpstat referring domains in Claude Code

**Can Claude Code use Serpstat referring domains?**

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

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

No. Spiral runs Serpstat referring domains 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 referring domains in Claude Code?**

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

**Does Claude Code wait while Serpstat referring domains runs?**

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

**Where does Serpstat get its backlink data?**

Serpstat's own bot crawls the web and adds discovered links to its backlink database. Serpstat reports an index of 1.1 trillion backlinks.

**How fresh is Serpstat backlink data?**

Serpstat states that its full backlink index update cycle takes 70 days. Individual link records describe when Serpstat first found and last found a link, so discovery dates describe crawler observations.

**Does Serpstat cover every link on the web?**

Its 1.1 trillion backlink index represents links Serpstat has indexed. Its crawler follows robots.txt rules, so crawl restrictions are one boundary on what it can discover.

**What does Serpstat Domain Rank mean?**

Serpstat Domain Rank is a domain authority indicator scored from 0 to 100. Use that scale when comparing the analyzed domain or its linking websites.

**Why count referring domains separately from backlinks?**

Referring domains counts unique linking websites; backlinks counts individual links. Reviewing both separates the breadth of a site's linking sources from the volume of links those sources contribute.

