{"id":"81ca563b-ad9d-48a1-9a71-5b7a4f842a0a","entityType":"agent","slug":"clawhub-skills-alexgusevski-dataforseo-cli","name":"dataforseo-cli","canonicalUrl":"https://www.xpersona.co/agent/clawhub-skills-alexgusevski-dataforseo-cli","canonicalPath":"/agent/clawhub-skills-alexgusevski-dataforseo-cli","generatedAt":"2026-10-09T11:20:18.503Z","source":"CLAWHUB","claimStatus":"UNCLAIMED","verificationTier":"NONE","summary":{"evidence":{"source":"editorial-content","verified":true,"confidence":"high","updatedAt":"2026-04-15T00:45:39.800Z","emptyReason":null},"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. --- 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","descriptionLabel":"Technical summary","evidenceSummary":"Capability contract not published. No trust telemetry is available yet. Last updated 4/15/2026.","installCommand":"clawhub skill install skills:alexgusevski:dataforseo-cli","sourceUrl":"https://github.com/openclaw/skills/tree/main/skills/alexgusevski/dataforseo-cli","homepage":null,"primaryLinks":[{"label":"View on ClawHub","url":"https://github.com/openclaw/skills/tree/main/skills/alexgusevski/dataforseo-cli","kind":"source"}],"safetyScore":84,"overallRank":62,"popularityScore":50,"trustScore":null,"claimedByName":null,"isOwner":false,"seoDescription":"LLM-friendly keyword research CLI for AI agents. Check search volume, CPC, keyword difficulty, and competition via DataForSEO API. Find related keywords, analyz"},"coverage":{"evidence":{"source":"public-profile","verified":false,"confidence":"medium","updatedAt":"2026-04-15T00:45:39.800Z","emptyReason":null},"protocols":[{"protocol":"OPENCLEW","label":"OpenClaw","status":"self-declared","notes":"Declared in the public agent profile."}],"capabilities":[],"verifiedCount":0,"selfDeclaredCount":1,"capabilityMatrix":{"rows":[{"key":"OPENCLEW","type":"protocol","support":"unknown","confidenceSource":"profile","notes":"Listed on profile"}],"flattenedTokens":"protocol:OPENCLEW|unknown|profile"}},"adoption":{"evidence":{"source":"no-adoption-signals","verified":false,"confidence":"low","updatedAt":"2026-04-15T00:45:39.800Z","emptyReason":"No source adoption metrics were available."},"stars":null,"forks":null,"downloads":null,"packageName":null,"latestVersion":null,"tractionLabel":null},"release":{"evidence":{"source":"agent-index","verified":false,"confidence":"medium","updatedAt":"2026-02-25T05:58:39.032Z","emptyReason":null},"lastUpdatedAt":"2026-04-15T00:45:39.800Z","lastCrawledAt":"2026-02-25T05:58:39.032Z","lastIndexedAt":null,"nextCrawlAt":"2026-02-26T05:58:39.032Z","lastVerifiedAt":null,"highlights":[]},"execution":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No published capability contract is available yet."},"installCommand":"clawhub skill install skills:alexgusevski:dataforseo-cli","setupComplexity":"low","setupSteps":["Setup complexity is LOW. This package is likely designed for quick installation with minimal external side-effects.","Final validation: Expose the agent to a mock request payload inside a sandbox and trace the network egress before allowing access to real customer data."],"contract":{"contractStatus":"missing","authModes":[],"requires":[],"forbidden":[],"supportsMcp":false,"supportsA2a":false,"supportsStreaming":false,"inputSchemaRef":null,"outputSchemaRef":null,"dataRegion":null,"contractUpdatedAt":null,"sourceUpdatedAt":null,"freshnessSeconds":null},"invocationGuide":{"preferredApi":{"snapshotUrl":"https://www.xpersona.co/api/v1/agents/clawhub-skills-alexgusevski-dataforseo-cli/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-skills-alexgusevski-dataforseo-cli/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-skills-alexgusevski-dataforseo-cli/trust"},"curlExamples":["curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-skills-alexgusevski-dataforseo-cli/snapshot\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-skills-alexgusevski-dataforseo-cli/contract\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-skills-alexgusevski-dataforseo-cli/trust\""],"jsonRequestTemplate":{"query":"summarize this repo","constraints":{"maxLatencyMs":2000,"protocolPreference":["OPENCLEW"]}},"jsonResponseTemplate":{"ok":true,"result":{"summary":"...","confidence":0.9},"meta":{"source":"CLAWHUB","generatedAt":"2026-10-09T11:20:18.503Z"}},"retryPolicy":{"maxAttempts":3,"backoffMs":[500,1500,3500],"retryableConditions":["HTTP_429","HTTP_503","NETWORK_TIMEOUT"]}},"endpoints":{"dossierUrl":"https://www.xpersona.co/api/v1/agents/clawhub-skills-alexgusevski-dataforseo-cli/dossier","snapshotUrl":"https://www.xpersona.co/api/v1/agents/clawhub-skills-alexgusevski-dataforseo-cli/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-skills-alexgusevski-dataforseo-cli/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-skills-alexgusevski-dataforseo-cli/trust"}},"reliability":{"evidence":{"source":"runtime-metrics","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No trust, reliability, or runtime telemetry is available."},"trust":{"status":"unavailable","handshakeStatus":"UNKNOWN","verificationFreshnessHours":null,"reputationScore":null,"p95LatencyMs":null,"successRate30d":null,"fallbackRate":null,"attempts30d":null,"trustUpdatedAt":null,"trustConfidence":"unknown","sourceUpdatedAt":null,"freshnessSeconds":null},"decisionGuardrails":{"doNotUseIf":["Contract metadata is missing or unavailable for deterministic execution."],"safeUseWhen":[],"riskFlags":["missing_or_unavailable_contract","trust_data_unavailable","schema_references_missing"],"operationalConfidence":"low"},"executionMetrics":{"observedLatencyMsP50":null,"observedLatencyMsP95":null,"estimatedCostUsd":null,"uptime30d":null,"rateLimitRpm":null,"rateLimitBurst":null,"lastVerifiedAt":null,"verificationSource":null},"runtimeMetrics":{"successRate":null,"avgLatencyMs":null,"avgCostUsd":null,"hallucinationRate":null,"retryRate":null,"disputeRate":null,"p50Latency":null,"p95Latency":null,"lastUpdated":null}},"benchmarks":{"evidence":{"source":"no-benchmark-data","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No benchmark suites or observed failure patterns are available."},"suites":[],"failurePatterns":[]},"artifacts":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"high","updatedAt":"2026-04-15T00:45:39.800Z","emptyReason":null},"readme":"---\nname: dataforseo-cli\ndescription: 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.\nlicense: MIT\nmetadata:\n  author: alexgusevski\n  version: \"1.0.6\"\n---\n\n# Keyword Research with dataforseo-cli\n\nLLM-friendly keyword research CLI. Wraps the DataForSEO API and outputs TSV by default — compact, structured, and optimized for agent context windows.\n\n**npm:** https://www.npmjs.com/package/dataforseo-cli\n**GitHub:** https://github.com/alexgusevski/dataforseo-cli\n\n## Setup\n\n### 1. Install from npm\n\n```bash\nnpm install -g dataforseo-cli\n```\n\n### 2. Check credentials\n\n```bash\ndataforseo-cli status\n```\n\nIf credentials are already configured, you're good to go. If not, authenticate:\n\n```bash\n# With login + password\ndataforseo-cli --set-credentials login=YOUR_LOGIN password=YOUR_PASSWORD\n\n# Or with base64 token (from DataForSEO email)\ndataforseo-cli --set-credentials base64=YOUR_BASE64_TOKEN\n```\n\nCredentials are stored in `~/.config/dataforseo-cli/config.json`. The `locations` and `languages` commands work without credentials (local data).\n\n## Commands\n\n### `status` — Check credentials\n\nCheck if API credentials are configured without making any API calls.\n\n```bash\ndataforseo-cli status\n```\n\nExits 0 if configured, exits 1 if not. Shows login username (not password).\n\n### `volume` — Keyword metrics\n\nGet search volume, CPC, keyword difficulty (0–100), competition level, and 12-month search trend.\n\n```bash\ndataforseo-cli volume <keywords...> [options]\n```\n\n**Arguments:**\n- `<keywords...>` — One or more keywords (required). Batch multiple keywords in one call to save API requests.\n\n**Options:**\n- `-l, --location <code>` — Location code (default: `2840` = US)\n- `--language <code>` — Language code (default: `en`)\n- `--json` — Output as JSON array\n- `--table` / `--human` — Output as human-readable table\n\n**Example:**\n```bash\ndataforseo-cli volume \"seo tools\" \"keyword research\" \"backlink checker\"\n```\n\n**Output (TSV):**\n```\nkeyword\tvolume\tcpc\tdifficulty\tcompetition\ttrend\nseo tools\t12500\t2.35\t45\tHIGH\t14800,13900,12500,12100,11800,12000,12500,13000,12800,12500,12200,11900\n```\n\n- `difficulty` — 0–100 scale (0-30 easy, 31-60 medium, 61-100 hard)\n- `cpc` — Cost per click in USD\n- `competition` — LOW / MEDIUM / HIGH\n- `trend` — 12 monthly search volumes, newest first\n\n### `related` — Keyword suggestions\n\nFind related keyword ideas from a seed keyword.\n\n```bash\ndataforseo-cli related <seed> [options]\n```\n\n**Arguments:**\n- `<seed>` — Seed keyword (required, single keyword)\n\n**Options:**\n- `-l, --location <code>` — Location code (default: `2840` = US)\n- `--language <code>` — Language code (default: `en`)\n- `-n, --limit <n>` — Max results (default: `50`)\n- `--json` — Output as JSON array\n- `--table` / `--human` — Output as human-readable table\n\n**Example:**\n```bash\ndataforseo-cli related \"ai agents\" -n 20\n```\n\n**Output (TSV):**\n```\nkeyword\tvolume\tcpc\tcompetition\tdifficulty\nbest ai agents\t8100\t3.10\t0.82\t52\nai agent framework\t2400\t1.85\t0.65\t38\n```\n\n### `competitor` — Domain keyword analysis\n\nSee what keywords a domain currently ranks for.\n\n```bash\ndataforseo-cli competitor <domain> [options]\n```\n\n**Arguments:**\n- `<domain>` — Target domain (required, e.g. `ahrefs.com`)\n\n**Options:**\n- `-l, --location <code>` — Location code (default: `2840` = US)\n- `--language <code>` — Language code (default: `en`)\n- `-n, --limit <n>` — Max results (default: `50`)\n- `--json` — Output as JSON array\n- `--table` / `--human` — Output as human-readable table\n\n**Example:**\n```bash\ndataforseo-cli competitor semrush.com -n 10\n```\n\n**Output (TSV):**\n```\nkeyword\tposition\tvolume\tcpc\tdifficulty\turl\nbacklink checker\t1\t33100\t4.50\t72\thttps://ahrefs.com/backlink-checker\n```\n\n### `locations` — Look up location codes\n\nList all available location codes, or filter by name. Works offline — no API credentials needed.\n\n```bash\ndataforseo-cli locations [search] [--json]\n```\n\n**Arguments:**\n- `[search]` — Optional filter by name (e.g. `sweden`, `new york`)\n\n**Without search** — lists all locations:\n```bash\ndataforseo-cli locations\n```\n\n**With search** — filters by name:\n```bash\ndataforseo-cli locations sweden\n```\n\n**Output (TSV):**\n```\ncode\tname\tcountry\ttype\n2752\tSweden\tSE\tCountry\n```\n\n### `languages` — Look up language codes\n\nList all available language codes, or filter by name. Works offline — no API credentials needed.\n\n```bash\ndataforseo-cli languages [search] [--json]\n```\n\n**Without search** — lists all languages:\n```bash\ndataforseo-cli languages\n```\n\n**With search** — filters by name:\n```bash\ndataforseo-cli languages swedish\n```\n\n**Output (TSV):**\n```\nname\tcode\nSwedish\tsv\n```\n\n## Output Formats\n\nAll data commands default to TSV (tab-separated values) — the most token-efficient structured format for LLMs.\n\n| Flag | Description |\n|------|-------------|\n| *(default)* | TSV — fewest tokens, best for agent pipelines |\n| `--json` | JSON array — use when you need structured parsing |\n| `--table` / `--human` | Human-readable aligned table — for human review |\n\n## Caching\n\nResults are cached in `~/.config/dataforseo-cli/cache/` to avoid duplicate API calls and save costs. Same query + location + language = cache hit.\n\n```bash\ndataforseo-cli --print-cache\n```\n\n## Workflow: SEO Article Research\n\n1. **Start with seed keyword:** `dataforseo-cli volume \"your topic\"`\n2. **Expand:** `dataforseo-cli related \"your topic\" -n 30`\n3. **Filter:** Pick keywords with volume > 100, difficulty < 60\n4. **Check competitors:** `dataforseo-cli competitor competitor-domain.com -n 20`\n5. **Write article** targeting the best keyword cluster\n\n## Tips\n- Batch keywords in `volume` — DataForSEO charges per API request, not per keyword\n- Default location is USA (2840). Always set `--location` for local/international SEO\n- Use `locations` and `languages` without arguments to see all available options\n- Difficulty scale: 0-30 easy, 31-60 medium, 61-100 hard\n","readmeExcerpt":"--- 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","codeSnippets":[],"executableExamples":[{"language":"bash","snippet":"npm install -g dataforseo-cli"},{"language":"bash","snippet":"dataforseo-cli status"},{"language":"bash","snippet":"# With login + password\ndataforseo-cli --set-credentials login=YOUR_LOGIN password=YOUR_PASSWORD\n\n# Or with base64 token (from DataForSEO email)\ndataforseo-cli --set-credentials base64=YOUR_BASE64_TOKEN"},{"language":"bash","snippet":"dataforseo-cli status"},{"language":"bash","snippet":"dataforseo-cli volume <keywords...> [options]"},{"language":"bash","snippet":"dataforseo-cli volume \"seo tools\" \"keyword research\" \"backlink checker\""}],"parameters":{},"dependencies":[],"permissions":[],"extractedFiles":[],"languages":["typescript"],"docsSourceLabel":"CLAWHUB","editorialOverview":"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. --- 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","editorialQuality":{"score":100,"threshold":65,"status":"ready","wordCount":404,"uniquenessScore":63,"reasons":[]}},"media":{"evidence":{"source":"no-media","verified":false,"confidence":"low","updatedAt":"2026-04-15T00:45:39.800Z","emptyReason":"No screenshots, media assets, or demo links are available."},"primaryImageUrl":null,"mediaAssetCount":0,"assets":[],"demoUrl":null},"ownerResources":{"evidence":{"source":"unclaimed","verified":false,"confidence":"low","updatedAt":"2026-04-15T00:45:39.800Z","emptyReason":"This page has not been claimed by the agent owner."},"hasCustomPage":false,"customPageUpdatedAt":null,"customLinks":[],"structuredLinks":{"docsUrl":null,"demoUrl":null,"supportUrl":null,"pricingUrl":null,"statusUrl":null},"customPage":null},"relatedAgents":{"evidence":{"source":"protocol-neighbors","verified":false,"confidence":"medium","updatedAt":"2026-10-09T11:20:18.503Z","emptyReason":null},"items":[{"id":"b917f68a-ebff-438e-84f8-3f4b2494c0bc","entityType":"agent","canonicalPath":"/agent/activepieces-activepieces","slug":"activepieces-activepieces","name":"activepieces","description":"AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents","url":"https://github.com/activepieces/activepieces","homepage":"https://www.activepieces.com","source":"GITHUB_REPOS","protocols":["OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-04-15T02:22:12.426Z","createdAt":"2026-02-25T03:38:12.412Z","downloads":null},{"id":"5cb26759-3a39-483f-94cf-276a98c13bb8","entityType":"agent","canonicalPath":"/agent/cherryhq-cherry-studio","slug":"cherryhq-cherry-studio","name":"cherry-studio","description":"AI productivity studio with smart chat, autonomous agents, and 300+ assistants. Unified access to frontier LLMs","url":"https://github.com/CherryHQ/cherry-studio","homepage":"https://cherry-ai.com","source":"GITHUB_REPOS","protocols":["MCP","OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-04-11T14:38:40.986Z","createdAt":"2026-02-25T03:38:19.379Z","downloads":null},{"id":"8ebccd8e-3863-4187-8355-c3f14e1f9edf","entityType":"agent","canonicalPath":"/agent/iofficeai-aionui","slug":"iofficeai-aionui","name":"AionUi","description":"Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!","url":"https://github.com/iOfficeAI/AionUi","homepage":"https://www.aionui.com","source":"GITHUB_REPOS","protocols":["MCP","OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-04-10T18:48:31.762Z","createdAt":"2026-02-25T03:38:16.584Z","downloads":null},{"id":"6f6582d0-5d76-4f0f-b81d-86520247950b","entityType":"agent","canonicalPath":"/agent/copilotkit-copilotkit","slug":"copilotkit-copilotkit","name":"CopilotKit","description":"The Frontend for Agents & Generative UI. React + Angular","url":"https://github.com/CopilotKit/CopilotKit","homepage":"https://docs.copilotkit.ai","source":"GITHUB_REPOS","protocols":["OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-03-25T09:50:57.846Z","createdAt":"2026-02-25T03:39:14.617Z","downloads":null}],"links":{"hub":"/agent","source":"/agent/source/clawhub","protocols":[{"label":"OpenClaw","href":"/agent/protocol/openclew"}]}}}