Keyword Research Agent Skill
Keyword discovery, metrics, ideas, and gap analysis using YepAPI.
The Skill
Full content, every format. Copy it, download it, or install with one command.
---
description: Keyword discovery, metrics, ideas, and gap analysis using YepAPI.
homepage: https://yepapi.com/skills/keyword-research
metadata:
tags: [yepapi, seo, keywords, research]
---
# Keyword Research Workflow
Dedicated keyword research workflow — discover, evaluate, and prioritize keywords using YepAPI endpoints.
## Endpoints Used
| Endpoint | Cost | Purpose |
|----------|------|---------|
| `POST /v1/seo/keywords/ideas` | $0.03 | Keyword suggestions from a seed keyword |
| `POST /v1/seo/keywords/related` | $0.03 | Related keywords for a seed keyword |
| `POST /v1/seo/keywords` | $0.15 | Bulk keyword metrics (volume, CPC, difficulty, intent) |
| `POST /v1/seo/keyword-gap` | $0.04 | Keyword gap analysis between two domains |
## Workflow
### Step 1: Generate Keyword Ideas
Start with a seed keyword. Run `POST /v1/seo/keywords/ideas`.
```json
{
"keyword": "project management",
"location": "us"
}
```
Returns: keyword suggestions based on the seed — content angles and long-tail variations.
### Step 2: Find Related Keywords
Expand with `POST /v1/seo/keywords/related`.
```json
{
"keyword": "project management",
"location": "us"
}
```
Returns: semantically related terms — broader and narrower variations.
### Step 3: Evaluate Keyword Metrics
Run `POST /v1/seo/keywords` with all candidate keywords.
```json
{
"keywords": ["project management software", "project management tools", "best project management app"],
"location": "us"
}
```
Returns: search volume, CPC, keyword difficulty, search intent (informational/commercial/transactional), 12-month trends.
### Step 4: Keyword Gap Analysis (Optional)
If the user has a domain and a competitor, run `POST /v1/seo/keyword-gap`.
```json
{
"domain": "example.com",
"competitor": "competitor.com"
}
```
Returns: keywords the competitor ranks for that the user doesn't — untapped opportunities.
### Step 5: Prioritize Keywords
Present a prioritized keyword list sorted by opportunity score:
- **High opportunity** — high volume + low difficulty
- **Group by intent** — informational, navigational, commercial, transactional
- **Flag seasonal keywords** — note 12-month patterns from trends data
## Rules
- Start broad with ideas, then narrow with metrics
- Group keywords by search intent: informational, navigational, commercial, transactional
- Flag seasonal keywords using trends data (12-month pattern)
- Batch keyword metrics calls — up to 100 keywords per request ($0.15) is cheaper than individual lookups
## Error Handling
- `NO_CREDITS` (402) — Tell the user to add credits at https://yepapi.com/dashboard
- `UPSTREAM_ERROR` (502) — Retry once; if it fails again, skip that step and note it
- `VALIDATION_ERROR` (400) — Check keyword format; keywords must be non-empty strings
- `RATE_LIMITED` (429) — Wait and retry; respect the `Retry-After` headerInstall
Why Use the Keyword Research Skill?
Without this skill, your AI guesses at keyword research patterns. It might hallucinate deprecated APIs, use outdated conventions, or miss best practices entirely. With it, your AI follows a proven ruleset — every suggestion aligns with current standards.
Drop this skill into your project and your AI instantly knows the rules. Better code suggestions, fewer errors, faster shipping. This skill also teaches your AI how to call YepAPI endpoints for real data — keyword metrics, SERP results, backlinks, or whatever this workflow needs.
Try These Prompts
These prompts work better with the Keyword Research skill installed. Your AI knows the context and writes code that fits.
"Build a keyword research tool that shows volume, difficulty, and related terms using YepAPI"
"Create a keyword discovery dashboard with gap analysis and competitor keyword tracking"
"Set up automated keyword monitoring that tracks ranking changes and new opportunities"
Keyword Research skill — FAQ
It connects to YepAPI for keyword discovery, search volume, difficulty scores, and gap analysis. Your AI builds keyword research tools with competitive intelligence and trend data.
Run `npx skills add YepAPI/skills --skill keyword-research` in your project root. This copies the skill file into your repo where your AI coding tool can read it automatically.
YepAPI returns search volume, keyword difficulty, CPC, competition level, and related keyword suggestions. The skill builds tools that combine these metrics for prioritization and gap analysis.