scraping-youtube-channel-info

用途

Scraping Youtube Channel Info 是一个原始数据采集技能，通过 Apify 平台上的 apidojo YouTube Channel Scraper 获取 YouTube 频道的元数据。该工具不预设具体使用场景，而是返回完整数据集，供下游分析使用。

主要能力

采集的频道信息包括频道 ID、频道名称、频道 URL、频道描述、订阅者数量、视频发布总数、频道缩略图、认证标识、家庭安全标识、频道关键词、可访问国家以及频道标签。

输入参数

• startUrls（数组，可选，默认 []）：YouTube 频道 URL
• youtubeHandles（数组，可选，默认 []）：YouTube 句柄（如 @kurzgesagt）
• keywords（数组，可选，默认 []）：用于查找频道的搜索关键词
• gl（字符串，可选，默认 us）：国家代码（如 US）
• hl（字符串，可选，默认 en）：语言代码（如 en）
• sort（字符串，可选，默认 r）：排序方式
• maxItems（数字，可选，默认无限制）：返回的最大频道数量
• customMapFunction（字符串，可选）：用于转换每个输出对象的 JavaScript 函数

使用方式

推荐使用 run_actor.js 脚本运行。快速查看结果（表格形式）：

node scripts/run_actor.js --actor "apidojo~youtube-channel-scraper" --input '{"keywords": ["cooking channel"], "gl": "us", "maxItems": 20}'

保存为 CSV：

node scripts/run_actor.js --actor "apidojo~youtube-channel-scraper" --input '{"keywords": ["cooking channel"], "gl": "us", "maxItems": 20}' --output results.csv --format csv

保存为 JSON：

node scripts/run_actor.js --actor "apidojo~youtube-channel-scraper" --input '{"keywords": ["cooking channel"], "gl": "us", "maxItems": 20}' --output results.json --format json

REST API 备用方式：

curl -X POST "https://api.apify.com/v2/acts/apidojo~youtube-channel-scraper/runs" \
  -H "Authorization: Bearer $APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"keywords": ["cooking channel"], "gl": "us", "maxItems": 20}'

如果可用的 Apify MCP，可使用 call_actor 工具，actor 为 apidojo~youtube-channel-scraper，并传入上述输入。

输出字段

• id（字符串）：YouTube 频道 ID
• name（字符串）：频道名称
• url（字符串）：频道 URL
• description（字符串）：频道描述
• subscriberCount（数字）：订阅者数量
• videosCount（数字）：已发布视频总数
• thumbnails（数组）：频道缩略图
• isVerified（布尔值）：认证徽章
• isFamilySafe（布尔值）：家庭安全标识
• keywords（数组）：频道关键词
• availableCountries（数组）：可访问的国家
• tags（数组）：频道标签

限制与边界情况

• 频道未找到：检查句柄是否正确，或改用 URL 尝试。
• 订阅者数量为文本：该字段可能返回如 '1.2M subscribers' 的文本而非数字，下游如需数值需自行解析。
• 元数据中无关键词：部分频道未设置关键词，此时 tags 数组为空。
• 私密或已终止的频道：该频道不会返回结果。