How to Use Google organic search rankings in opencode
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 opencode
Copy an example into opencode, 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 opencode
Pick the way that suits you. Each takes about two minutes.
Use Spiral's MCP server
- 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.
opencode mcp add spiral --global --url https://api.spiral.ai/mcp
- 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.
opencode mcp auth spiral
- Check it
Spiral shows as connected.
opencode mcp list
Use the Spiral skill
- Send opencode 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: opencode 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 opencode 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 opencode?
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 opencode
Overview
Google organic search rankings in other agents
Questions about Google organic search rankings in opencode
Can opencode use Google organic search rankings?
Yes. Add Spiral to opencode as an MCP server, and opencode can find and run Google organic search rankings like any built-in tool.
How much does Google organic search rankings 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 Google organic search rankings in opencode?
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 opencode?
About two minutes: add the server, then sign in, then check it.
Does opencode wait while Google organic search rankings runs?
Google organic search rankings runs in the background. opencode 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 opencode
One Spiral account for every tool your agent needs. No subscription; you pay per run.
Paste this into opencode:
set up https://spiral.ai/SKILL.md


