| name | youtube-game-keywords |
| description | YouTube 订阅频道游戏关键词提取工具。自动抓取订阅频道视频，识别游戏关键词，
归类为 Roblox / 独立游戏 / 主机PC 等赛道，生成结构化日报。
触发词：YouTube 游戏关键词日报 / YouTube 订阅源 / 游戏热度 / YouTube game keywords。
|
YouTube Game Keywords Skill
从 YouTube 订阅频道抓取游戏相关内容，识别游戏关键词并生成结构化日报。
🚀 快速开始
前置要求
| 依赖 | 说明 |
|---|
| OpenClaw | 本 skill 运行于 OpenClaw 环境（https://openclaw.ai） |
| 飞书 Bot | 需要已配置好的飞书 Bot 和 feishu_doc / message 工具权限 |
| Browser 工具 + YouTube 登录态 | 用于抓取订阅页（⚠️ 必须已登录 YouTube，见下方说明） |
| OpenClaw Browser 配置 | 详见"Browser 配置说明"章节 |
飞书 Bot 所需权限
| 权限名称 | 权限标识 | 用途 |
|---|
| 云文档 | docx:document | 创建飞书云文档写入日报 |
| 发消息 | im:message:send_as_bot | 向用户发送飞书消息 |
| 读取消息 | im:message | 消息交互（可选） |
💡 权限开通路径：飞书开放平台 → 应用 → 权限管理 → 搜索权限名称 → 开通
环境变量
| 变量 | 说明 | 必需 |
|---|
FEISHU_TARGET_USER | 飞书通知目标用户的 open_id | 可选（默认发给当前对话用户） |
⏰ 定时任务配置
本 skill 支持设置为每天自动执行。在 OpenClaw 中创建以下 cron job 即可：
创建命令：
openclaw cron add \
--name "YouTube Game Keywords 日报" \
--schedule "0 10 * * *" \
--tz "Asia/Shanghai" \
--payload-kind agentTurn \
--payload-message "使用 youtube-game-keywords skill，执行 YouTube 订阅频道游戏关键词日报任务。按照 skill 完整流程执行：1. 先尝试运行官方脚本（超时则降级用 browser 抓 YouTube 订阅页）2. 整理游戏关键词日报 3. 发送飞书消息到飞书用户 4. 创建飞书云文档并写入完整报告 5. 在飞书消息里附上文档链接" \
--payload-timeout 900 \
--delivery-mode announce \
--delivery-channel feishu
完整 Cron Job JSON（手动创建时使用）：
{
"name": "YouTube Game Keywords 日报",
"schedule": { "kind": "cron", "expr": "0 10 * * *", "tz": "Asia/Shanghai" },
"sessionTarget": "isolated",
"payload": {
"kind": "agentTurn",
"message": "使用 youtube-game-keywords skill，执行 YouTube 订阅频道游戏关键词日报任务。按照 skill 完整流程执行：1. 先尝试运行官方脚本（超时则降级用 browser 抓 YouTube 订阅页）2. 整理游戏关键词日报 3. 发送飞书消息到飞书用户 4. 创建飞书云文档并写入完整报告 5. 在飞书消息里附上文档链接",
"timeoutSeconds": 900
},
"delivery": {
"mode": "announce",
"channel": "feishu",
"to": "user:YOUR_OPEN_ID"
参数说明：
| 参数 | 值 | 说明 |
|---|
schedule.expr | 0 10 * * * | 每天 10:00 执行，可改为其他时间 |
delivery.to | user:ou_xxxx | 替换为接收通知的飞书用户 open_id |
timeoutSeconds | 900 | 15 分钟超时，覆盖 browser 抓取耗时 |
sessionTarget | isolated | 在独立 session 中运行，不影响主对话 |
🔐 Browser 配置说明（必须先完成）
为什么需要登录态？
YouTube 订阅页 /feed/subscriptions 未登录用户无法访问。不登录只看到"推荐订阅"内容，不是你的真实订阅列表。
OpenClaw 的 browser 和你的本地浏览器共享同一个浏览器 profile，所以：
- 你在 Chrome/Safari/Edge 里登录了 YouTube
- OpenClaw browser 打开订阅页就自动带着你的登录态
配置步骤
方法一：使用已有的 Chrome profile（推荐）
openclaw browser start --profile ~/Library/Application\ Support/Google/Chrome/Default
方法二：启动独立的 Chrome profile 供 OpenClaw 专用
mkdir -p ~/openclaw-browser-profile
openclaw browser start --profile ~/openclaw-browser-profile
验证配置是否成功
在 OpenClaw 里执行：
browser(action=open, url="https://www.youtube.com/feed/subscriptions")
browser(action=snapshot)
⚠️ 常见问题
| 问题 | 原因 | 解决 |
|---|
| 页面显示"登录 YouTube" | Browser 没有 YouTube 登录态 | 手动在 OpenClaw browser 里登录 YouTube |
| 能打开但视频列表为空 | 订阅列表为空或页面没加载完 | 页面需多次滚动触发懒加载 |
| 报错 "not logged in" | fetch_subscriptions.sh 检测到未登录 | 先在 browser 登录 YouTube |
| Cron 任务抓不到数据 | 定时任务 browser session 和手动不同 | 需确保 browser profile 持久化 |
📁 技能文件说明
youtube-game-keywords/
├── SKILL.md # Skill 标准格式（本文件）
├── README.md # 使用说明（含 Python 脚本模式）
└── scripts/
├── fetch_subscriptions.sh # OpenClaw Agent 抓取脚本
└── analyze_keywords.py # 纯 Python 关键词分析（无需 API key）
📋 执行流程
Step 1：Browser 抓取 YouTube 订阅页
⚠️ 重要：执行此步前必须确认 OpenClaw browser 已登录 YouTube（见上方配置说明）。
browser(action=open, url="https://www.youtube.com/feed/subscriptions")
等页面加载完成后（建议等待 3-5 秒）：
browser(action=snapshot, refs="aria")
必须多次滚动加载（因为是无限滚动列表）：
browser(action=act, kind="press", key="End", times=5)
解析页面中的视频列表，提取：
title：视频标题channel_name：频道名view_text：播放量（如 "123K views"）published_text：发布时间（如 "2 days ago"）url：视频链接
Step 2：识别游戏关键词
使用 scripts/analyze_keywords.py（纯规则，无需 API key）：
python3 scripts/analyze_keywords.py data/videos.json --output data/report.txt
或直接用 Agent 做 LLM 分类。
游戏分类：
| 分类 | 说明 |
|---|
| Roblox | Roblox 相关内容 |
| 独立游戏 | Deckbuilder / Roguelike / Horror / Adventure 等 |
| 主机/PC 大作 | 3A/主流游戏 |
| 直播 | Twitch/直播相关 |
| 其他 | 不属于以上类别 |
Step 3：整理日报格式
📺 YouTube 订阅频道日报 — YYYY-MM-DD
【今日概要】一句话总结今日最显著的 trend
【Roblox 赛道】
- [游戏名] — [频道] — [播放量] — [一句话描述]
【独立游戏赛道】
- [游戏名] — [频道] — [播放量] — [一句话描述]
【主机/PC 赛道】
- [游戏名] — [频道] — [播放量] — [一句话描述]
【值得关注的独立游戏】（播放量 >50K 的非 Roblox 游戏）
| 游戏 | 频道 | 播放 | 类型 | 亮点 |
【算法流量猎奇发现】（高播放量但非主流内容）
| 游戏 | 频道 | 播放 | 猎奇点 |
Step 4：发送飞书消息
message(action=send, channel="feishu", target="user:$FEISHU_TARGET_USER", message=日报全文)
Step 5：创建飞书云文档
feishu_doc(action=create, title="YouTube 订阅频道日报 YYYY-MM-DD", owner_open_id="$FEISHU_TARGET_USER")
feishu_doc(action=write, doc_token=<创建的文档token>, content=完整报告内容)
Step 6：在飞书消息里附上文档链接
🔧 Python 脚本模式（纯命令行，无需 Agent）
chmod +x scripts/fetch_subscriptions.sh
./scripts/fetch_subscriptions.sh ./data/videos.json
python3 scripts/analyze_keywords.py ./data/videos.json --output ./data/report.txt
cat ./data/report.txt
⚠️ 独立运行同样需要在运行前确保 openclaw CLI 已登录 YouTube（在 browser 里登录一次即可）。
⚠️ 注意事项
- YouTube 登录态是必须项：Browser 未登录则完全无法抓取订阅页，这是 YouTube 的限制，无法绕过
- 播放量 >100K 的内容优先呈现
- 无游戏内容时：注明"今日订阅频道无游戏相关更新"
- open_id 获取：飞书用户 open_id 可在 Bot 收到消息时从事件 payload 中获取
- 本 skill 不包含任何 API Key，所有外部依赖通过环境变量或本地脚本接入
- Browser profile 必须持久化：定时任务场景下确保 browser profile 不会每次清空，导致重新需要登录
