AI YouTube Agent
September 9, 2026 · View on GitHub
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.publishcapability 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.mdfiles 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 | Blueprint |
| Competitor Channel Analysis | Tracks a competitor channel's upload cadence, top videos, and tag strategy | Blueprint |
| Trend Discovery | Surfaces what's currently trending in a niche on YouTube | Tested |
| Channel Analytics | Reports on the user's own channel performance (views, watch time, subscriber growth) | Coming Soon |
Required Muapi APIs
Live today:
social.publish(viaai-social-agent) — publishes a video to a connected YouTube account with title, description, and tags.media.generate_image(viaai-image-agent) — generates the thumbnail, using a text-capable model per that repo'sMODELS.md.seo.keyword_research(viaai-seo-agent) — general Google keyword-volume data, used as an imperfect proxy for YouTube search demand until YouTube-specific keyword data is live.- YouTube Organic (
POST /api/v1/seo-youtube-organic) — YouTube search rankings for a keyword. Backs keyword-tag-research and trend-discovery. - YouTube Video Info (
POST /api/v1/seo-youtube-video-info) — per-video stats/metadata. Backs competitor-channel-analysis. - YouTube Video Comments (
POST /api/v1/seo-youtube-video-comments) — comment-volume/engagement signal. Backs trend-discovery. - YouTube Video Subtitles (
POST /api/v1/seo-youtube-video-subtitles) — transcript data, useful for deeper competitor analysis.
Not yet live: a dedicated "list a channel's recent videos" endpoint (youtube.channel_videos) for competitor-channel-analysis. Official YouTube Analytics (private, per-channel, requires the channel owner's own OAuth) is still needed for channel-analytics — that data isn't public and no third-party marketplace can proxy it.
Setup
- Create a Muapi account and API key at muapi.ai.
- Connect a YouTube account via Muapi's social OAuth flow (see
ai-social-agent) before using Video SEO Optimization's publish step. - Review the OpenAPI schema.
- Load the
SKILL.mdfor 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/mcpwith anAuthorization: Bearer YOUR_MUAPI_KEYheader. - 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
Muapi's YouTube-native SERP APIs (seo-youtube-organic, seo-youtube-video-info, seo-youtube-video-subtitles, seo-youtube-video-comments) went live and were verified end-to-end 2026-09-09. Trend Discovery is now Tested — it composes entirely from seo-youtube-organic + seo-youtube-video-comments, both confirmed live. Keyword & Tag Research and Competitor Channel Analysis are Blueprint — each has one capability now live and tested (seo-youtube-organic for search volume, seo-youtube-video-info for per-video stats) but still depends on one capability DataForSEO doesn't offer at all (a YouTube-native related-keyword expansion, and a "list a channel's videos" endpoint respectively) — each SKILL.md states the specific gap and the fallback it uses in the meantime. Video SEO Optimization remains Blueprint, unaffected by this — it composes capabilities already live elsewhere (image generation, keyword research, social publish). Channel Analytics stays Coming Soon — it's OAuth-gated private analytics no third-party provider can ever supply.
Contributing
See Agency Agents OS CONTRIBUTING.md.