aios-keyword-research

Researches keywords from a seed term and reports volume, difficulty, intent, clusters, and cannibalization conflicts.

1|Updated Jul 8, 2026
One-click install
npx skills add https://github.com/codesofadan/danyals-aios --skill aios-keyword-research-codesofadan
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: aios-keyword-research
Source: https://github.com/codesofadan/danyals-aios/tree/main/.claude/skills/aios-keyword-research
Command: npx skills add https://github.com/codesofadan/danyals-aios --skill aios-keyword-research-codesofadan

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Keyword research through the AIOS platform involves a paid provider call that can be silently blocked by a cost gate, so a naive run can return an empty bank that looks like a valid result. This Skill queues the research job, verifies what actually landed by comparing the keyword bank before and after, and reports only fields the backend truly returns. ## Core Features & Use Cases - Seed-based keyword research: Queue a research job for a client from a seed term and verify the saved-keyword count actually changed before reporting success. - Bank, cluster, and conflict reporting: Read saved keywords with volume, raw provider difficulty, CPC, intent, and opportunity scores, plus cluster pillar maps and cannibalization conflicts where one URL targets keywords with different intents. - Honest failure handling: Detect silent cost-gate blocks and dormant providers instead of presenting an empty bank as "no keywords found", and never re-queue a blocked run since that is a budget decision. - Use Case: An SEO operator asks for keyword ideas around "local plumber seo" for a client; the Skill resolves the client, queues the research, confirms 40 new keywords landed in the bank, and renders the cluster map and cannibalization conflicts. ## Quick Start Ask the assistant to research keywords for a client from a seed term, for example: run keyword research for client Acme with the seed term "emergency plumbing services" and show the clusters and cannibalization conflicts.

Frequently Asked Questions about aios-keyword-research

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I research keywords for a client from a seed term?▼

Resolve the client name to a client id, record the current saved-keyword count, then POST the seed to the keyword research endpoint. Afterwards re-read the bank stats and keyword list to confirm what actually landed before reporting volume, difficulty, and clusters.

Why did keyword research return 202 but save no keywords?▼

The 202 response only means the job was enqueued; the cost gate and provider call run later in the worker. If the saved count did not move, the run was cost-gate blocked, the provider was dormant, or the seed had no fan-out, and it should not be re-queued automatically.

What does winnable true mean for a keyword's difficulty?▼

Winnable is a neutral-DA screen, not a per-client verdict: every keyword with difficulty at or below 45 reads winnable true because the research task never passes the client's domain authority. Difficulty itself is the raw provider KD score from 0 to 100.

How do I detect keyword cannibalization conflicts?▼

Call the cannibalization endpoint for the client, which returns cases where two or more keywords with different intents point at the same target URL. Report the conflicting URL and intents; deciding whether to split or consolidate the page is a human decision.

Can I see where a keyword's intent classification came from?▼

No. The intent provenance field is stored in the database but is not exposed on the API wire, so you cannot tell whether intent came from the provider, a SERP heuristic, or an LLM. An empty intent string simply means unset.