Blog Google
AgriciDaniel/claude-blog
Google API integration for blog performance: PageSpeed Insights, CrUX Core Web Vitals with 25-week history, Search Console performance, URL Inspection, Indexing API, GA4 organic traffic, NLP entity…
Keyword & SERP research via the DataForSEO API — search volume, competition, CPC, keyword ideas for naming/SEO decisions
Install Dataforseo
$ npx skills add alinaqi/maggy --skill dataforseo -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install alinaqi/maggy dataforseo --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/alinaqi/maggy.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/dataforseo .claude/skills/dataforseo && rm -rf skills-srcUse ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.
Claude Code skills documentation · loads skills from .claude/skills/
Install the "dataforseo" agent skill from https://github.com/alinaqi/maggy/tree/main/skills/dataforseo into .claude/skills/dataforseo/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "dataforseo", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/alinaqi/maggy/tree/main/skills/dataforseoType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add alinaqi/maggy --skill dataforseo -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install alinaqi/maggy dataforseo --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/alinaqi/maggy.git skills-src && mkdir -p .agents/skills && cp -r skills-src/skills/dataforseo .agents/skills/dataforseo && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "dataforseo" agent skill from https://github.com/alinaqi/maggy/tree/main/skills/dataforseo into .agents/skills/dataforseo/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "dataforseo", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add alinaqi/maggy --skill dataforseo -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install alinaqi/maggy dataforseo --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/alinaqi/maggy.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/skills/dataforseo .cursor/skills/dataforseo && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "dataforseo" agent skill from https://github.com/alinaqi/maggy/tree/main/skills/dataforseo into .cursor/skills/dataforseo/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "dataforseo", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/alinaqi/maggy.git --path skills/dataforseo--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add alinaqi/maggy --skill dataforseo -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install alinaqi/maggy dataforseo --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/alinaqi/maggy.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/skills/dataforseo .gemini/skills/dataforseo && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "dataforseo" agent skill from https://github.com/alinaqi/maggy/tree/main/skills/dataforseo into .gemini/skills/dataforseo/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "dataforseo", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install alinaqi/maggy dataforseoInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add alinaqi/maggy --skill dataforseo -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/alinaqi/maggy.git skills-src && mkdir -p .github/skills && cp -r skills-src/skills/dataforseo .github/skills/dataforseo && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "dataforseo" agent skill from https://github.com/alinaqi/maggy/tree/main/skills/dataforseo into .github/skills/dataforseo/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "dataforseo", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add alinaqi/maggy --skill dataforseo -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install alinaqi/maggy dataforseo --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/alinaqi/maggy.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/skills/dataforseo .opencode/skills/dataforseo && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "dataforseo" agent skill from https://github.com/alinaqi/maggy/tree/main/skills/dataforseo into .opencode/skills/dataforseo/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "dataforseo", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
Facts
- Skill name
dataforseo- GitHub stars
- 707
- Token cost
- ~838 tokens
- SKILL.md length
- 319 words
- Files
- 2
- Skills in repo
- 71
- Repo updated
- First seen
- Licence
- MIT
At a glance
Keyword & SERP research via the DataForSEO API — search volume, competition, CPC, keyword ideas for naming/SEO decisions
- Tasks that involve Keyword research
- SKILL.md covers Auth (never commit the key), Usage, Reading the results (naming… and Cost & etiquette, plus 1 more section
- Runs Python scripts from its folder; calls python3; needs DATAFORSEO_PASSWORD and DATAFORSEO_API_KEY
What it does
Dataforseo is an agent skill from alinaqi/maggy. Keyword & SERP research via the DataForSEO API — search volume, competition, CPC, keyword ideas for naming/SEO decisions
Its SKILL.md is about 840 tokens, which your agent loads only when the skill is triggered. The skill folder holds 1 other file (for example `dataforseo.py`).
It sits in Marketing & SEO, covering Keyword research. It works with Google Ads. The repository describes itself as: What started as an opinionated Claude Code setup kit is now an autonomous AI engineering command center. The licence is MIT.
When your agent uses it
- Tasks that involve Keyword research
Example prompts
- “/dataforseo”
Requirements
- Python 3
- A credential in DATAFORSEO_API_KEY
What it can do on your machine
Read from SKILL.md and the folder at commit 72a456e. It shows what the files ask for, not the result of running them.
Tool permissions
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Runs code
Ships script files (Python), which the agent can run.
Shell commands in SKILL.md call:
python3
From the folder's file list and the shell code blocks in SKILL.md.
Network
Links to these hosts (documentation or services it may open):
dataforseo.com
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names these keys or tokens, usually read from environment variables:
DATAFORSEO_PASSWORDDATAFORSEO_API_KEY
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Context cost
Dataforseo loads about 838 tokens when it runs. Until then it costs about 33 tokens; SKILL.md has 319 words of instructions outside code blocks.
Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.
Safety
Auto-check: notes
The automated check noted patterns worth knowing about, such as sudo or a known installer.
- NoteMentions a .env fileSKILL.md:27
ataforseo.com`. Keep the key in a local `.env` that is
Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.
SKILL.md
The full file from alinaqi/maggy at commit 72a456e, republished under its MIT licence (© alinaqi). 319 words, ~838 tokens.
Download SKILL.mdSave it as
.claude/skills/dataforseo/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.- name
- dataforseo
- description
- Keyword & SERP research via the DataForSEO API — search volume, competition, CPC, keyword ideas for naming/SEO decisions
- when-to-use
- When choosing a product/repo/domain name, sizing a keyword, checking search demand, or doing competitor/SEO research and WebSearch is not enough
- user-invocable
- true
- effort
- low
DataForSEO Skill — keyword & SERP research
Purpose: Get real search demand (monthly volume, competition, CPC) and keyword ideas from Google Ads data via DataForSEO, so naming and content decisions are grounded in data rather than intuition.
Auth (never commit the key)
DataForSEO uses HTTP Basic auth. Provide credentials via environment only:
export DATAFORSEO_LOGIN="you@example.com"
export DATAFORSEO_PASSWORD="…"
# or a single combined value:
export DATAFORSEO_API_KEY="login:password" # or its base64The helper reads these from the env — it never hardcodes or logs the secret,
and only ever calls api.dataforseo.com. Keep the key in a local .env that is
git-ignored; do not paste it into the repo, a URL, or chat.
Usage
The helper is dataforseo.py in this skill folder:
DFS="$(cat ~/.claude/.bootstrap-dir)/skills/dataforseo/dataforseo.py"
python3 "$DFS" whoami # auth check + balance
python3 "$DFS" volume "claude code" "coding agent" # search volume table
python3 "$DFS" ideas "coding agent" # related keyword ideas
# options: --location <code, default 2840=US> --language <code, default en>volume → each keyword's monthly search volume, competition (LOW/MEDIUM/HIGH),
and CPC. ideas → the searched long-tail around a seed.
Reading the results (naming decisions)
- Zero /
n/avolume on every candidate is itself the answer: the names aren't search terms, so SEO can't rank them against each other — decide on clarity/brand and accept that discovery happens on GitHub/HN/X, not search. - Category term vs. brand term: a huge-volume category word (e.g. the tool's ecosystem name) is where demand lives; a brand name rides it only if it contains it. Weigh discoverability against being on-brand for what you built.
- Wrong-intent volume is a trap: a candidate with existing volume may be drawing an audience searching for something else (a different industry meaning). That volume hurts, it doesn't help.
- Competition + CPC proxy commercial intent, not just popularity — high CPC means advertisers pay for that term (buyers), low CPC often means informational or noise.
Cost & etiquette
live endpoints bill per call (search volume / ideas ≈ $0.05–0.10 each). Batch
many keywords into ONE volume call (it accepts up to 1000) rather than looping.
Check whoami for balance before large runs.
Common endpoints (beyond the helper)
| Need | Endpoint |
|---|---|
| Search volume | keywords_data/google_ads/search_volume/live |
| Keyword ideas | keywords_data/google_ads/keywords_for_keywords/live |
| SERP (who ranks) | serp/google/organic/live/advanced |
| Ranked keywords for a domain | dataforseo_labs/google/ranked_keywords/live |
| Competitor domains | dataforseo_labs/google/competitors_domain/live |
All take the same Basic-auth header; POST a JSON array of task objects.
© alinaqi, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file
Files
SKILL.md and 1 other file in skills/dataforseo of alinaqi/maggy.
- SKILL.md
- dataforseo.py
Open the folder on GitHubat commit 72a456e
Compare with similar skills
Dataforseo next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Dataforseo this skillalinaqi/maggy | 707 | — | ~838 | Automated safety check: Notes | MIT | |
| Blog GoogleAgriciDaniel/claude-blog | 2.3k | 1 repos | ~3.3k | Automated safety check: Notes | MIT | |
| Keyword ResearchRyze-AI-Adgent/open-seo-mcp-skills | 4.6k | — | ~581 | Automated safety check: Pass | MIT | |
| Keyword Cannibalization Checkirinabuht12-oss/marketing-skills | 4k | — | ~717 | Automated safety check: Pass | None | |
| Google Search Ads Buildergooseworks-ai/goose-skills | 1.2k | 1 repos | ~4.6k | Automated safety check: Pass | MIT | |
| Search Campaign Auditcognyai/claude-code-marketing-skills | 104 | — | ~1.7k | Automated safety check: Pass | None |
Similar skills
Keyword Research
Ryze-AI-Adgent/open-seo-mcp-skills
Keyword research from a seed topic — ideas, real Google volume/CPC, intent, difficulty, clustered into a plan.
Keyword Cannibalization Check
irinabuht12-oss/marketing-skills
Identifies where your own keywords and campaigns are competing against each other in Google Ads auctions.
Google Search Ads Builder
gooseworks-ai/goose-skills
End-to-end Google Search Ads campaign builder. An agent skill from gooseworks-ai/goose-skills.
Search Campaign Audit
cognyai/claude-code-marketing-skills
Google Ads Search campaign audit — match types, quality score, negative keyword gaps, search terms, ad strength, RSA asset coverage
Google Ads Management
ivangfalco/ads-skills
Manages Google Ads accounts with Python scripts for the Google Ads API, backed by an intent-first B2B strategy knowledge base.
More from alinaqi/maggy
All 71 skills in this repoAeo Optimization
alinaqi/maggy
AI Engine Optimization - semantic triples, page templates, content clusters for AI citations
Agent Teams
alinaqi/maggy
Claude Code Agent Teams - default team-based development with strict TDD pipeline enforcement
AI Models
alinaqi/maggy
Latest AI models reference - Claude, OpenAI, Gemini, Eleven Labs, Replicate
Android Java
alinaqi/maggy
Android Java development with MVVM, ViewBinding, and Espresso testing
Android Kotlin
alinaqi/maggy
Android Kotlin development with Coroutines, Jetpack Compose, Hilt, and MockK testing
Autonomous Testing
alinaqi/maggy
AI-driven testing agent that auto-discovers, generates, executes, evaluates, and fixes tests for any project type
Related
Works with
Categories
Questions about Dataforseo
What does Dataforseo do?
Keyword & SERP research via the DataForSEO API — search volume, competition, CPC, keyword ideas for naming/SEO decisions. Dataforseo is an agent skill from alinaqi/maggy.
When should I use Dataforseo?
Dataforseo fits situations like: tasks that involve Keyword research.
How do I install Dataforseo in Claude Code?
Run `npx skills add alinaqi/maggy --skill dataforseo -a claude-code`. Or copy the skill folder (skills/dataforseo in alinaqi/maggy) into .claude/skills/dataforseo in your project. Claude Code loads it when a task matches its description.
How do I install Dataforseo in Codex?
Run `npx skills add alinaqi/maggy --skill dataforseo -a codex`. Or copy the skill folder (skills/dataforseo in alinaqi/maggy) into .agents/skills/dataforseo in your project. Codex loads it when a task matches its description.
Can I use Dataforseo in Cursor, Gemini CLI or GitHub Copilot?
Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add alinaqi/maggy --skill dataforseo -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/dataforseo, .gemini/skills/dataforseo, .github/skills/dataforseo and .opencode/skills/dataforseo in your project.
What does Dataforseo need to run?
Going by SKILL.md and its folder, Dataforseo needs Python for the scripts in its folder, the command-line tools its instructions call (python3) and credentials named DATAFORSEO_PASSWORD and DATAFORSEO_API_KEY. Our summary lists: Python 3; A credential in DATAFORSEO_API_KEY.
Does Dataforseo access the network?
SKILL.md names 1 domain. As links in the text: dataforseo.com. This is read from the text; nothing was executed.
Is Dataforseo safe to install?
Our automated static check of SKILL.md found notes only (mentions a .env file), nothing it rates as a warning. It is not a guarantee. Review the folder before installing.
What licence does Dataforseo use?
Dataforseo is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.
How many tokens does Dataforseo use?
About 838 tokens (SKILL.md is roughly 3.4k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.
What are the alternatives to Dataforseo?
Skills that share tags, products or a category with Dataforseo: Blog Google (AgriciDaniel/claude-blog, 2.3k stars), Keyword Research (Ryze-AI-Adgent/open-seo-mcp-skills, 4.6k stars), Keyword Cannibalization Check (irinabuht12-oss/marketing-skills, 4k stars) and Google Search Ads Builder (gooseworks-ai/goose-skills, 1.2k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Who maintains Dataforseo?
alinaqi (a GitHub user) maintains it in alinaqi/maggy, which has 707 GitHub stars. The repository holds 71 skills in this directory. The repository was last updated on September 24, 2026.
Source: alinaqi/maggy on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.