为什么用这个 skill
唯一为 AI agent 设计的 B 站评论工具：结构化 JSON 输出、自描述 schema、委托式认证、严格串行批量模式。
零依赖
纯 Python 3.9+ 标准库，不需要 pip install。Cookie 解密走系统自带的 security / openssl。
完整评论
顶级评论 + 楼中楼 + 置顶；视频元数据一起拉：播放、点赞、投币、收藏、标签、UP 主信息。
Agent 原生 CLI
stdout 稳定 JSON envelope、stderr NDJSON 进度、分类 exit code、dry-run 预览、schema 自描述。
串行批量模式
按 UID 拉 UP 主所有视频评论 —— 一个一个来，从不并行。视频之间 5-10s 随机休眠，断点续跑。
认证委托
人在浏览器登录，用开源插件 Get cookies.txt LOCALLY 导出 cookie 即可，agent 永远不碰 OAuth。
断点续传与增量
重跑同一 fetch 自动跳过已拉页。--since 只拉新评论，方便长期监控。
快速上手
三步从零到分析完成。
装 Chrome 插件「Get cookies.txt LOCALLY」
完全本地、开源、不上传任何数据。在已登录 bilibili.com 的标签页点 Export，保存 www.bilibili.com_cookies.txt。
安装 bbc-skill
根据你用的 agent 选路径（完整列表见下方）。
git clone https://github.com/Agents365-ai/bbc-skill.git ~/.claude/skills/bbc-skill
拉评论 → 交给 Claude 分析
验证 cookie → 拉取 → 让 Claude Code 读分析。
bbc cookie-check --cookie-file ~/Downloads/www.bilibili.com_cookies.txt bbc fetch BV1NjA7zjEAU --cookie-file ~/Downloads/www.bilibili.com_cookies.txt # 然后跟 Claude 说：「读 bilibili-comments/BV1NjA7zjEAU/summary.json， # 告诉我受众情绪和高频反馈主题」
多平台支持
同一份 SKILL.md + agents/openai.yaml sidecar，兼容 6 个平台。
| 平台 | 状态 | 安装路径 |
|---|---|---|
| Claude Code | ✓ 原生支持 | ~/.claude/skills/bbc-skill/ |
| OpenAI Codex | ✓ 原生支持 | ~/.agents/skills/bbc-skill/ |
| OpenClaw / ClawHub | ✓ 原生支持 | ~/.openclaw/skills/bbc-skill/ |
| Hermes Agent | ✓ 原生支持 | ~/.hermes/skills/data/bbc-skill/ |
| Opencode | ✓ 原生支持 | ~/.config/opencode/skills/bbc-skill/ |
| SkillsMP | ✓ 已索引 | skills install bbc-skill |
输出格式
JSONL 扁平评论 + 丰富的 summary.json，Claude 先读后者建立全局认知再按需采样前者。
bilibili-comments/BV1NjA7zjEAU/ ├── comments.jsonl # 每行一条评论，共 59 行 ├── summary.json # 视频元数据 + 统计 + Top-N（~13KB） ├── raw/ # 原始 API 响应归档 └── .bbc-state.json # 断点 & 增量状态 // summary.json 预览 { "video": { "title": "会魔法吗？3步搞定Claude Code…", "stat": { "view": 7287, "like": 97, "coin": 70, "reply": 59 } }, "counts": { "total": 59, "top_level": 44, "nested": 14, "pinned": 1, "completeness": 1.0, "unique_users": 46 }, "time_distribution": { "earliest_iso": "…", "by_day": [...] }, "top_liked": [...], "top_replied": [...], "ip_distribution": { "浙江": 5, "广东": 4, ... } }
⚠️ 合理使用声明
本工具仅限个人少量合法使用。不接受请不要跑。
✅ 可以
- 分析你自己的视频 —— 这是主要使用场景。
- 协助其他 UP 主，在对方明确授权下使用。
- 遵守内置节流：每请求 1s、批量模式视频间 5-10s 随机休眠。不要改源码去掉这些。
❌ 不可以
- 大规模爬取陌生 UP 主的视频评论或整个分区。
- 商业转卖或公开二次发布爬下来的数据。
- 绕过速率限制、伪造 UA、使用代理池规避 B 站风控。
- 高频自动化任务 —— 例如每天定时全量重扫同一 UP。
- 骚扰、人肉、定向引战 —— 用爬到的 UID / IP 属地做这种事。
机构 / 商业用途请走 B 站开放平台 官方 API。贯彻数据最小化原则：拉完 → 分析 → 删除。 本项目与 bilibili.com 无任何关联；使用本工具造成的账号风控、封禁、法律后果由使用者自行承担。