[Integrations](https://spiral.ai/integrations) › [opencode](https://spiral.ai/integrations/opencode) › [Serpstat top organic pages](https://spiral.ai/integrations/opencode/serpstat-top-organic-pages)

# How to Use Serpstat top organic pages in opencode

Find a domain's pages by estimated organic traffic, alongside ranking keyword counts. Use it to identify content worth studying or refreshing, then investigate the queries behind each URL.

|  |  |
| --- | --- |
| Model | Serpstat top organic pages |
| Available through | Alexandria |
| Category | SEO |
| Price | Up to $0.034918 per run. |
| Returns | json |
| Runs | In the background |
| Setup | About 2 minutes, no API key |

## Prompts to try with Serpstat top organic pages in opencode

- Use Serpstat top organic pages for hubspot.com in Google US. Save the 30 pages with the highest estimated organic traffic, including their keyword counts, to research/hubspot-pages.csv.
- Use Serpstat top organic pages to look this up and give me the result as a table. Save the result in ./assets.
- Pull the latest numbers from Serpstat top organic pages and tell me what changed since last week.
- Check Serpstat top organic pages and summarize what you find in three bullet points.
- Pull the newest data from Serpstat top organic pages and give me the result as a table.

## How to set up Serpstat top organic pages in opencode

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

### Use Spiral's MCP server

1. **Add the server**: Leave out `--global` to add Spiral to the current project only. No header and no client ID or secret: opencode registers itself with Spiral.

```bash
opencode mcp add spiral --global --url https://api.spiral.ai/mcp
```

2. **Sign in**: Your browser opens. Sign in to Spiral, pick the organization and click Authorize, then return to the terminal. No API key. Inside opencode, `/mcps` starts the same sign-in.

```bash
opencode mcp auth spiral
```

3. **Check it**: Spiral shows as connected.

```bash
opencode mcp list
```

### Use the Spiral skill

1. **Send opencode 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 top organic pages**: 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/domains/top-pages",
    "input": {
      "se": "<se>",
      "domain": "<domain>"
    }
  }'
```

Then paste one of the prompts above: opencode finds Serpstat top organic pages on Spiral, shows the price and runs it.

Setup guide in the docs: https://spiral.ai/docs/quickstarts/opencode

## Serpstat top organic pages tools and prices

- [Serpstat · Top pages by traffic](https://spiral.ai/tools/alexandria/serpstat/domains/top-pages) (Alexandria): Up to $0.034918 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 {"traffic": "desc"} (traffic or keywords). |
| filters |  | — | Serpstat filters for this method, combined with AND. Keys include traffic_from, keywords_from, url_prefix, url_contain, and url_not_contain. |

## What can you do with Serpstat top organic pages in opencode?

Build an SEO research report that connects public business domains to the queries and pages worth investigating. A coding agent can turn Serpstat results into project files, comparison tables, and content research tasks.

### Prepare a competitor research brief

Identify competing domains, compare their overall search performance, inspect ranking queries, and list the pages worth reviewing.

### Plan a content research backlog

Use competitor overlap and domain totals to choose research targets, then turn their ranking queries and leading pages into specific content assignments.

### Compare regional search opportunities

Research the same business domains in separate regional databases. Compare the competitors, domain totals, queries, and pages returned for each market.

### Build a monthly SEO research report

Save successive results to compare competing domains, overall search performance, ranking queries, and leading pages across monthly research runs.

### Choose pages for a content refresh

Find pages with substantial keyword coverage, then examine their ranking queries and positions to select focused revision targets.

## Overview

- [Alexandria](https://spiral.ai/providers/alexandria)
- [All opencode guides](https://spiral.ai/integrations/opencode)

## Serpstat top organic pages in other agents

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

## More opencode guides

- [Serpstat search suggestions](https://spiral.ai/integrations/opencode/serpstat-search-suggestions)
- [Similarweb incoming referral domains](https://spiral.ai/integrations/opencode/similarweb-incoming-referral-domains)
- [Serpstat related keywords](https://spiral.ai/integrations/opencode/serpstat-related-keywords)
- [Similarweb outgoing referral domains](https://spiral.ai/integrations/opencode/similarweb-outgoing-referral-domains)
- [Serpstat referring domains](https://spiral.ai/integrations/opencode/serpstat-referring-domains)
- [Similarweb paid search spend estimates](https://spiral.ai/integrations/opencode/similarweb-paid-search-spend-estimates)

## Questions about Serpstat top organic pages in opencode

**Can opencode use Serpstat top organic pages?**

Yes. Add Spiral to opencode as an MCP server, and opencode can find and run Serpstat top organic pages like any built-in tool.

**How much does Serpstat top organic pages cost in opencode?**

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

**Do I need an Alexandria account to use Serpstat top organic pages in opencode?**

No. Spiral runs Serpstat top organic pages 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 top organic pages in opencode?**

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

**Does opencode wait while Serpstat top organic pages runs?**

Serpstat top organic pages runs in the background. opencode starts the run, checks on it and gives you the json when it's ready.

**How much of Google search does Serpstat cover?**

The domain keywords report covers rankings in Google's top 100 for queries in Serpstat's database. Its documented report limit is 60,000 results, so it should not be treated as a complete inventory of every query a site could rank for.

**How fresh is Serpstat's search data?**

Serpstat says its major US and UK Overview databases update roughly every one to two weeks. A full keyword database update cycle takes approximately three months, so the Overview update interval does not mean every keyword was refreshed.

**Are Serpstat traffic figures actual visitor counts?**

They are estimates calculated from keyword rankings and search volumes. Use them to compare organic search performance between domains rather than as a replacement for a site's analytics.

**Can pagination retrieve an unlimited number of results?**

Serpstat documents a ceiling of 60,000 rows per API method. Pagination works within that ceiling; it does not establish that every matching row from a larger report can be retrieved.

**Does Serpstat disclose all its data suppliers?**

Serpstat says it receives data from third-party services covered by nondisclosure agreements. That disclosure does not identify those suppliers.

