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

Windsurf · SEO

How to Use DataForSEO Google ranking keywords in Windsurf

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 Windsurf

Copy an example into Windsurf, 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 keywordsWindsurf
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 Windsurf

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

Use Spiral's MCP server

  1. Add the server

    Open the Customize page from the Agents window and click MCPs. Under This computer, open the config file, or edit it directly: ~/.config/devin/mcp_config.json on macOS and Linux, %APPDATA%\devin\mcp_config.json on Windows. Add this:

    {
      "mcpServers": {
        "spiral": {
          "url": "https://api.spiral.ai/mcp"
        }
      }
    }
  2. Sign in

    Click Authenticate on the Spiral server in Customize › MCPs, or let the agent call Spiral once: your browser opens. Sign in to Spiral, pick the organization and click Authorize. No API key.

    devin mcp login spiral
  3. Check it

    Spiral is listed under This computer in Customize › MCPs. From the terminal:

    devin mcp list

Use the Spiral skill

  1. Send Windsurf 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: Windsurf 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 Windsurf 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 Windsurf?

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 Windsurf

Can Windsurf use DataForSEO Google ranking keywords?

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

How much does DataForSEO Google ranking keywords cost in Windsurf?

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

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

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 Windsurf?

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

Does Windsurf wait while DataForSEO Google ranking keywords runs?

DataForSEO Google ranking keywords runs in the background. Windsurf 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 Windsurf

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

Paste this into Windsurf:

Set up Windsurf

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