Content Research Agent Skill
Content planning with trend and sentiment data from YepAPI.
The Skill
Full content, every format. Copy it, download it, or install with one command.
---
description: Content planning with trend and sentiment data from YepAPI.
homepage: https://yepapi.com/skills/content-research
metadata:
tags: [yepapi, seo, content, trends, ai-visibility]
---
# Content Research Workflow
Content planning with trend and sentiment data using YepAPI endpoints.
## Endpoints Used
| Endpoint | Cost | Purpose |
|----------|------|---------|
| `POST /v1/seo/trends` | $0.02 | Google Trends interest over time (up to 5 keywords) |
| `POST /v1/seo/keywords/ideas` | $0.03 | Keyword suggestions from a seed keyword |
| `POST /v1/seo/keywords` | $0.15 | Bulk keyword metrics (volume, CPC, difficulty) |
| `POST /v1/seo/ai/chatgpt` | $0.05 | What ChatGPT says about a query |
| `POST /v1/seo/ai/gemini` | $0.05 | What Gemini says about a query |
## Workflow
### Step 1: Check Trends
Run `POST /v1/seo/trends` with topic keywords.
```json
{
"keywords": ["content marketing", "ai content", "seo strategy"]
}
```
Returns: interest over time for each keyword — spot seasonal patterns and rising topics.
### Step 2: Discover Content Angles
Run `POST /v1/seo/keywords/ideas` with a seed keyword.
```json
{
"keyword": "content marketing",
"location": "us"
}
```
Returns: keyword suggestions you might not have considered — each is a potential content angle.
### Step 3: Evaluate Keywords
Run `POST /v1/seo/keywords` on discovered keywords.
```json
{
"keywords": ["content marketing strategy", "content marketing examples", "content marketing roi"],
"location": "us"
}
```
Returns: search volume, CPC, keyword difficulty, search intent, 12-month trends.
### Step 4: Check AI Visibility
Run `POST /v1/seo/ai/chatgpt` and `POST /v1/seo/ai/gemini` to see what AI says about the topic.
```json
{
"query": "best content marketing strategies"
}
```
Returns: what each LLM currently says — useful for understanding the AI landscape around your topic.
### Step 5: Compile Content Brief
Compile into a content brief:
- **Target keyword** — highest opportunity (volume vs difficulty)
- **Supporting keywords** — related terms to include
- **Trend direction** — rising, stable, or declining
- **AI landscape** — what LLMs currently say, gaps to fill
## Rules
- Trends data shows seasonal patterns — check for upcoming peaks
- AI visibility checks reveal what LLMs currently say about a topic (useful for AI SEO)
- Keyword ideas give you content angles you might not have considered
- Always check difficulty before committing to a keyword — avoid DR 80+ terms for new sites
## 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 Content Research Skill?
Without this skill, your AI guesses at content 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 Content Research skill installed. Your AI knows the context and writes code that fits.
"Build a content planning dashboard with trend data and sentiment analysis using YepAPI"
"Create a topic research tool that identifies content gaps and trending topics in my niche"
"Set up automated content briefs generated from SERP analysis and competitor content"
Works Great With
Content Research skill — FAQ
It connects to YepAPI for trend detection, sentiment analysis, and content gap identification. Your AI generates content research tools that surface data-driven topic ideas.
Run `npx skills add YepAPI/skills --skill content-research` in your project root. This copies the skill file into your repo where your AI coding tool can read it automatically.
YepAPI provides search volume trends, content performance signals, and topic sentiment data. The skill uses this to identify content gaps and trending topics for your editorial calendar.