[Integrations](https://spiral.ai/integrations) › [Muse Code](https://spiral.ai/integrations/muse-code) › [Google organic search rankings](https://spiral.ai/integrations/muse-code/google-organic-search-rankings)

# How to Use Google organic search rankings in Muse Code

Get Google result URLs, titles, descriptions, organic ranks, and positions alongside search features for a keyword. Use it to track rankings or compare competing pages in a specific search market.

|  |  |
| --- | --- |
| Model | Google organic search rankings |
| 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 Google organic search rankings in Muse Code

- Use Google organic search rankings for 'email marketing software' in the United States in English on desktop. Add a report to this project listing the returned organic URLs, titles, and both rank measures, with mailchimp.com highlighted.
- Use Google organic search rankings for 'project management software' in the United States in English on desktop. Compare asana.com, monday.com, and clickup.com in the returned listings and save their best organic positions to the project's reporting table.
- Use Google organic search rankings for 'running shoes' in London, England, in English on mobile. Create a CSV in this project containing organic domains, URLs, titles, and descriptions.
- Use Google organic search rankings for 'accounting software' in the United States in English on desktop. Compare the returned quickbooks.intuit.com URL with the latest saved observation in this project and report any landing page change.
- Use Google organic search rankings for 'customer support software' in the United States in English on desktop. Build a table in this project's SEO report that separates organic rank from absolute position and lists the search feature types returned.

## How to set up Google organic search rankings in Muse Code

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

### Use Spiral's MCP server

1. **Install Muse Code**

```bash
curl -fsSL https://dev.meta.ai/install.sh | bash
```

2. **Ask Muse to add the server**: Start `muse` and ask:

```text
Add the Spiral MCP server at https://api.spiral.ai/mcp
```

3. **Sign in**: In your terminal, run:

```bash
muse mcp login spiral
```

### Use the Spiral skill

1. **Send Muse 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 organic search rankings**: 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/serp/google-organic",
    "input": {
      "keyword": "<keyword>",
      "language_code": "<language_code>",
      "location_code": 1
    }
  }'
```

Then paste one of the prompts above: Muse Code finds Google organic search rankings on Spiral, shows the price and runs it.

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

## Google organic search rankings tools and prices

- [DataForSEO · Google organic SERP](https://spiral.ai/tools/alexandria/dataforseo/serp/google-organic) (Alexandria): Up to $0.034918 per run.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| os | windows, macos, android, ios | — | windows or macos on desktop, android or ios on mobile. |
| depth | 1 to 100 | 10 | Results to parse, 1 to 100. Each started 10 is one billed SERP page. DataForSEO allows 200; this connector stops at 100. Omitted, 10 is sent. |
| device | desktop, mobile | — | desktop (default) or mobile. |
| se_domain |  | — | Google domain to search, such as google.co.uk. Chosen from the location when omitted. |
| 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. |

## What can you do with Google organic search rankings in Muse Code?

Build a ranking report that shows which Google URL represents a business for each tracked query. A coding agent can combine returned ranks, titles, and URLs with the project's saved observations to flag position and landing page changes.

### Track a business website's organic position

Collect results for a fixed keyword and market, find the business domain, and compare its organic rank across saved observations.

### Identify competing pages

List the domains and URLs ranking for a commercial query to see which pages compete for the same search results.

### Prepare a content brief

Review ranking titles and search descriptions for a target query, then propose an outline based on the topics visible in those results.

### Compare search markets

Run the same query in two cities or countries and compare the returned domains, landing pages, and positions.

### Compare mobile and desktop rankings

Check the same keyword and location on mobile and desktop, then report differences in organic position and surrounding search features.

### Watch landing page changes

Compare saved results to detect when a business domain starts ranking with a different URL for a tracked keyword.

### Explain changes in search placement

Compare organic rank with absolute position and inspect returned search features to distinguish listing movement from changes around the listing.

## Overview

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

## Google organic search rankings in other agents

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

## More Muse Code guides

- [Google long-tail keywords](https://spiral.ai/integrations/muse-code/google-long-tail-keywords)
- [Google paid and organic keyword overview](https://spiral.ai/integrations/muse-code/google-paid-and-organic-keyword-overview)
- [Google keyword search intent](https://spiral.ai/integrations/muse-code/google-keyword-search-intent)
- [Icons Computer app icon details](https://spiral.ai/integrations/muse-code/icons-computer-app-icon-details)
- [Google keyword ideas](https://spiral.ai/integrations/muse-code/google-keyword-ideas)
- [Icons Computer app icon search](https://spiral.ai/integrations/muse-code/icons-computer-app-icon-search)

## Questions about Google organic search rankings in Muse Code

**Can Muse Code use Google organic search rankings?**

Yes. Add Spiral to Muse Code as an MCP server, and Muse Code can find and run Google organic search rankings like any built-in tool.

**How much does Google organic search rankings cost in Muse Code?**

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 Muse Code plan is separate.

**Do I need an Alexandria account to use Google organic search rankings in Muse Code?**

No. Spiral runs Google organic search rankings 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 organic search rankings in Muse Code?**

About two minutes: install Muse Code, then ask Muse to add the server, then sign in.

**Does Muse Code wait while Google organic search rankings runs?**

Google organic search rankings runs in the background. Muse Code starts the run, checks on it and gives you the json when it's ready.

**How fresh are the Google rankings?**

DataForSEO collects search results after the request is submitted. These are observations from that collection, rather than rankings supplied from an outdated database.

**Why can a result have two different rank numbers?**

Organic rank counts only organic listings. Absolute rank counts other search elements too, so an organic listing can hold first place organically while appearing below another search feature.

**Will the results match my personal Google searches?**

DataForSEO excludes search history and user preferences. Its results therefore do not reproduce the personalization in your own Google session.

**Does the returned item count equal the number of organic listings?**

No. The item count covers entries in the returned results array, which can include search features alongside organic listings. Count organic entries separately when reporting organic coverage.

**Can I compare rankings collected in different cities?**

Each observation belongs to one keyword, location, and device. Keep cities separate in a ranking report so a location difference does not appear as a ranking change.

