# Tool Dataforseo

> >-

- **Type:** Skill
- **Install:** `agentstack add skill-b2bforce-b2bforce-tool-dataforseo`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [b2bforce](https://agentstack.voostack.com/s/b2bforce)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [b2bforce](https://github.com/b2bforce)
- **Source:** https://github.com/b2bforce/b2bforce/tree/main/.agents/skills/tool-dataforseo
- **Website:** https://www.b2bforce.ai/

## Install

```sh
agentstack add skill-b2bforce-b2bforce-tool-dataforseo
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# Tool: DataForSEO

Thin wrapper for the [DataForSEO](https://dataforseo.com) API — SERP results and
keyword data. Other skills call this instead of re-describing the API.

## Requirements

- `curl`
- `jq`
- `.env` credentials listed below

## Auth

`.env`:

```bash
DATAFORSEO_LOGIN=
DATAFORSEO_PASSWORD=
```

HTTP Basic auth (`login:password`). Base: `https://api.dataforseo.com/v3`.
Request bodies are an **array of task objects**.

## Endpoints

| Action | Endpoint | Use |
|--------|----------|-----|
| SERP | `POST /serp/google/organic/live/advanced` | Top organic results for a phrase |
| Keyword volume | `POST /keywords_data/google_ads/search_volume/live` | Search volume / CPC / competition |
| Account | `POST /appendix/user_data` | Check balance / credentials |

`location_name` uses DataForSEO format, e.g. `"Poland"`, `"United States"`.

## Scripts

```bash
# Top 10 organic results for a phrase + country (prints url + title list)
bash .agents/skills/tool-dataforseo/scripts/serp.sh "drupal migration agency" "Poland"

# Keyword search volume (prints JSON)
bash .agents/skills/tool-dataforseo/scripts/keyword.sh "drupal migration" "Poland"
```

## Rules

1. Credentials from `.env` only.
2. Paid API — cache results in `workspace/` where possible; don't re-query.
3. For competitor discovery, dedupe by **root domain** after fetching.
4. Degrade gracefully if unset — calling skills should fall back to AI research.

## Used by

`intel-competitor-discovery` (SERP), `marketing-seo-research` (keywords),
`marketing-service-page` (SERP).

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [b2bforce](https://github.com/b2bforce)
- **Source:** [b2bforce/b2bforce](https://github.com/b2bforce/b2bforce)
- **License:** MIT
- **Homepage:** https://www.b2bforce.ai/

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** yes
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** yes
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-b2bforce-b2bforce-tool-dataforseo
- Seller: https://agentstack.voostack.com/s/b2bforce
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.