用途:为指定主题、受众需求、语言、市场、形式和频道构建内容规划地图,识别样本中的内容空白并形成可测试的内容假设。
主要能力:使用 Crawlora 的 YouTube 查询、类型、上传日期、时长、地区等筛选条件与续页令牌,收集可辩护的视频样本;解析真实视频/频道 ID 与规范 URL,跨搜索去重;查看视频元数据与频道归档;先发现字幕语言再请求字幕,保留生成/原始/翻译语言与时间戳上下文。
使用方式:设置 CRAWLORA_API_KEY;已连接时优先使用 Crawlora MCP 工具,否则使用 scripts/crawlora.sh,它向 https://api.crawlora.net/api/v1 发送 x-api-key。参考 reference/endpoints.md 获取方法与参数。示例:scripts/crawlora.sh /youtube/search q="home energy efficiency" type=video upload_date=this_year sort_by=relevance;再用实际返回的视频 ID 执行 scripts/crawlora.sh "/youtube/transcript/$VIDEO_ID/languages" 与 scripts/crawlora.sh "/youtube/transcript/$VIDEO_ID" format=json。
限制:搜索热度只是发现入口,不代表全部视频或未满足需求;Shorts、长视频、直播、播放列表是不同单位,需分开处理;缺失或取整的公开字段保持未知,不承诺历史观看曲线;字幕 404 表示当前无字幕,与上游临时错误不同;无字幕证据时主题编码只能标注为仅标题/描述。自动字幕与翻译可能误识别,不独立验证主张,不得复制完整字幕。低覆盖不等于主题缺失、供给不足或商业价值高;高观看或评论不证明受众画像、转化、收入、留存或可复制的未来表现。因果性、标题或缩略图建议需进一步测试,应标注为假设。不得上传、评论、私信创作者、下载受限媒体或创建持续监控。