DataForSEO Skill

Public-safe CLI and skill for querying DataForSEO keyword and SERP-adjacent data from AI agent workflows.

Privacy

This repository is designed to be publishable with only fake examples. Real DataForSEO credentials belong in .env, shell environment variables, or a secret manager. Do not commit API responses that contain private target domains or paid research artifacts unless they are intentionally public.

Install

uv venv .venv
.venv/bin/uv pip install -e '.[dev]'

Authentication

Use either DATAFORSEO_AUTH_BASE64 or DATAFORSEO_LOGIN plus DATAFORSEO_PASSWORD.

export DATAFORSEO_AUTH_BASE64=replace-with-base64-login-colon-password

Examples

.venv/bin/dataforseo-skill balance
.venv/bin/dataforseo-skill keyword-suggestions "agent harness" --limit 10 --location-code 2840 --language-code en
.venv/bin/dataforseo-skill related-keywords "claude code" --limit 10
.venv/bin/dataforseo-skill keywords-for-site example.com --limit 20
.venv/bin/dataforseo-skill --base-url https://sandbox.dataforseo.com keyword-suggestions "agent harness" --limit 3

Skill

The root skill is skills/dataforseo.md. To install it into another workspace, add a pointer from that workspace's skill index or agent instructions to this file.