{
  "schemaVersion": "1.0",
  "item": {
    "slug": "dataforseo-cli",
    "name": "dataforseo-cli",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/alexgusevski/dataforseo-cli",
    "canonicalUrl": "https://clawhub.ai/alexgusevski/dataforseo-cli",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadMode": "redirect",
    "downloadUrl": "/downloads/dataforseo-cli",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=dataforseo-cli",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "installMethod": "Manual import",
    "extraction": "Extract archive",
    "prerequisites": [
      "OpenClaw"
    ],
    "packageFormat": "ZIP package",
    "includedAssets": [
      "SKILL.md"
    ],
    "primaryDoc": "SKILL.md",
    "quickSetup": [
      "Download the package from Yavira.",
      "Extract the archive and review SKILL.md first.",
      "Import or place the package into your OpenClaw setup."
    ],
    "agentAssist": {
      "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
      "steps": [
        "Download the package from Yavira.",
        "Extract it into a folder your agent can access.",
        "Paste one of the prompts below and point your agent at the extracted folder."
      ],
      "prompts": [
        {
          "label": "New install",
          "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete."
        },
        {
          "label": "Upgrade existing",
          "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run."
        }
      ]
    },
    "sourceHealth": {
      "source": "tencent",
      "slug": "dataforseo-cli",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-05-11T22:14:08.920Z",
      "expiresAt": "2026-05-18T22:14:08.920Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=dataforseo-cli",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=dataforseo-cli",
        "contentDisposition": "attachment; filename=\"dataforseo-cli-1.0.7.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "dataforseo-cli"
      },
      "scope": "item",
      "summary": "Item download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this item.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/dataforseo-cli"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    },
    "downloadPageUrl": "https://openagent3.xyz/downloads/dataforseo-cli",
    "agentPageUrl": "https://openagent3.xyz/skills/dataforseo-cli/agent",
    "manifestUrl": "https://openagent3.xyz/skills/dataforseo-cli/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/dataforseo-cli/agent.md"
  },
  "agentAssist": {
    "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
    "steps": [
      "Download the package from Yavira.",
      "Extract it into a folder your agent can access.",
      "Paste one of the prompts below and point your agent at the extracted folder."
    ],
    "prompts": [
      {
        "label": "New install",
        "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete."
      },
      {
        "label": "Upgrade existing",
        "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run."
      }
    ]
  },
  "documentation": {
    "source": "clawhub",
    "primaryDoc": "SKILL.md",
    "sections": [
      {
        "title": "Keyword Research with dataforseo-cli",
        "body": "LLM-friendly keyword research CLI. Wraps the DataForSEO API and outputs TSV by default — compact, structured, and optimized for agent context windows.\n\nnpm: https://www.npmjs.com/package/dataforseo-cli\nGitHub: https://github.com/alexgusevski/dataforseo-cli"
      },
      {
        "title": "1. Install from npm",
        "body": "npm install -g dataforseo-cli"
      },
      {
        "title": "2. Check credentials",
        "body": "dataforseo-cli status\n\nIf credentials are already configured, you're good to go. If not, authenticate:\n\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\nCredentials are stored in ~/.config/dataforseo-cli/config.json. The locations and languages commands work without credentials (local data)."
      },
      {
        "title": "status — Check credentials",
        "body": "Check if API credentials are configured without making any API calls.\n\ndataforseo-cli status\n\nExits 0 if configured, exits 1 if not. Shows login username (not password)."
      },
      {
        "title": "volume — Keyword metrics",
        "body": "Get search volume, CPC, keyword difficulty (0–100), competition level, and 12-month search trend.\n\ndataforseo-cli volume <keywords...> [options]\n\nArguments:\n\n<keywords...> — One or more keywords (required). Batch multiple keywords in one call to save API requests.\n\nOptions:\n\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\nExample:\n\ndataforseo-cli volume \"seo tools\" \"keyword research\" \"backlink checker\"\n\nOutput (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\ndifficulty — 0–100 scale (0-30 easy, 31-60 medium, 61-100 hard)\ncpc — Cost per click in USD\ncompetition — LOW / MEDIUM / HIGH\ntrend — 12 monthly search volumes, newest first"
      },
      {
        "title": "related — Keyword suggestions",
        "body": "Find related keyword ideas from a seed keyword.\n\ndataforseo-cli related <seed> [options]\n\nArguments:\n\n<seed> — Seed keyword (required, single keyword)\n\nOptions:\n\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\nExample:\n\ndataforseo-cli related \"ai agents\" -n 20\n\nOutput (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"
      },
      {
        "title": "competitor — Domain keyword analysis",
        "body": "See what keywords a domain currently ranks for.\n\ndataforseo-cli competitor <domain> [options]\n\nArguments:\n\n<domain> — Target domain (required, e.g. ahrefs.com)\n\nOptions:\n\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\nExample:\n\ndataforseo-cli competitor semrush.com -n 10\n\nOutput (TSV):\n\nkeyword\tposition\tvolume\tcpc\tdifficulty\turl\nbacklink checker\t1\t33100\t4.50\t72\thttps://ahrefs.com/backlink-checker"
      },
      {
        "title": "locations — Look up location codes",
        "body": "List all available location codes, or filter by name. Works offline — no API credentials needed.\n\ndataforseo-cli locations [search] [--json]\n\nArguments:\n\n[search] — Optional filter by name (e.g. sweden, new york)\n\nWithout search — lists all locations:\n\ndataforseo-cli locations\n\nWith search — filters by name:\n\ndataforseo-cli locations sweden\n\nOutput (TSV):\n\ncode\tname\tcountry\ttype\n2752\tSweden\tSE\tCountry"
      },
      {
        "title": "languages — Look up language codes",
        "body": "List all available language codes, or filter by name. Works offline — no API credentials needed.\n\ndataforseo-cli languages [search] [--json]\n\nWithout search — lists all languages:\n\ndataforseo-cli languages\n\nWith search — filters by name:\n\ndataforseo-cli languages swedish\n\nOutput (TSV):\n\nname\tcode\nSwedish\tsv"
      },
      {
        "title": "Output Formats",
        "body": "All data commands default to TSV (tab-separated values) — the most token-efficient structured format for LLMs.\n\nFlagDescription(default)TSV — fewest tokens, best for agent pipelines--jsonJSON array — use when you need structured parsing--table / --humanHuman-readable aligned table — for human review"
      },
      {
        "title": "Caching",
        "body": "Results are cached in ~/.config/dataforseo-cli/cache/ to avoid duplicate API calls and save costs. Same query + location + language = cache hit.\n\ndataforseo-cli --print-cache"
      },
      {
        "title": "Workflow: SEO Article Research",
        "body": "Start with seed keyword: dataforseo-cli volume \"your topic\"\nExpand: dataforseo-cli related \"your topic\" -n 30\nFilter: Pick keywords with volume > 100, difficulty < 60\nCheck competitors: dataforseo-cli competitor competitor-domain.com -n 20\nWrite article targeting the best keyword cluster"
      },
      {
        "title": "Tips",
        "body": "Batch keywords in volume — DataForSEO charges per API request, not per keyword\nDefault location is USA (2840). Always set --location for local/international SEO\nUse locations and languages without arguments to see all available options\nDifficulty scale: 0-30 easy, 31-60 medium, 61-100 hard"
      }
    ],
    "body": "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\nnpm: https://www.npmjs.com/package/dataforseo-cli GitHub: https://github.com/alexgusevski/dataforseo-cli\n\nSetup\n1. Install from npm\nnpm install -g dataforseo-cli\n\n2. Check credentials\ndataforseo-cli status\n\n\nIf credentials are already configured, you're good to go. If not, authenticate:\n\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\nCommands\nstatus — Check credentials\n\nCheck if API credentials are configured without making any API calls.\n\ndataforseo-cli status\n\n\nExits 0 if configured, exits 1 if not. Shows login username (not password).\n\nvolume — Keyword metrics\n\nGet search volume, CPC, keyword difficulty (0–100), competition level, and 12-month search trend.\n\ndataforseo-cli volume <keywords...> [options]\n\n\nArguments:\n\n<keywords...> — One or more keywords (required). Batch multiple keywords in one call to save API requests.\n\nOptions:\n\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\nExample:\n\ndataforseo-cli volume \"seo tools\" \"keyword research\" \"backlink checker\"\n\n\nOutput (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\ndifficulty — 0–100 scale (0-30 easy, 31-60 medium, 61-100 hard)\ncpc — Cost per click in USD\ncompetition — LOW / MEDIUM / HIGH\ntrend — 12 monthly search volumes, newest first\nrelated — Keyword suggestions\n\nFind related keyword ideas from a seed keyword.\n\ndataforseo-cli related <seed> [options]\n\n\nArguments:\n\n<seed> — Seed keyword (required, single keyword)\n\nOptions:\n\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\nExample:\n\ndataforseo-cli related \"ai agents\" -n 20\n\n\nOutput (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\ncompetitor — Domain keyword analysis\n\nSee what keywords a domain currently ranks for.\n\ndataforseo-cli competitor <domain> [options]\n\n\nArguments:\n\n<domain> — Target domain (required, e.g. ahrefs.com)\n\nOptions:\n\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\nExample:\n\ndataforseo-cli competitor semrush.com -n 10\n\n\nOutput (TSV):\n\nkeyword\tposition\tvolume\tcpc\tdifficulty\turl\nbacklink checker\t1\t33100\t4.50\t72\thttps://ahrefs.com/backlink-checker\n\nlocations — Look up location codes\n\nList all available location codes, or filter by name. Works offline — no API credentials needed.\n\ndataforseo-cli locations [search] [--json]\n\n\nArguments:\n\n[search] — Optional filter by name (e.g. sweden, new york)\n\nWithout search — lists all locations:\n\ndataforseo-cli locations\n\n\nWith search — filters by name:\n\ndataforseo-cli locations sweden\n\n\nOutput (TSV):\n\ncode\tname\tcountry\ttype\n2752\tSweden\tSE\tCountry\n\nlanguages — Look up language codes\n\nList all available language codes, or filter by name. Works offline — no API credentials needed.\n\ndataforseo-cli languages [search] [--json]\n\n\nWithout search — lists all languages:\n\ndataforseo-cli languages\n\n\nWith search — filters by name:\n\ndataforseo-cli languages swedish\n\n\nOutput (TSV):\n\nname\tcode\nSwedish\tsv\n\nOutput Formats\n\nAll data commands default to TSV (tab-separated values) — the most token-efficient structured format for LLMs.\n\nFlag\tDescription\n(default)\tTSV — fewest tokens, best for agent pipelines\n--json\tJSON array — use when you need structured parsing\n--table / --human\tHuman-readable aligned table — for human review\nCaching\n\nResults are cached in ~/.config/dataforseo-cli/cache/ to avoid duplicate API calls and save costs. Same query + location + language = cache hit.\n\ndataforseo-cli --print-cache\n\nWorkflow: SEO Article Research\nStart with seed keyword: dataforseo-cli volume \"your topic\"\nExpand: dataforseo-cli related \"your topic\" -n 30\nFilter: Pick keywords with volume > 100, difficulty < 60\nCheck competitors: dataforseo-cli competitor competitor-domain.com -n 20\nWrite article targeting the best keyword cluster\nTips\nBatch keywords in volume — DataForSEO charges per API request, not per keyword\nDefault location is USA (2840). Always set --location for local/international SEO\nUse locations and languages without arguments to see all available options\nDifficulty scale: 0-30 easy, 31-60 medium, 61-100 hard"
  },
  "trust": {
    "sourceLabel": "tencent",
    "provenanceUrl": "https://clawhub.ai/alexgusevski/dataforseo-cli",
    "publisherUrl": "https://clawhub.ai/alexgusevski/dataforseo-cli",
    "owner": "alexgusevski",
    "version": "1.0.7",
    "license": null,
    "verificationStatus": "Indexed source record"
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/dataforseo-cli",
    "downloadUrl": "https://openagent3.xyz/downloads/dataforseo-cli",
    "agentUrl": "https://openagent3.xyz/skills/dataforseo-cli/agent",
    "manifestUrl": "https://openagent3.xyz/skills/dataforseo-cli/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/dataforseo-cli/agent.md"
  }
}