keyapi-youtube-channel-analysis

Discover, profile, and analyze YouTube channels — from identity resolution and metadata retrieval to video inventory, channel search, and advanced filtered discovery.

This skill provides comprehensive YouTube channel intelligence using the KeyAPI MCP service. It enables detailed channel profile retrieval (including a two-step process for full metadata), video library enumeration, bidirectional conversion between channel IDs and URLs, keyword-based channel search, within-channel content search, advanced filtered search across YouTube, and search suggestion retrieval — all through a cache-first workflow.

Use this skill when you need to:

• Retrieve full channel metadata including description, subscriber count, view count, join date, and social links
• Convert between channel URLs (various formats) and channel IDs, or resolve @username handles
• Enumerate a channel's published video library with pagination support
• Search for channels by keyword with result filtering to channel-type only
• Search within a specific channel's content by keyword
• Perform advanced YouTube searches with filters (upload time, duration, content type, features, sort order)
• Get real-time search suggestions for keyword research and autocomplete

author: KeyAPI license: MIT repository: https://github.com/EchoSell/keyapi-skills

Prerequisites

author: KeyAPI license: MIT repository: https://github.com/EchoSell/keyapi-skills

MCP Server Configuration

All tool calls in this skill target the KeyAPI YouTube MCP server:

Server URL : https://mcp.keyapi.ai/youtube/mcp
Auth Header: Authorization: Bearer $KEYAPI_TOKEN

Setup (one-time):

# 1. Install dependencies
npm install

# 2. Set your API token (get one free at https://keyapi.ai/)
export KEYAPI_TOKEN=your_token_here

# 3. List all available tools to verify the connection
node scripts/run.js --platform youtube --list-tools

author: KeyAPI license: MIT repository: https://github.com/EchoSell/keyapi-skills

Analysis Scenarios

Channel Identity & Metadata Nodes

Channel Content Nodes

Search & Discovery Nodes

author: KeyAPI license: MIT repository: https://github.com/EchoSell/keyapi-skills

Workflow

Step 1 — Identify the Channel Analysis Objective and Select Nodes

Clarify the research goal and map it to one or more nodes. Common patterns:

• Channel profile deep-dive: Use get_channel_description twice — first call with channel_id returns basic info + continuation_token; second call with that token returns advanced info (join date, social links, view count).
• URL → ID conversion: Use get_channel_id_from_url to normalize any channel URL format to a channel ID.
• ID → @handle conversion: Use get_channel_url_from_channel_id to get the user-friendly @username from a channel ID.
• Channel discovery: Use search_channels with keyword → optionally deepen with get_channel_description for each result.
• Video inventory: Use get_channel_videos with channel_id (must be UC-format) → paginate with continuation_token.
• Advanced search: Use general_search_with_filters with upload time, duration, content type, and sort filters.

Channel ID formats

• UC-format: 24-character string starting with UC (e.g., UCeu6U67OzJhV1KwBansH3Dg) — required for get_channel_videos and get_channel_description.
• @username format: User-friendly handle (e.g., @CozyCraftYT) — use get_channel_id_from_url to convert to UC-format.
• URL formats: Supports youtube.com/@username, youtube.com/channel/UCxxxxxx, youtube.com/c/name, youtube.com/user/name.

get_channel_description two-step process

This endpoint requires two sequential calls to retrieve complete channel information:

1. First call: Pass channel_id → returns basic info (name, description, subscriber count, video count, banner) + continuation_token.
2. Second call: Pass continuation_token from step 1 → returns advanced info (join date, social media links, featured sections, total view count).

Do NOT call both simultaneously — the second call depends on the token from the first.

Step 2 — Retrieve API Schema

Before calling any node, inspect its input schema to confirm required parameters and available options:

node scripts/run.js --platform youtube --schema \x3Ctool_name>

# Examples
node scripts/run.js --platform youtube --schema get_channel_description
node scripts/run.js --platform youtube --schema general_search_with_filters

Step 3 — Call APIs and Cache Results Locally

Execute tool calls and persist responses to the local cache.

Calling a tool:

node scripts/run.js --platform youtube --tool \x3Ctool_name> \
  --params '\x3Cjson_args>' --pretty

# Skip cache for fresh results
node scripts/run.js --platform youtube --tool \x3Ctool_name> \
  --params '\x3Cjson_args>' --no-cache --pretty

Example — get full channel metadata (two-step):

