B站热门、搜索与选题资料检索
检索B站热门、排行榜、关键词视频和UP主作品，保留链接与公开数据，作为选题研究的原始资料。
适用场景
准备做B站内容，想查看某个主题已有的视频、最近热门作品或同类UP主在讲什么时可以用。它提供实际检索工具，让Agent先获取作品与来源，再整理选题线索。也可以为抖音、视频号的同类内容研究提供参考，但数据来自B站，不会读取抖音或视频号。
主要功能
从热门和排行榜找参考作品
查询B站热门及三天、七天排行，按数量和页码控制结果。可以查看标题、作者与公开指标，筛选与你的领域有关的作品；这些数据反映接口返回的榜单，不代表该主题必然适合你的账号。
按关键词寻找已有内容
搜索视频或用户，查看某个问题已经被怎样讲过。搜索默认找用户，研究选题时要明确使用video类型，并记录关键词、页码和时间。少量结果只是样本，不能当作全站覆盖或准确搜索量。
对照UP主近期作品
查看账号信息和近期视频，再读取具体作品的资料、相关视频或可用评论，了解内容方向与观众关注点。后台完播率、转化和精确涨粉不在这些公开资料中，不能从点赞数补推成确定结论。
用原字幕核对视频说了什么
需要深入阅读时优先获取字幕和时间轴；字幕不可用时，可以另看平台摘要、评论或选择音频提取。音频功能要额外安装依赖，也不会自己把声音转成文字。资料不足时回看视频，不把平台AI摘要当逐字原话。
准备资料
提供关注的领域、关键词或UP主名称/B站UID，说明需要多少条参考作品、研究什么问题。第一次先做少量公开查询，确认结果可用后再决定是否继续。只有需要字幕等登录能力时才在自己的设备上处理登录，不把Cookie或账号凭据发到对话中。
使用方法
先安装CLI和Agent说明
按固定源码获取项目，在Python3.10或更新环境安装bili命令，再让当前Agent发现根目录SKILL.md。二者是不同步骤；仅添加Skill说明不表示CLI已经可运行。
用少量公开查询收集资料
先查热门、排行、关键词视频或UP主作品，保留BV号、链接和公开数据。明确搜索类型与数量，遇到接口错误停止并说明，不补造作品或指标。
核对原文再整理选题线索
选少数相关作品进一步阅读，区分作品内容、观众反馈和你的分析。输出可追溯的参考清单，再使用已有选题策划Skill形成具体题目。
交付内容
得到可供Agent分析的作品、账号或搜索结果，通常以YAML或JSON输出。可以在此基础上整理参考作品和选题线索；工具本身不保证生成完整选题方案，也不会证明需求或创作效果已经验证。
- 热门或关键词作品清单
- BV号、来源链接与公开指标
- 可用字幕及进一步研究资料
使用条件与费用
- 项目需要Python3.10+，上游提供uv tool install bilibili-cli或pipx install bilibili-cli，再通过Skills CLI或完整仓库添加Agent说明。本站固定源码提交；安装时应使用该提交的本地项目，先核对bili命令和版本，不默认升级到未核验版本。
- 多数公开查询无需登录；字幕、收藏、关注列表、历史和动态等能力需要认证。认证逻辑会使用本地保存凭据，部分登录流程还会查找浏览器Cookie，凭据保存在设备上的.bilibili-cli目录。本站说明和任务默认限制为公开读取。
- 项目采用Apache-2.0；音频提取另需PyAV可选依赖。平台接口可能触发412或限流，模型分析费用取决于自己的Agent。本次收录未安装登录、抓取真实账号或新增付费调用。
安装细节
安装和使用命令已经备好，按右侧步骤操作即可。需要查看技术配置时，可参考作者说明。
- CLI工具和Agent Skill说明需要分别安装。上游CLI需要Python3.10+及项目依赖，支持uv或pipx；Skill支持Skills CLI或完整仓库安装。本站固定项目源码提交，安装应从同提交本地项目处理，不默认升级到未核验版本；ClawHub入口已被上游弃用。
使用提醒
- 它是B站非官方客户端，不是平台官方接口保证。平台和依赖变化可能导致检索或认证失败；公开指标不能替代创作者后台数据。
- 工具还具备点赞、投币、三连、取消关注和动态发布/删除能力，本条使用示例不执行这些动作。以后需要写操作应明确提出具体任务，不能将研究授权扩展为账号运营。
- 同提交CI的Ruff、Mypy及Python3.10/3.12测试成功，但pytest默认排除了真实API smoke测试。本站仅源码/语法审读，没有执行真实检索、扫码登录、音频下载或内容成稿。
作者与来源
已核对作者文档，未进行运行测试。
查看关键事实的原文依据
Search：详见中文功能与使用说明。
### Search ```bash # Search users (default) bili search "关键词" # Search videos bili search "关键词" --type video # Pagination and limit bili search "关键词" --type video --max 5 bili search "关键词" --page 2 ``` ### Discovery ```bash bili hot # Trending/popular videos bili hot --page 2 --max 10 # Page 2, limit 10 bili rank # Site-wide ranking (3-day) bili rank --day 7 --max 30 # 7-day ranking, top 30 bili feed # Dynamic timeline (requires login) bili feed --offset 1234567890 # Next page via returned cursor bili my-dynamics来源文档：skill
Discovery：详见中文功能与使用说明。
### Discovery ```bash bili hot # Trending/popular videos bili hot --page 2 --max 10 # Page 2, limit 10 bili rank # Site-wide ranking (3-day) bili rank --day 7 --max 30 # 7-day ranking, top 30 bili feed # Dynamic timeline (requires login) bili feed --offset 1234567890 # Next page via returned cursor bili my-dynamics # My posted dynamics (requires login) bili dynamic-post "hello" # Publish text dynamic (requires write credential) bili dynamic-delete 123456789 # Delete one dynamic (requires write credent来源文档：skill
Workflow: Video Content Analysis：详见中文功能与使用说明。
### Workflow: Video Content Analysis ```bash # 1. Search for a topic bili search "AI" --type video --max 5 # 2. Get subtitles first for summarization bili video BV1xxx --subtitle # 3. If subtitles are missing or incomplete, try AI summary bili video BV1xxx --ai # 4. If there is still not enough content, extract audio for ASR bili audio BV1xxx --segment 25 # 5. Get comments for audience reaction bili video BV1xxx --comments ``` ### Workflow: UP主 Research ```bash # 1. Look up UP主 profile bili user "影视飓风" # 2. Get their recent videos bili user-videos 946974 --max 10 # 3. Inspect a specif来源文档：skill
来源仓库采用 Apache-2.0 许可；另有说明的第三方素材按各自许可。
Apache License Version 2.0, January 2004 http://www.apache.org/licenses/ TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION 1. Definitions. "License" shall mean the terms and conditions for use, reproduction, and distribution as defined by Sections 1 through 9 of this document. "Licensor" shall mean the copyright owner or entity authorized by the copyright owner that i来源文档：file6
CLI工具和Agent Skill说明需要分别安装。上游CLI需要Python3.10+及项目依赖，支持uv或pipx；Skill支持Skills CLI或完整仓库安装。本站固定项目源码提交，安装应从同提交本地项目处理，不默认升级到未核验版本；ClawHub入口已被上游弃用。
bilibili-cli ships with a [`SKILL.md`](./SKILL.md) that teaches AI agents how to use it.来源文档：file7
内容有误？告诉我们
01 安装到 Agent
复制安装命令，发给你正在使用的 Agent。
查看完整安装命令
发送后，等待 Agent 回复安装结果。
首次使用请先安装；已安装可直接填写下方任务。
02 填写你的任务
复制后，粘贴到已安装 Skill 的 Agent 对话。
