AgentSkillsCN

dataforseo-cli

构建、审查与加固Tauri桌面应用（React/Vite前端）的指南与工作流。在实现Tauri IPC命令、原生API访问、文件系统或对话框集成、窗口/菜单/托盘行为、权限/白名单/CSP、应用生命周期、自动更新器，或打包/发布任务时使用此功能。

SKILL.md
--- frontmatter
name: dataforseo-cli
description: LLM-friendly keyword research CLI for AI agents. Check search volume, CPC, keyword difficulty, and competition via DataForSEO API. Find related keywords, analyze competitor rankings. Outputs TSV by default (optimized for agent context windows). Use when doing SEO research, content planning, or competitive keyword analysis.
license: MIT
metadata:
  author: alexgusevski
  version: "1.0.0"

Keyword Research with dataforseo-cli

LLM-friendly keyword research CLI. Wraps the DataForSEO API and outputs TSV by default — compact, structured, and optimized for agent context windows.

Setup

1. Install from npm

bash
npm install -g dataforseo-cli

2. Authenticate

Before running any data commands, configure your DataForSEO API credentials:

bash
# With login + password
dataforseo-cli --set-credentials login=YOUR_LOGIN password=YOUR_PASSWORD

# Or with base64 token (from DataForSEO email)
dataforseo-cli --set-credentials base64=YOUR_BASE64_TOKEN

Credentials are stored in ~/.config/dataforseo-cli/config.json.

To verify credentials are set, check that the config file exists:

bash
cat ~/.config/dataforseo-cli/config.json

If credentials are missing or invalid, API commands (volume, related, competitor) will fail. The locations and languages commands work without credentials (local data).

Commands

volume — Keyword metrics

Get search volume, CPC, keyword difficulty (0–100), competition level, and 12-month search trend.

bash
dataforseo-cli volume <keywords...> [options]

Arguments:

  • •<keywords...> — One or more keywords (required). Batch multiple keywords in one call to save API requests.

Options:

  • •-l, --location <code> — Location code (default: 2840 = US)
  • •--language <code> — Language code (default: en)
  • •--json — Output as JSON array
  • •--table / --human — Output as human-readable table

Example:

bash
dataforseo-cli volume "seo tools" "keyword research" "backlink checker"

Output (TSV):

code
keyword	volume	cpc	difficulty	competition	trend
seo tools	12500	2.35	45	HIGH	14800,13900,12500,12100,11800,12000,12500,13000,12800,12500,12200,11900
  • •difficulty — 0–100 scale (0-30 easy, 31-60 medium, 61-100 hard)
  • •cpc — Cost per click in USD
  • •competition — LOW / MEDIUM / HIGH
  • •trend — 12 monthly search volumes, newest first

related — Keyword suggestions

Find related keyword ideas from a seed keyword.

bash
dataforseo-cli related <seed> [options]

Arguments:

  • •<seed> — Seed keyword (required, single keyword)

Options:

  • •-l, --location <code> — Location code (default: 2840 = US)
  • •--language <code> — Language code (default: en)
  • •-n, --limit <n> — Max results (default: 50)
  • •--json — Output as JSON array
  • •--table / --human — Output as human-readable table

Example:

bash
dataforseo-cli related "ai agents" -n 20

Output (TSV):

code
keyword	volume	cpc	competition	difficulty
best ai agents	8100	3.10	0.82	52
ai agent framework	2400	1.85	0.65	38

competitor — Domain keyword analysis

See what keywords a domain currently ranks for.

bash
dataforseo-cli competitor <domain> [options]

Arguments:

  • •<domain> — Target domain (required, e.g. ahrefs.com)

Options:

  • •-l, --location <code> — Location code (default: 2840 = US)
  • •--language <code> — Language code (default: en)
  • •-n, --limit <n> — Max results (default: 50)
  • •--json — Output as JSON array
  • •--table / --human — Output as human-readable table

Example:

bash
dataforseo-cli competitor semrush.com -n 10

Output (TSV):

code
keyword	position	volume	cpc	difficulty	url
backlink checker	1	33100	4.50	72	https://ahrefs.com/backlink-checker

locations — Look up location codes

List all available location codes, or filter by name. Works offline — no API credentials needed.

bash
dataforseo-cli locations [search] [--json]

Arguments:

  • •[search] — Optional filter by name (e.g. sweden, new york)

Without search — lists all locations:

bash
dataforseo-cli locations

With search — filters by name:

bash
dataforseo-cli locations sweden

Output (TSV):

code
code	name	country	type
2752	Sweden	SE	Country

languages — Look up language codes

List all available language codes, or filter by name. Works offline — no API credentials needed.

bash
dataforseo-cli languages [search] [--json]

Without search — lists all languages:

bash
dataforseo-cli languages

With search — filters by name:

bash
dataforseo-cli languages swedish

Output (TSV):

code
name	code
Swedish	sv

Output Formats

All data commands default to TSV (tab-separated values) — the most token-efficient structured format for LLMs.

FlagDescription
(default)TSV — fewest tokens, best for agent pipelines
--jsonJSON array — use when you need structured parsing
--table / --humanHuman-readable aligned table — for human review

Caching

Results are cached in ~/.config/dataforseo-cli/cache/ to avoid duplicate API calls and save costs. Same query + location + language = cache hit.

bash
dataforseo-cli --print-cache

Workflow: SEO Article Research

  1. •Start with seed keyword: dataforseo-cli volume "your topic"
  2. •Expand: dataforseo-cli related "your topic" -n 30
  3. •Filter: Pick keywords with volume > 100, difficulty < 60
  4. •Check competitors: dataforseo-cli competitor competitor-domain.com -n 20
  5. •Write article targeting the best keyword cluster

Tips

  • •Batch keywords in volume — DataForSEO charges per API request, not per keyword
  • •Default location is USA (2840). Always set --location for local/international SEO
  • •Use locations and languages without arguments to see all available options
  • •Difficulty scale: 0-30 easy, 31-60 medium, 61-100 hard