安装指南

1. ClawHub CLI 从源直接安装技能的最快方式。
   npx clawhub@latest install youtube-content-gap-analysis
2. 手动安装 将技能文件夹复制到以下位置之一
   全局模式
   ~/.openclaw/skills/
   工作区
   /skills/
   优先级：工作区 > 本地 > 内置
3. 提示词安装 将此提示词复制到 OpenClaw 即可自动安装。
   请帮我使用 Clawhub 安装 youtube-content-gap-analysis。如果尚未安装 Clawhub，请先安装（npm i -g clawhub）。
   更倾向于下载？
   获取包含原生技能文件的ZIP压缩包。
   下载技能 (.zip)

什么是

YouTube 内容差距分析可针对特定受众、语言、市场和日期范围，建立对已观察到的主题、形式、深度及频道覆盖情况的循证认知。它使用 Crawlora 搜索以及可获取的视频、频道和字幕数据，整理出有依据的样本，而非声称拥有完整清单或证明受众需求尚未得到满足。
在 Openclaw Skills 中，这项技能因保留发现结果的局限性和来源信息而独具特色：它会记录查询、筛选条件、来源标识符、日期、抽样边界和无法获取的内容。最终结果是按主题与形式或频道划分的矩阵，以及一组与实际样本差距相关联、按优先级排序的内容假设。

应用场景

围绕特定主题、受众需求、语言、市场或发布时段确定 YouTube 研究范围。
比较 Shorts、长视频、直播和播放列表的抽样覆盖情况，但不将它们视为可互换的内容。
找出在限定的视频或频道样本中出现频率较低的主题或子主题。
根据视频元数据以及可用时带时间戳的字幕证据，制作内容简报。
在向内容团队分享建议前，记录研究样本能够和不能够支持的结论。
生成有待进一步测试的假设，而不把观看次数、评论或较低的观察覆盖率当作需求或增长潜力的证明。

工作原理

确定研究范围：主题、受众需求、语言、市场、形式、频道、日期窗口、查询同义词，以及有限的搜索和频道预算。
如可用，连接 Crawlora MCP 工具；否则，使用附带的脚本和 Crawlora API 密钥。有关支持的方法和参数，请查阅端点参考文档。
使用已记录的查询、类型、上传日期、时长和地区筛选条件搜索 YouTube。记录每次查询、排序方式、筛选条件、抽样页面、续页令牌和停止原因。
确认规范视频和频道 ID 及 URL，区分视频、频道和播放列表，并对多个搜索结果中重复出现的同一视频去重。
检查选定视频的元数据和频道档案。将来源日期与观察或抓取时间分开保存，并记录覆盖依据以及不可用或未知的字段。
请求字幕前，先查明可用的字幕语言。保留自动生成或翻译的语言信息及时间戳上下文；若无法获取字幕或其他内容证据，则将主题分类标为“仅依据标题/描述”。
使用统一的主题、子主题、形式、深度和预期用途标准。允许多标签和不确定编码；只有字幕支持时才引用简短的带时间戳证据。
提交矩阵，列明唯一视频的分母、日期、采集范围和不可用内容数量；随后提供按优先级排序、并表述为可测试假设的内容创意。

配置指南

获取 Crawlora API 密钥，并在代理使用的环境中将其设为 CRAWLORA_API_KEY。
若已连接，请使用所列的 Crawlora MCP 工具。否则，使用附带的 scripts/crawlora.sh 脚本；该脚本会在 x-api-key 标头中向 Crawlora API 发送密钥。
阅读 reference/endpoints.md，了解确切的端点方法和参数。检查 HTTP 状态以及应用程序 code；响应负载位于 data 中。
从范围有限的查询开始，并使用返回的视频 ID 获取元数据和查找字幕：
export CRAWLORA_API_KEY="your-crawlora-api-key"
scripts/crawlora.sh /youtube/search q="home energy efficiency" type=video upload_date=this_year sort_by=relevance

Substitute an actual returned video ID:

scripts/crawlora.sh "/youtube/transcript/VIDEO_ID/languages"
scripts/crawlora.sh "/youtube/transcript/VIDEO_ID" format=json
设定额度预算，并根据请求范围限制调用次数和页面数。遇到身份验证错误时停止；HTTP 429 时退避；上游暂时性故障时重试一次。字幕 404 表示当前无法获取字幕；应将暂时性上游错误另行处理。
YouTube 内容差距分析 数据架构与分类体系
围绕研究范围、抽样来源、编码标准和派生覆盖矩阵组织发现结果。
Record Recommended fields
Scope and search Topics and synonyms, audience, language, market, date window, formats, channels, query, filters, ordering, sampled pages, continuation tokens, stopping reason, and credit or page bounds
Video source Actual video ID, canonical URL, creator/channel ID and URL, source date, observation/crawl time, duration, supplied views or engagement, and coverage basis
Channel source Channel ID and canonical URL, archive/sample scope, sampled dates, and observed videos; keep channel identity distinct from handles, names, and playlists
Transcript evidence Caption availability, discovered and requested language, original/generated/translated status, format, timestamps, and evidence used for coding
Topic coding Shared topic/subtopic, format, depth, intended use, multi-label assignments, uncertainty, and concise timestamped evidence where captions support it
Coverage output Topic-by-format or channel counts, unique-video denominator, dates, collection scope, and unavailable-content counts
对于未知或经过取整的公开指标，应保留为未知；不要推断历史观看曲线。在不同搜索中对同一视频去重；除非有旁证，否则将跨频道转载视为不同的来源观察。搜索热度只是发现入口，并非完整清单。不要复现完整字幕。

