youtube-own-channel-analyzer
npx machina-cli add skill nikhilbhansali/claude-youtube-skills/youtube-own-channel-analyzer --openclawYouTube Own Channel Analyzer
Analyze your YouTube channel's performance using the YouTube Data API v3.
Setup
- API Key: Get from Google Cloud Console - enable YouTube Data API v3
- Channel ID: Accept channel ID (UC...), @handle, or full URL
API Endpoints
BASE_URL = https://www.googleapis.com/youtube/v3
# Channel details
GET /channels?part=snippet,statistics,contentDetails,brandingSettings&id={channelId}&key={API_KEY}
# Channel videos (paginated)
GET /search?part=snippet&channelId={channelId}&order=date&type=video&maxResults=50&key={API_KEY}
# Video details (batch up to 50 IDs)
GET /videos?part=snippet,statistics,contentDetails&id={videoIds}&key={API_KEY}
Analysis Workflow
1. Resolve Channel ID
@handle → Search API with handle, get channelId from result
/channel/UC... → Extract directly
/c/name or /user/name → Use forUsername parameter
2. Fetch Data
- Channel: snippet, statistics, contentDetails, brandingSettings
- Videos: Paginate through search results, then batch video details
3. Analyze
Content Types - Categorize by title/description patterns:
| Type | Pattern |
|---|---|
| Tutorial | tutorial, how to, guide, learn |
| Review | review, unbox, first look, comparison |
| Vlog | vlog, day in, life, daily |
| Educational | explain, education, lesson |
| Gaming | gameplay, game, gaming, stream |
| Music | music, song, cover, lyrics |
Duration Buckets: Short (<5min), Medium (5-15min), Long (15-30min), Very Long (30+min)
Performance Metrics:
- View-to-sub ratio: views/subscribers (benchmark: 10-20%)
- Engagement rate: (likes+comments)/views (benchmark: 1-5%)
- Like rate: likes/views (benchmark: 3-7%)
- Comment rate: comments/views (benchmark: 0.5-2%)
- Viral threshold: views > 5x subscribers
- Underperforming: views < 10% subscribers
Upload Patterns: Track day-of-week, hour-of-day, consistency (stddev of days between uploads)
Title Analysis: Track numbers, emojis, questions, brackets, caps usage, common words
Output Report Structure
# Channel Analysis Report
## Executive Summary
- Subscribers, views, videos, avg engagement, upload consistency
## Channel Overview
- Basic info, statistics table, description, keywords
## Content Analysis
- Category breakdown table, duration distribution, title patterns
## Performance Metrics
- Engagement metrics vs benchmarks table
## Upload Patterns
- Optimal day/hour, distribution charts
## Engagement Analysis
- Top 5 high-engagement videos, bottom 5 needing improvement
## Recommendations
- Content optimization, upload frequency, title suggestions
Helper: Parse Duration
// PT1H2M3S → seconds
const match = duration.match(/PT(?:(\d+)H)?(?:(\d+)M)?(?:(\d+)S)?/);
return (parseInt(match[1])||0)*3600 + (parseInt(match[2])||0)*60 + (parseInt(match[3])||0);
Quota Notes
- Search: 100 units per call
- Channels/Videos: 1 unit per call
- Daily limit: 10,000 units (default)
- Batch video IDs (max 50) to optimize
Source
git clone https://github.com/nikhilbhansali/claude-youtube-skills/blob/master/youtube-own-channel-analyzer/SKILL.mdView on GitHub Overview
Analyzes your YouTube channel’s performance using the YouTube Data API v3. It covers metrics like engagement, content strategy, upload patterns, video performance, and growth trends to generate actionable insights and a channel health report.
How This Skill Works
Resolve the channelId from a handle, UC ID, or full URL, then fetch channel details and video data via YouTube Data API v3 endpoints. The analysis categorizes content types, durations, and patterns, computes engagement benchmarks, and examines upload cadence to produce a comprehensive report.
When to Use It
- Analyze your YouTube channel performance across metrics and trends
- Get insights on video engagement and key metrics (views, likes, comments, shares)
- Understand upload patterns and identify optimal posting times by day and hour
- Identify top performing content types and formats to optimize content mix
- Track subscriber and view growth patterns to forecast channel health
Quick Start
- Step 1: Provide your YouTube Data API v3 key and the target channel identifier (handle, UC..., or URL)
- Step 2: Resolve channelId and fetch channel and video data using channels, search, and videos endpoints
- Step 3: Review the generated Channel Analysis Report and apply the recommendations
Best Practices
- Resolve channelId reliably using handles, user URLs, or direct ID
- Fetch data with pagination and batch video IDs up to 50 to minimize requests
- Classify videos by content type and duration buckets (Short, Medium, Long, Very Long)
- Compute benchmarks: view-to-subscriber, engagement rate, like rate, and comment rate
- Analyze upload cadence using day-of-week/hour distribution and stddev between uploads
Example Use Cases
- Identify top-performing tutorials to inform future content strategy
- Compare educational vs tutorial videos to optimize titles and formats
- Determine optimal posting times by analyzing day/hour distribution
- Monitor subscriber and view growth to assess channel health over time
- Generate a quarterly Channel Analysis Report with metrics and recommendations