# DataForSEO through toolfare

> The live Google organic results for a keyword, in position order, for the country and language you name — answered inside ChatGPT, Claude, Codex or Cursor. You need no DataForSEO account and no API key of your own: toolfare runs each search, tells your AI the price before it runs, and charges the cost DataForSEO reports for it.

Page: https://toolfare.ai/dataforseo

## Use it from your agent

Paste this into Claude Code, Codex, Cursor or any agent with a shell:

> Set up https://toolfare.ai/skill.md, then use toolfare to answer: What ranks on Google for “crm for agencies” right now?

Apps without a terminal connect toolfare as an MCP server: https://toolfare.ai/docs#connect

## Use it from a script

```sh
mkdir -p ~/.local/bin
curl -fsSL 'https://toolfare.ai/toolfare/toolfare.mjs' -o ~/.local/bin/toolfare
chmod +x ~/.local/bin/toolfare
export PATH="$HOME/.local/bin:$PATH"
export TOOLFARE_MCP_URL='https://api.toolfare.ai/mcp'
toolfare login
```

Sign in once per machine; the CLI renews the sign-in itself. On a CI runner or another server, create an API key in the toolfare console and set it as `TOOLFARE_API_KEY` instead of signing in. Paid calls on one sign-in or key run one at a time. `--max-cost` refuses a call quoted above that many credits (1,000 credits = $3).

## Tools

### What ranks on Google, in order

Tool: `serp_google_organic`

Live Google organic results for one keyword — each result’s position, title and URL — for a location and language you choose, United States and English unless you say otherwise.

Ask:
- What ranks on Google for “crm for agencies” right now?
- Who is in the top ten for “marketing automation” in the UK?

## Price

Quoted to your AI before the search runs, then charged at the cost DataForSEO reports for that exact search. Metered from the `cost` field DataForSEO returns inside its own response, so the charge follows DataForSEO’s own price for the search rather than a table kept here. No fixed price table, on purpose: an upstream reprice needs no change here. A search that fails is never charged.

Balances and top-ups are in US dollars. Quotes and `--max-cost` count credits: 1,000 credits = $3 ($0.003 each).

## Use it when

- You want to know what currently ranks for a keyword, not what an index estimated last month.
- You are checking a ranking from a specific country or language.
- You want the pages you are up against before writing one.

## Look elsewhere when

- You want your own site’s clicks and positions. Search Console has them exactly, and reading your own account is free.
- You want ads, People Also Ask or other engines as well as organic links. Ask a full results-page source.
- You want keyword volume, difficulty or backlinks. That is an SEO index, not a live results page.

## Limits

- Organic results only — no ads, maps or other results-page features.
- Location is DataForSEO’s full location name, such as “United States”; language is a two-letter code.
- Pay as you go from your toolfare balance, in US dollars; there is no subscription. A call runs when your balance covers its quote.