高级特性

将 Shorts、长视频、直播和播放列表视为不同的研究单位，并记录筛选条件和抽样决定。
保留来源 ID、规范 URL、来源日期、观察时间、查询设置和停止原因，以便可重复地报告研究范围。
支持查找字幕语言，并区分原始、自动生成和翻译字幕，包括时间戳上下文。
使用统一的多标签主题与深度标准，明确标示不确定状态，并将编码与证据关联。
报告唯一视频分母和不可用内容数量，清楚呈现每项观察到的差距的局限性。
将观察到的样本差距转化为按优先级排序的假设，同时避免对需求、人口特征、收入、转化、留存或未来表现作出缺乏依据的断言。
负责任地处理 API：除 HTTP 状态外还检查应用程序代码；遇到身份验证错误时停止；收到 429 响应时退避；上游暂时性故障时重试一次。
不上传内容、不评论、不联系创作者、不下载受限媒体，也不创建持续监控。

name: youtube-content-gap-analysis description: Map observed YouTube topic and format coverage using Crawlora searches, channel samples, videos, and available captions. Use for an evidence-based content brief or sampled topic-gap map with search selection, language, transcript basis, identity, and demand limits preserved.

YouTube content gap analysis

Access and scope

Set CRAWLORA_API_KEY to your Crawlora key. Prefer the listed Crawlora MCP tools when connected; otherwise use the bundled scripts/crawlora.sh, which sends x-api-key to https://api.crawlora.net/api/v1. Read reference/endpoints.md for exact methods and parameters. Check application code as well as HTTP status; payloads are inside data. Stop on authentication errors, back off on 429, and retry a transient upstream failure once. Bound calls/pages by the requested scope and credit budget. Retain source IDs, URLs, source dates, and observation/crawl times separately.

Build a content-planning map for specified topics, audience needs, languages, markets, formats and channels. Define query synonyms, date window and balanced video/channel budgets. Search popularity is a discovery surface, not a complete inventory of every video or a measurement of unmet audience demand.

Collect a defensible video cohort

Use documented YouTube query/type/upload-date/duration/locale filters and returned continuation tokens. Shorts, long-form videos, livestreams and playlists are different units; keep the requested formats separate. Save every query, ordering, filter, sampled page and stopping reason.
Resolve actual video/channel IDs and canonical URLs. Channel names, handles, playlists and videos are different namespaces. Deduplicate the same video across searches; cross-channel reuploads need corroboration and remain distinct source observations rather than automatically independent content.
Inspect selected video metadata and channel archives. Record dates, duration, supplied views/engagement, creator, and coverage basis. Missing/rounded public fields stay unknown; no historical view curve is promised by this surface.
Discover transcript languages before requesting captions. Retain generated, original/translated language and timestamp context. Use JSON format for the normal envelope; text, srt, vtt return raw text. A transcript 404 means captions currently unavailable; a transient upstream error is different. Without captions/content evidence, label topic coding as title/description-only.
scripts/crawlora.sh /youtube/search q="home energy efficiency" type=video upload_date=this_year sort_by=relevance

# Use actual returned video IDs before metadata and caption discovery:
# scripts/crawlora.sh "/youtube/transcript/$VIDEO_ID/languages"
# scripts/crawlora.sh "/youtube/transcript/$VIDEO_ID" format=json

Identify sample gaps and testable content hypotheses

Create a shared topic/subtopic, format, depth and intended-use rubric. Allow multi-label and uncertain states; cite short timestamped evidence only when the actual caption supports it. Automatic captions/translation can misrecognize speech and do not independently verify a claim. Do not reproduce full transcripts.

Return a topic-by-format/channel matrix with unique-video denominators, dates, collection scope and unavailable-content counts, then a prioritized idea brief linked to actual sample gaps. Low observed coverage does not prove a topic is absent, underserved or commercially attractive. High views or comments do not prove audience demographics, conversion, revenue, retention or replicable future performance. A causal/title/thumbnail recommendation needs further testing; label it a hypothesis rather than a guaranteed growth tactic. Do not upload, comment, message creators, download restricted media, or create ongoing monitors.

加密货币动量信号
二手车价格历史分析