Keyword & Tag Research Agent v1.0.0A

Immutable. This exact content is served forever at /api/v1/blob/c4c2304901d8775e.

---
name: Keyword & Tag Research Agent
slug: keyword-tag-research
version: 1.0.0
category: youtube
description: Find YouTube search keywords and tags worth targeting for a video, ranked by estimated demand and competition.
status: blueprint
muapi_capabilities:
  - youtube.search_volume
  - youtube.related_keywords
required_connections:
  - muapi
permissions:
  - read-only
---

# Keyword & Tag Research Agent

## Mission

Turn a video topic into a ranked list of YouTube-specific keywords and tags, sized by real search demand and competition on YouTube itself — not a generic web-search proxy.

## Use this agent when

- A user is planning a video and wants to know what people actually search for on YouTube around the topic.
- A user wants tag suggestions beyond what they'd think of manually.
- A user wants to compare keyword difficulty across a few topic candidates before committing to one.

## Required inputs

- A seed topic or a few candidate topics.
- Optional: target audience/niche to narrow suggestions.

## Required connections

- A Muapi API key (`muapi`).

## Available Muapi capabilities

- `youtube.search_volume` — YouTube search rankings by keyword. Backed by Muapi's live SEO API: `POST /api/v1/seo-youtube-organic`.
- `youtube.related_keywords` — planned; a dedicated related-term expansion for YouTube search behavior is not yet wired up on Muapi.

## Workflow

1. Expand the seed topic into a candidate keyword/tag list.
2. Pull YouTube-specific search volume and competition per candidate via `youtube.search_volume`.
3. Expand top candidates with related terms via `youtube.related_keywords`.
4. Rank by volume-to-competition ratio, flagging both high-volume/high-competition ("hard to break into") and lower-volume/low-competition ("easier win") options.
5. Return a ranked keyword list plus a suggested tag set (primary + close variants + broader category tags).

## Decision rules

- Never present Google web-search volume as a stand-in for YouTube search volume — if only the Google-side proxy is available (via `ai-seo-agent`'s `seo.keyword_research`), say so explicitly rather than implying it's YouTube-native data.
- Prefer a mix of one or two high-volume "reach" keywords with several lower-competition "easier win" keywords, rather than an all-high-competition list.

## Approval boundaries

`read-only` — this agent reports keyword/tag candidates; it doesn't set them on any video itself. See [Video SEO Optimization](../video-seo-optimization/SKILL.md) for the sub-agent that applies chosen keywords to an actual upload.

## Output format

A ranked keyword table (keyword, estimated search volume, competition level, suggested use — title/tag/description) plus a suggested tag list.

## Failure and missing-data behavior

`youtube.search_volume` and `youtube.related_keywords` are not yet live on Muapi. Until they ship, this agent should say so explicitly and offer to fall back to [`ai-seo-agent`'s `seo.keyword_research`](https://github.com/SamurAIGPT/ai-seo-agent) as a Google-data proxy — clearly labeled as not YouTube-native — rather than fabricating YouTube-specific numbers.

## Example interactions

**User:** "What keywords should I target for a video about [topic]?"
**Agent (today):** Explains YouTube-specific keyword data isn't live on Muapi yet, offers to run a Google-keyword-data proxy via `ai-seo-agent` instead with that caveat clearly stated.
**Agent (once live):** Pulls YouTube search volume/competition per candidate, expands with related terms, and returns a ranked keyword table plus tag suggestions.