# Step 1: Get basic info + continuation_token
node scripts/run.js --platform youtube --tool get_channel_description \
  --params '{"channel_id":"UCeu6U67OzJhV1KwBansH3Dg","language_code":"en-US","country_code":"US","need_format":true}' --pretty

# Step 2: Get advanced info using continuation_token from Step 1
node scripts/run.js --platform youtube --tool get_channel_description \
  --params '{"continuation_token":"\x3Ctoken_from_step_1>","language_code":"en-US","country_code":"US","need_format":true}' --pretty

Example — convert channel URL to ID:

node scripts/run.js --platform youtube --tool get_channel_id_from_url \
  --params '{"channel_url":"https://www.youtube.com/@CozyCraftYT"}' --pretty

Example — get @handle from channel ID:

node scripts/run.js --platform youtube --tool get_channel_url_from_channel_id \
  --params '{"channel_id":"UCeu6U67OzJhV1KwBansH3Dg"}' --pretty

Example — get channel videos (first page):

node scripts/run.js --platform youtube --tool get_channel_videos \
  --params '{"channel_id":"UCJHBJ7F-nAIlMGolm0Hu4vg","language_code":"en-US","country_code":"US"}' --pretty

Example — paginate to next video page:

node scripts/run.js --platform youtube --tool get_channel_videos \
  --params '{"channel_id":"UCJHBJ7F-nAIlMGolm0Hu4vg","continuation_token":"\x3Ctoken>"}' --pretty

Example — search channels by keyword:

# First page
node scripts/run.js --platform youtube --tool search_channels \
  --params '{"keyword":"fitness","need_format":true}' --pretty

# Next page
node scripts/run.js --platform youtube --tool search_channels \
  --params '{"continuation_token":"\x3Ctoken>","need_format":true}' --pretty

Example — search within a channel:

node scripts/run.js --platform youtube --tool search_channel \
  --params '{"channel_id":"UCXuqSBlHAE6Xw-yeJA0Tunw","search_query":"AMD","language_code":"en","country_code":"US"}' --pretty

Example — advanced filtered search:

node scripts/run.js --platform youtube --tool general_search_with_filters \
  --params '{"search_query":"Python tutorial","upload_time":"month","duration":"medium","content_type":"video","feature":"hd","sort_by":"view_count","language_code":"en-US","country_code":"US"}' --pretty

Example — get search suggestions:

node scripts/run.js --platform youtube --tool get_search_suggestions \
  --params '{"keyword":"machine learning","language":"en","region":"US"}' --pretty

Example — resolve channel name to ID:

node scripts/run.js --platform youtube --tool get_channel_id \
  --params '{"channel_name":"LinusTechTips"}' --pretty

Pagination:

Cache directory structure:

.keyapi-cache/
└── YYYY-MM-DD/
    ├── get_channel_description/
    │   └── {params_hash}.json
    ├── get_channel_id_from_url/
    │   └── {params_hash}.json
    ├── get_channel_url_from_channel_id/
    │   └── {params_hash}.json
    ├── get_channel_videos/
    │   └── {params_hash}.json
    ├── get_channel_id/
    │   └── {params_hash}.json
    ├── search_channels/
    │   └── {params_hash}.json
    ├── search_channel/
    │   └── {params_hash}.json
    ├── general_search_with_filters/
    │   └── {params_hash}.json
    └── get_search_suggestions/
        └── {params_hash}.json

Cache-first policy:

Before every API call, check whether a cached result already exists. If valid, load from disk and skip the API call.

Step 4 — Synthesize and Report Findings

For channel analysis:

1. Channel Overview — Name, @handle, channel ID, subscriber count, total video count, total view count, join date, verification status.
2. Channel Description — Bio, featured links, social media connections, country/language.
3. Content Inventory — Video count, upload frequency, most recent video date, content categories.
4. Audience Signals — Subscriber-to-view ratio, engagement indicators from recent videos.
5. Featured Sections — Playlists, channels, or content highlighted by the creator.

For channel discovery:

1. Search Results Overview — Matched channels, subscriber counts, verification status, content focus.
2. Comparative Analysis — Side-by-side metrics for shortlisted channels.
3. Keyword Expansion — Search suggestions for related queries, trending topics.

author: KeyAPI license: MIT repository: https://github.com/EchoSell/keyapi-skills

Common Rules

author: KeyAPI license: MIT repository: https://github.com/EchoSell/keyapi-skills

Error Handling