Spiral gives your agent every tool with one account. Browse the tools →

Factory Droid · SEO

How to Use DataForSEO Google ranking keywords in Factory Droid

Get keywords a domain or page ranks for on Google, including search volume, ranking URLs, positions, and traffic estimates. Use it to identify specific pages and queries worth improving.

Prompts to try with DataForSEO Google ranking keywords in Factory Droid

Copy an example into Factory Droid, or ask in your own words.

Use DataForSEO Google ranking keywords for hubspot.com in United States English. Create a CSV of 50 organic keywords ranking in positions 11 through 20, with search volume and ranking URL.

DataForSEO Google ranking keywordsFactory Droid
Try asking
  • Use DataForSEO Google ranking keywords for canva.com in United Kingdom English. Group the returned organic keywords by ranking URL and add the results to the project's research report.

  • Use DataForSEO Google ranking keywords to look this up and give me the result as a table. Save the result in ./assets.

  • Pull the latest numbers from DataForSEO Google ranking keywords and tell me what changed since last week.

  • Check DataForSEO Google ranking keywords and summarize what you find in three bullet points.

How to set up DataForSEO Google ranking keywords in Factory Droid

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

Use Spiral's MCP server

  1. Add the server

    Droid saves it to your user config, ~/.factory/mcp.json, so it works in every project.

    droid mcp add spiral https://api.spiral.ai/mcp --type http
  2. Sign in

    Start droid, type /mcp, select spiral and authenticate it. Sign in to Spiral in the browser and click Authorize. No API key.

  3. Check it

    Spiral shows as connected. needs authentication means the sign-in did not finish: run /mcp again.

    droid mcp list

Use the Spiral skill

  1. Send Factory Droid 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.

    npx -y spiral-cli@latest init

Call the Spiral API

  1. Create an API key

    In the console, under API keys.

  2. Run DataForSEO Google ranking keywords

    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/domains/ranked-keywords",
        "input": {
          "target": "<target>"
        }
      }'

Then paste one of the prompts above: Factory Droid finds DataForSEO Google ranking keywords on Spiral, shows the price and runs it.

DataForSEO Google ranking keywords providers and prices

Spiral runs DataForSEO Google ranking keywords through Alexandria. Open a card for today's price, with every fee included.

AlexandriaSEO
DataForSEO · Ranked keywords
dataforseo/domains/ranked-keywords

Settings you can ask for

Ask Factory Droid for any of these in your prompt.

SettingAllowed valuesDefaultDescription
Limit1 to 700100

Items to return, 1 to 700. DataForSEO allows 1000 (its default is 100); this connector stops at 700 so a call stays within 100 credits. Omitted, 100 is sent.

Offseta number from 0

Items to skip, for the next page. Default 0.

Location codea number

DataForSEO location code, such as 2840 for the United States. Use this or location_name.

Ignore synonymson or off

Return only core keywords. Default false.

Load rank absoluteon or off

Add metrics_absolute, the distribution by rank_absolute. Default false.

Historical serp modelive, lost, or all

live (default) for current rankings, lost for lost ones, or all.

Every API field of DataForSEO · Ranked keywords is on its tool page: open its card above.

What can you do with DataForSEO Google ranking keywords in Factory Droid?

Build a Google search visibility report for the business domains in your project. Use DataForSEO's ranking data to populate comparisons and label traffic figures as estimates.

Build a competitive search baseline

Find domains sharing a company's Google ranking keywords, compare their overall ranking distributions, and inspect the queries and URLs behind those totals.

Prepare a content planning brief

Choose competitors using keyword overlap, compare their search visibility, and collect ranking keywords and URLs to propose topics for editorial review.

Compare search markets

Research the same business in two countries. Compare the competing domains, overall ranking distribution, and individual ranking queries returned for each market.

Create a recurring SEO report

Save successive reports and compare competitor overlap, ranking bands, and keyword positions. Describe changes as differences between DataForSEO snapshots.

Review a business's search presence

For an acquisition or partnership review, examine which domains compete in search, how rankings are distributed, and which keywords and pages contribute estimated traffic.

Compare organic and paid visibility

Identify competing domains, compare organic and paid ranking summaries, and examine the ranking keywords behind each channel before proposing further research.

Questions about DataForSEO Google ranking keywords in Factory Droid

Can Factory Droid use DataForSEO Google ranking keywords?

Yes. Add Spiral to Factory Droid as an MCP server, and Factory Droid can find and run DataForSEO Google ranking keywords like any built-in tool.

How much does DataForSEO Google ranking keywords cost in Factory Droid?

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

Do I need an Alexandria account to use DataForSEO Google ranking keywords in Factory Droid?

No. Spiral runs DataForSEO Google ranking keywords on its own Alexandria account. You sign in to Spiral once and never paste a key.

How long does it take to set up DataForSEO Google ranking keywords in Factory Droid?

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

Does Factory Droid wait while DataForSEO Google ranking keywords runs?

DataForSEO Google ranking keywords runs in the background. Factory Droid starts the run, checks on it and gives you the json when it's ready.

Where does DataForSEO get this domain data?

DataForSEO Labs uses its own keyword and search result databases. These endpoints describe Google search rankings and estimated search traffic.

How often are these domain reports updated?

The endpoint documentation specifies weekly updates. Ranked Keywords and Competitors Domain use storage that is refreshed weekly from the underlying databases.

Does a weekly update mean every Google result was checked that week?

No. The underlying SERP database takes 30 to 90 days to refresh, depending on query popularity and location.

How fresh are the search volume metrics?

DataForSEO updates underlying keyword metrics monthly following the Google Ads update cycle. Search volume and ranking data therefore have different refresh schedules.

Are traffic figures measured website visits?

No. Estimated Traffic Volume combines keyword search volume with expected click-through rate. The reports estimate monthly traffic from search.

Get started

Start using DataForSEO Google ranking keywords in Factory Droid

One Spiral account for every tool your agent needs. No subscription; you pay per run.

Paste this into Factory Droid:

Set up Factory Droid

set up https://spiral.ai/SKILL.md
Are you an AI agent? See setup options