Kim Doyal installed a Claude Code agent on a plane for her YouTube videos research. No developer. No setup call. No tutorial series.
She opened her laptop somewhere over the Pacific, followed a few steps, and had a working content research agent before landing. That one moment sent her on an 18-month journey from one agent to 33.
👋 Julley, I'm Dheeraj, an AI systems builder.
I build production-grade AI systems at work by day and ship my own products by night, 9 and counting, including SubflowAI and the Content OS Agents Toolkit. This newsletter is the bridge between those two worlds. Every system, every build, documented step by step.
Join 1,800+ builders getting the exact AI setups, prompts, and workflows that actually work in your business.
How to create YouTube Research Agent in Claude Code?
In a recent Substack Live conversation with Kim Doyal, we walked through the exact system she uses, including the YouTube Research Agent that replaced her TubeBuddy / VidIQ subscriptions entirely. Kim has been creating content online for 17 years. She is not a developer. And she has never written a line of code for any of her 33 agents.
By the end of this article, you’ll have the full 3-layer architecture to build your own YouTube Research Agent, understand exactly what it produces, know how to control costs from day one, and have a clear first step to get it running this week.
The journey to her 33 AI agents team was made possible through my PubflowOS AI Agents foundational series. It gives you the exact Claude code agent building blueprint that you can replicate to build your own.
The word “code” in Claude Code is the single biggest misconception stopping content creators from building research systems that would save them hours every week and hundreds of dollars every month. You don’t code. You describe. Claude does the rest.
Why Are Content Creators Still Paying for YouTube Research Tools?
Most solo content creators running a YouTube channel pay for at least one research tool. TubeBuddy runs $15-35 per month. VidIQ has paid tiers. SEM Rush costs $150 per month or more, and it caps the number of articles or videos it will refresh each month (I was paying $150 per month for a blog refresh service that would only update 12 articles, capped).
The problem is not just the cost. It is that these tools give you generic intelligence.
They do not know your niche.
They do not know your audience the way you want.
They do not know your competitors by name the way you want.
They do not know your content history or your channel’s positioning.
They give you the same data they give everyone else in your space, which means they give you the same opportunities they give your competitors.
In comparison
A Claude Code YouTube Research Agent costs nothing per month beyond your Claude subscription.
It pulls real YouTube data through the free YouTube Data API (10,000 units per day, enough for 100 searches daily).
It knows your specific niche, your named competitors, your content strategy, and your channel’s positioning because you told it once and it remembers.
That’s the shift worth paying attention to here.
What Is a Claude Code Agent, Exactly?
A Claude Code agent is a plain-English instruction file, stored in a folder called .claude inside your project. It tells Claude what to do, which tools to use, which external APIs to call, what context files to load before starting, and what cost limits to respect.
As Kim Doyal put it at 2:30, cutting straight to what confused her friends: “I think of agents as a set of instructions.” That’s it. Not a program. Not a script. Not a piece of software you maintain.
A markdown or YAML file that says: here’s your job, here are your tools, here’s what you know about my business, here’s how many API calls you’re allowed to make.
In the world run by Claude today, you no longer need n8n, AutoGPT, or any agent framework to build working research agents. The architecture lives in three plain-text files.
If you’re new to Claude Code, this primer on building your first Claude Code agent covers the fundamentals before you add the YouTube API layer.
Commercial break: Claude Code Builder cohort
The founding batch of my Claude Code cohort starts in July on Maven. Four weeks, six sessions. Learn to build the AI system with me.
Only 12 Seats. When they’re gone, the founding price ($797) closes and Cohort 2 opens at $1,597.
Use code GENAI20 for 20% off. Expires July 9. Check the Syllabus →
What Does the YouTube Research Agent Actually Produce?
The agent runs in five modes covering the full research workflow. During the live session at 33:30, Dheeraj ran a live demo on the plant-based meals niche. The agent completed the full research cycle in under 60 seconds.
Five modes of YouTube AI Agent
--discover: Content gap analysis on a topic. What’s already out there, what’s missing, what angle does not yet exist?--topic [keyword]: Deep research on a specific keyword. Search volume signals, competitor video performance, trending angles.--audit: Channel audit for a specific competitor. Their top performers, their content patterns, their gaps.--shorts: Shorts-specific research. What formats are working, which topics convert to Shorts well.--thumbnails: Thumbnail and title pattern analysis. What title structures are getting the most clicks in your niche.
The live demo output on plant-based meals included: top 5 themes by performance, a list of content gaps, trending signals from the last 90 days, title formats that are outperforming their channel size, and 10 specific video opportunities ranked by a custom signal score.
The content gap discovery
Every beginner guide in the plant-based meals space comes from doctors or single adults. Zero content exists for parents trying to transition their kids. That’s a genuine gap, surfaced in under a minute, by an agent that cost $0 to run.
Custom Signal Score
In the setup guide below, you will see my custom signal scoring formula that correlates views, subscriber count of the posting channel, comment count, and like count into a single multiplier.
This signal score helped me replace the vidIQ subscription that provided guidance on which video to create next.
How Does the 3-Layer Architecture Work?
The 3-layer architecture is the foundation that makes every Claude Code agent reusable and personalizable. Build it once, and adding your 10th or 30th agent takes an afternoon instead of a week.
Kim Doyal built 33 agents from a single foundation. Every one follows the same three layers architecture.
Layer 1: The Data/Integration Layer
This is where external intelligence comes from. For a YouTube Research Agent, the data/integration layer includes:
YouTube Data API (free, 10,000 units/day): Real video data, not estimates. Actual view counts, subscriber numbers, engagement metrics.
Perplexity or Tavily (web research MCP): Used for enrichment, competitor analysis, and trend validation after the YouTube API pulls initial data.
Optional: Notion or Obsidian for connecting your personal content database, video archive, or subscriber research.
The data layer is swappable. If you start with Perplexity and want to switch to Tavily later, you change one line in your MCP configuration file. The rest of the architecture stays the same.
Layer 2: Context Profiles
This is what makes your agent different from a generic research tool. Context profiles are plain-text files stored in your .claude folder:
business-context.md: Your niche, your audience, your channel positioning, your goalscontent-strategy.md: Your content pillars, your publishing cadence, your existing video archivecompetitor-watch-list.md: Named competitors with their channel links, their strengths, gaps you’ve identified
Every time the agent runs a research session, it loads these files first. It knows who you are before it touches the YouTube API. This is why two people running the same agent on the same keyword get completely different outputs.
Layer 3: The Agent File
A YAML file in your .claude folder. It contains: the agent name, a description Claude uses to decide when to suggest it, a list of tools it’s allowed to use (read, write, search), the model it runs on (Opus for planning, Sonnet for execution), the research modes it supports, and, critically, the cost limits written in plain English.
At 19:57, Dheeraj walked through why this matters: without explicit cost limits in the agent file, Claude will make hundreds of YouTube API calls in a single session. You hit your daily free quota in minutes. Writing the limit once prevents that permanently.
Get PluggedIn
Two non-developers replaced $50/month in YouTube research subscriptions with a 3-file Claude Code agent. No code written.
Every month you stay with SEM Rush, TubeBuddy, or VidIQ, you’re paying up to $15-50 for data that’s identical to what your competitors are buying. Niche-agnostic. Capped. The $150/month I was paying for a service that refreshed just 12 articles is the cost of not having a personalized agent.
Get PluggedIn to go from paying for generic research data to running a YouTube Research Agent that knows your niche, your competitors by name, and your channel’s positioning. The complete agent file, MCP configuration, context profile templates, and custom signal scoring formula from this session are inside.
