CallAI SEO

CallAI — live SEO data for AI agents

中文说明

CallAI gives your AI agent real search data instead of guesses: live Google and Bing results (including the Google AI Overview and the sites it cites), keyword volume and difficulty, long-tail ideas, competitor keyword gaps, domain traffic, backlinks and on-page audits.

It works two ways:

• DeepSeek Harness (dsh) plugin — this npm package, @callaiapi/seo. Installs the tools plus a callai-seo skill that teaches the agent how to do keyword research, competitor analysis, GEO checks and audits.
• Remote MCP server — https://api.callaiapi.com/mcp, for Claude Code, Cursor, VS Code, Cline, Windsurf and any other MCP client. Nothing to install.

Data comes from DataForSEO. Paid tools bill your CallAI balance per call: top up from $1, no subscription, balance never expires. Every result states what that call cost. Seven free tools need only an API key. Anyone can list the tools without a key.

Contents

• 1. Get an API key
• 2. Install in DeepSeek Harness
• 3. Use it in other MCP clients
• 4. What to ask
• 5. Tools reference
• 6. Markets: location and language codes
• 7. Pricing and cost control
• 8. Troubleshooting
• 9. FAQ

1. Get an API key

1. Sign up at https://callaiapi.com/register.
2. Top up any amount from $1 (cards, Apple Pay / Google Pay, or USDT on several chains).
3. Create a key under API Keys: https://callaiapi.com/portal?tab=keys. It looks like sk-live-…. You can set a spend limit per key.

2. Install in DeepSeek Harness

Requires dsh 0.2.0 or later.

dsh plugin --profile web add @callaiapi/seo

Use your own profile name instead of web if you run another one (ls ~/.dsh/profiles). You can also install @callaiapi/seo from a plugin shop such as dsh-plugin-shop. Restart dsh afterwards — a newly added plugin is not loaded into a running process.

Give the plugin your key

The plugin looks for the key in this order and uses the first one it finds:

Profile patch, in ~/.dsh/profiles/ /cordis.patch.yml:

- id: callai-seo

config: apiKey: sk-live-your-key

.env file, in ~/.dsh/.env:

CALLAI_API_KEY=sk-live-your-key

Saving the credential through dsh reconnects automatically; changes to the patch file, .env or the environment take effect after a dsh restart.

Check it works

Start a session and ask *"Which mcp__callai tools do you have?"* — the agent should list 20 tools, and *"Audit https://example.com"* should come back with real data and a billed_usd line.

Plugin settings

Uninstall

dsh plugin --profile web remove @callaiapi/seo

3. Use it in other MCP clients

Claude Code

claude mcp add --transport http callai https://api.callaiapi.com/mcp \

--header "Authorization: Bearer sk-live-your-key"

Cursor — .cursor/mcp.json in your project, or ~/.cursor/mcp.json:

{

"mcpServers": { "callai": { "url": "https://api.callaiapi.com/mcp", "headers": { "Authorization": "Bearer sk-live-your-key" } } } }

VS Code (Copilot agent mode) — .vscode/mcp.json:

{

"inputs": [ { "type": "promptString", "id": "callai-key", "description": "CallAI API key", "password": true } ], "servers": { "callai": { "type": "http", "url": "https://api.callaiapi.com/mcp", "headers": { "Authorization": "Bearer ${input:callai-key}" } } } }

Windsurf, Cline and other clients — add a remote / Streamable HTTP server with the URL and header above. Clients that only support local (stdio) servers can bridge with mcp-remote:

{

"mcpServers": { "callai": { "command": "npx", "args": ["-y", "mcp-remote", "https://api.callaiapi.com/mcp", "--header", "Authorization:${AUTH_HEADER}"], "env": { "AUTH_HEADER": "Bearer sk-live-your-key" } } } }

4. What to ask

You don't call tools yourself — describe the job and the agent picks the tools. Examples:

• *"Find long-tail keywords about standing desks for the UK with difficulty under 30, then check who ranks for the top three."*
• *"Compare my site example.com with competitor.com: traffic, the keywords they rank for that I don't, and backlink strength."*
• *"Does Google show an AI Overview for 'best crm for startups'? Which sites does it cite, and is mine one of them?"*
• *"Audit https://example.com/pricing and give me a fix list."*
• *"I'm about to buy the expired domain old-brand.com. Check its backlinks and spam score."*
• *"Get search volume and CPC for these 40 keywords in Germany, German language: …"*

5. Tools reference

In dsh the tools appear as mcp__callai__ ; other clients show . Every result is JSON with billed_usd (what the call cost) and result. Parameters marked * are required. Every tool except the backlink and audit tools also accepts location_code and language_code (section 6).

Free tools

These need an API key but no balance, within a daily allowance of 200 units per account. keyword_suggestions counts 1 unit in seed mode, 3 in questions and 5 in az; the others count 1.

Domains can be given as example.com, www.example.com or a full URL.

6. Markets: location and language codes

Default market: United States (location_code 2840), English (language_code en). Tell the agent the market in plain words ("for Germany, in German") and it sets the codes.

Full list: DataForSEO locations.

7. Pricing and cost control

Calls are billed at the DataForSEO cost plus CallAI's margin; the exact amount is in each result's billed_usd and in your console call log. Typical costs:

A full keyword research session (ideas → metrics → SERP checks for five keywords) usually costs well under $0.10.

To keep spend predictable:

• Set a spend limit on the key in the console; calls stop when it is reached.
• The bundled skill tells the agent to batch keywords, start with small limits, and say before a run that would cost more than about $0.50.
• When the balance runs out, tools return *"Insufficient CallAI balance"* with the top-up link; nothing is charged for refused calls.

8. Troubleshooting

| `Task fa