dataforseo-cli

What This Skill Does

The dataforseo-cli is a powerful, LLM-optimized command-line interface designed to bridge the gap between AI agents and real-time SEO data. By wrapping the robust DataForSEO API, this skill allows agents to fetch precise keyword metrics—including search volume, CPC, keyword difficulty, and competitive density—directly into their workflow. Its default TSV output format is specifically engineered for high-token efficiency, ensuring that agents can process large keyword datasets within their limited context windows without unnecessary overhead.

Installation

To integrate this skill into your OpenClaw environment, run the following command in your terminal:

clawhub install openclaw/skills/skills/alexgusevski/dataforseo-cli

Once installed, ensure your DataForSEO API credentials are properly configured by running dataforseo-cli --set-credentials followed by your login/password or your Base64 token. You can verify your connection status at any time using dataforseo-cli status.

Use Cases

This skill is an essential tool for any agent tasked with digital marketing or growth strategy.

• Content Planning: Identify high-volume, low-difficulty "long-tail" keywords to target in blog posts or technical documentation.
• Market Research: Analyze search trends for specific topics over the last 12 months to determine if a niche is growing or stagnant.
• Competitive Intelligence: Perform domain-level analysis to see which keywords drive traffic to competitors, allowing the agent to refine your site's SEO strategy.
• PPC Strategy: Use the CPC and competition metrics to estimate the viability of paid search campaigns before investing budget.

Example Prompts

1. "Perform keyword research for 'autonomous AI agents' in the US market. Provide a list of the top 20 related keywords, sorted by search volume, and identify which ones have a difficulty score under 30."
2. "Analyze the domain 'example.com' to see what keywords they rank for. Create a table of the top 10 keywords and calculate the average CPC for this set."
3. "I am planning a content strategy around 'web automation'. Use the dataforseo-cli to find 15 low-competition keywords related to this topic, and include their monthly search trends to help me prioritize the content calendar."

Tips & Limitations

• Batching: Always batch your keywords in the volume command. This reduces the number of API calls, saving you API credits and speeding up agent response times.
• Context Optimization: While the CLI supports JSON output, sticking to the default TSV format is recommended for long lists to keep your context window clean and focused.
• Data Accuracy: Always verify competitive data against real-world SERPs if the agent indicates a high-difficulty keyword, as search intent and local ranking factors may vary.
• API Credits: Be mindful that this skill consumes DataForSEO API credits. Monitor your usage through the DataForSEO dashboard if you are running large-scale recurring agent tasks.