How to Use Google organic search rankings in Claude 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.
Prompts to try with Google organic search rankings in Claude Code
Copy an example into Claude Code, or ask in your own words.
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 Claude Code
Pick the way that suits you. Each takes about two minutes.
Use Spiral's MCP server
- Add the hosted server
This adds Spiral to the current project. Add --scope user to use it in every project.
claude mcp add --transport http spiral https://api.spiral.ai/mcp
- 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
- Send Claude Code this message
Your agent reads Spiral's skill and sets itself up.
set up https://spiral.ai/SKILL.md
- Sign in or paste a key
Approve Spiral in the browser, or give the agent a key from the console.
Use the Spiral CLI
- Install and sign in
Installs the Spiral CLI, signs you in and adds its skill to your coding agents.
npx -y spiral-cli@latest init
Call the Spiral API
- Create an API key
In the console, under API keys.
- Run Google organic search rankings
One request; the result comes back by polling or a webhook.
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: Claude Code finds Google organic search rankings on Spiral, shows the price and runs it.
Google organic search rankings providers and prices
Spiral runs Google organic search rankings through Alexandria. Open a card for today's price, with every fee included.
Settings you can ask for
Ask Claude Code for any of these in your prompt.
| Setting | Allowed values | Default | Description |
|---|---|---|---|
| Os | windows, macos, android, or 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 or mobile | desktop (default) or mobile. | |
| Location code | a number | DataForSEO location code, such as 2840 for the United States. Use this or location_name. |
Every API field of DataForSEO · Google organic SERP is on its tool page: open its card above.
What can you do with Google organic search rankings in Claude 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.
More on Google organic search rankings and Claude Code
Overview
Google organic search rankings in other agents
Questions about Google organic search rankings in Claude Code
Can Claude Code use Google organic search rankings?
Yes. Add Spiral to Claude Code as an MCP server, and Claude Code can find and run Google organic search rankings like any built-in tool.
How much does Google organic search rankings cost in Claude 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 Claude Code plan is separate.
Do I need an Alexandria account to use Google organic search rankings in Claude 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 Claude Code?
About two minutes: add the hosted server, then sign in.
Does Claude Code wait while Google organic search rankings runs?
Google organic search rankings runs in the background. Claude 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.
Start using Google organic search rankings in Claude Code
One Spiral account for every tool your agent needs. No subscription; you pay per run.
Paste this into Claude Code:
set up https://spiral.ai/SKILL.md


