AI YouTube Agent

An AI agent for YouTube growth — keyword and tag research, competitor channel analysis, video SEO (titles/descriptions/tags/thumbnails), trend discovery, and channel analytics — the VidIQ-style toolkit, built to work with Muapi.

Part of Agency Agents OS, an open ecosystem of specialized AI agents for real business work.

Related Projects

• Agency Agents OS — the central catalog this repo is part of.
• ai-social-agent — provides the live social.publish capability this repo's video-seo-optimization sub-agent uses to actually upload to YouTube.
• ai-image-agent — generates the thumbnails this repo drafts, using its text-capable model picks.
• ai-seo-agent — provides the Google-keyword-data proxy used until YouTube-native keyword data is live; shares the same underlying provider (DataForSEO) this repo's Coming Soon sub-agents are waiting on.
• ai-content-repurposing-agent — clips long-form video into Shorts for the same channel.
• MuAPI MCP docs — connect this repo's SKILL.md files via MCP.
• MuAPI access keys — create the API key this agent needs.

What this covers

This repo is the umbrella for anything a creator or agency would call "the AI YouTube agent": finding what to make a video about, optimizing a video's title/description/tags/thumbnail before publishing, watching what competitor channels are doing, and tracking channel performance — without pasting data between five separate creator tools.

Sub-agents

Agent	Does	Status
Video SEO Optimization	Crafts a keyword-optimized title/description/tags/thumbnail for a video, then publishes it	Blueprint
Keyword & Tag Research	Finds YouTube search keywords and tags worth targeting for a video	Coming Soon
Competitor Channel Analysis	Tracks a competitor channel's upload cadence, top videos, and tag strategy	Coming Soon
Trend Discovery	Surfaces what's currently trending in a niche on YouTube	Coming Soon
Channel Analytics	Reports on the user's own channel performance (views, watch time, subscriber growth)	Coming Soon

Required Muapi APIs

Live today (reused from sibling umbrellas — no YouTube-specific endpoint yet):

• social.publish (via ai-social-agent) — publishes a video to a connected YouTube account with title, description, and tags.
• media.generate_image (via ai-image-agent) — generates the thumbnail, using a text-capable model per that repo's MODELS.md.
• seo.keyword_research (via ai-seo-agent) — general Google keyword-volume data, used as an imperfect proxy for YouTube search demand until YouTube-specific keyword data is live.

Not yet live, but the same provider Muapi's SEO API already runs on (DataForSEO) sells all four of these — completing that integration, not bringing in a new vendor, would close every Coming Soon sub-agent in this repo:

• YouTube Organic — YouTube search rankings for a keyword. Closes keyword-tag-research and trend-discovery.
• YouTube Video Info — per-video stats/metadata. Closes competitor-channel-analysis.
• YouTube Video Subtitles / YouTube Video Comments — transcript and comment data, useful for trend-discovery and deeper competitor analysis.

Official YouTube Analytics (private, per-channel, requires the channel owner's own OAuth) would still be needed for channel-analytics regardless of DataForSEO — that data isn't public and no third-party marketplace can proxy it.

Setup

1. Create a Muapi account and API key at muapi.ai.
2. Connect a YouTube account via Muapi's social OAuth flow (see ai-social-agent) before using Video SEO Optimization's publish step.
3. Review the OpenAPI schema.
4. Load the SKILL.md for the sub-agent you need into your agent runtime, or follow it manually.

Using with an AI agent

Every sub-agent's SKILL.md is model- and runtime-agnostic — it's plain Markdown, so it works with any LLM agent, not just Claude. Two integration paths:

As an MCP connection (the agent gets live Muapi tools):

Muapi runs an MCP server at https://api.muapi.ai/mcp that any MCP-compatible client can connect to — Cursor, Windsurf, Claude, or your own custom agent.

• Cursor / Windsurf / other clients with a header field: connect to https://api.muapi.ai/mcp with an Authorization: Bearer YOUR_MUAPI_KEY header.
• claude.ai / Claude Cowork / other connector UIs with no header field: use the URL-embedded key form instead, https://api.muapi.ai/mcp/YOUR_MUAPI_KEY, via Settings → Connectors → Add custom connector.
• Claude Code / Claude Desktop: claude mcp add muapi -e MUAPI_API_KEY=YOUR_MUAPI_KEY -- muapi mcp serve (uses the muapi CLI's stdio transport — Claude Code's HTTP MCP client doesn't reliably inject tools).

Full setup details for every client: muapi.ai/docs/mcp.

As agent instructions (any LLM follows the workflow directly):

Drop a sub-agent's SKILL.md into a Claude Code project's .claude/skills/ directory, paste it into a custom-GPT/Project's system instructions, hand it to an autonomous agent framework as a tool spec, or attach it directly in a chat conversation — then ask the agent to follow it.

Read-only vs. write actions

Keyword research, competitor analysis, trend discovery, and channel analytics are read-only. Video SEO Optimization is requires-approval-to-publish for the publish step — it drafts the title/description/tags/thumbnail freely, but never uploads without explicit approval.

Status and limitations

Video SEO Optimization is Blueprint — it's a real, executable workflow entirely on capabilities already live elsewhere in Agency Agents OS (image generation, keyword research, social publish), even though none of them are YouTube-native. The other four sub-agents are Coming Soon — they depend on YouTube-specific search/video/channel data that isn't live on Muapi yet, though the underlying provider (DataForSEO) already sells it.

Contributing

See Agency Agents OS CONTRIBUTING.md.

License

MIT