| name | bilibili-search-download |
| description | B站搜索批量下载工具。输入关键词即可搜索B站全站视频，支持按播放量/点赞/时间排序，搜索后自动批量获取全部高清下载链接。当用户需要查找B站视频、搜索B站内容、下载B站视频、采集B站素材时使用。触发词：B站搜索、bilibili搜索、B站下载、B站视频下载、b站搜视频、B站找素材、下载B站、bilibili下载。 |
B站搜索批量下载
输入关键词搜遍 B站全站视频，搜索即自动批量获取高清下载链接，让视频采集不再繁琐
简介
B站搜索批量下载 是一款专为内容创作者、品牌运营、市场调研人员设计的 B站视频采集工具。只需输入一个关键词，即可快速搜索 B站全站视频作品，灵活按播放量、点赞数、发布时间等维度排序筛选，搜索完成后自动批量获取全部高清下载链接，告别逐个打开网页手动下载的低效操作。
- 核心价值：将「搜索 → 筛选 → 下载」三步合一，一次对话完成从发现到采集的全流程，大幅提升视频素材收集效率
- 适用对象：内容创作者、社媒运营、市场策划、MCN机构、视频剪辑师、竞品分析人员
- 技术基础：基于红狐数据平台的 B站作品搜索与视频解析能力
功能特性
核心能力
| 功能 | 说明 |
|---|
| 关键词搜索 | 输入任意关键词，全站搜索 B站视频作品，支持翻页查看更多结果 |
| 多维排序 | 默认按综合排序排列，同时支持最新发布、最多点赞，可按最近7天/30天/90天/不限筛选发布时间 |
| 灵活翻页 | 搜索结果分页展示，支持前后翻页，每页最多50条结果 |
| 一键批量下载 | 搜索后自动批量获取全部结果的高清下载链接与封面图，一次搜索即完成采集 |
| 高清资源 | 自动解析视频最高可用画质，同时返回视频、音频、封面等多种资源类型 |
| 积分保护 | 搜索前主动提示积分消耗预估，用户确认后执行；下载直接执行，无需二次确认 |
特色亮点
- 一句话操作：说"搜索B站关于XX的视频"即可获取结果，无需记忆复杂命令
- 搜索下载一体：搜索后自动解析全部视频下载链接与封面图，无需手动逐个获取
- 零缓存设计：结果仅在对话中展示，不落盘缓存，数据安全可控
- 多资源解析：同一视频可同时获取视频流、音频流、封面图，满足不同使用场景
一键安装
本技能为标准 Skill 文件包，兼容所有支持 Skill 机制的 AI Agent 平台。
前置条件
Qoder 平台
- 将技能文件夹放入 Qoder 的 Skills 目录
- 重启 Qoder 或刷新技能列表
- 配置数据服务接入凭证（详见下方使用指南 - 鉴权配置）
OpenClaw 平台
- 将技能文件夹导入 OpenClaw 技能库
- 在设置中启用该技能
- 配置数据服务接入凭证
WorkBuddy 平台
- 将技能文件夹添加到 WorkBuddy 的 skills 路径
- 重新加载技能配置
- 配置数据服务接入凭证
Codex 平台
- 将技能文件夹放入 Codex 的 skills 目录
- 重启 Codex 加载新技能
- 配置数据服务接入凭证
Claude Code 平台
- 将技能文件夹添加到 Claude Code 的 skills 配置路径
- 重启 Claude Code 会话
- 配置数据服务接入凭证
使用指南
鉴权配置
使用本技能前需要配置红狐 API 密钥 REDFOX_API_KEY：
- 访问 红狐Hub 官网 了解服务详情
- 前往 注册页面 注册账号（新用户获赠免费积分）
- 登录后在 API 密钥管理页面创建密钥，格式为
ak_xxxxxxxx
- 将密钥设置为环境变量
REDFOX_API_KEY
环境变量设置方式：
- macOS/Linux：在终端执行
export REDFOX_API_KEY=ak_xxxx，或追加到 ~/.zshrc / ~/.bashrc 后 source
- Windows：在 PowerShell 执行
[Environment]::SetEnvironmentVariable("REDFOX_API_KEY", "ak_xxxx", "User")，重启终端生效
触发方式
当用户提到以下任意关键词时自动激活：
- "B站搜索"、"bilibili搜索"、"B站搜视频"、"搜B站"
- "B站下载"、"下载B站视频"、"B站视频下载"
- "B站找素材"、"B站采集"
- 直接发送 B站视频链接并要求下载
常用命令速查
使用示例
示例1：搜索并浏览
用户：搜索B站关于华为Mate 80的评测视频，按最多点赞排序
AI：⚠️技能中包含视频下载功能，每条视频作品下载约消耗0.6积分，单次查询10条数据，约消耗10×0.6约6积分。是否执行？
回复「是」将会立即查询相关数据
用户：是
AI：执行搜索 → 自动获取下载链接 → 展示含下载链接的完整表格
示例2：搜索特定排序
用户：搜索B站AI绘画教程，按最新发布排序
AI：⚠️技能中包含视频下载功能……是否执行？
用户：是
AI：执行搜索 → 自动获取下载链接 → 展示含下载链接的完整表格
示例3：直接下载
用户：下载这个视频 https://www.bilibili.com/video/BV1AmSSBMEqo/
AI：直接解析视频，返回标题、封面和下载链接
示例4：无搜索结果
用户：搜索B站 xyzabc123456
AI：暂无搜索结果，请尝试更换关键词或调整筛选条件
输出格式规范
搜索结果输出
搜索结果以 Markdown 表格形式展示，顶部信息栏 + 数据表格：
顶部查询信息栏：
- 关键词：「{keyword}」
- 查询结果总数：{total} 条视频
- 排序方式：默认按综合排序
- 发布时间：默认最近7天
- 当前页码：第 {page} 页
- 提示语：「以下是详细数据：」
数据表格：
- 视频标题为可点击链接，跳转至B站视频详情页
- UP主名称为可点击链接，跳转至B站UP主个人空间
- 视频标题和UP主字段中的特殊字符需替换为空字符串
- 播放量/点赞数/收藏数 >= 10000 使用
x.xw 格式
- 下载链接列包含封面图链接和视频下载链接，搜索完成后自动获取
- 展示后主动询问：「回复「下一页」查看更多视频。查询约消耗6积分左右，确认积分是否足够。」
⚠️ 搜索前积分确认：执行搜索前，必须先提示用户：
「⚠️技能中包含视频下载功能，每条视频作品下载约消耗0.6积分，单次查询10条数据，约消耗10×0.6约6积分。是否执行？
回复"是"将会立即查询相关数据」
待用户确认后才执行搜索。搜索完成后自动调用下载接口获取全部结果的下载链接。
下载结果输出
下载结果直接整合在搜索数据表格的「下载链接」列中，格式为：
[封面图]({cover_url}) / [视频下载]({download_url})
详细执行流程、输出格式模板、错误处理请参见 核心工作流；接口字段与调用细节参见 API接口指南
使用场景
场景一：素材快速采集
需求：视频创作者需要快速搜集某个主题的 B站视频素材
使用方式：
- 输入主题关键词搜索相关视频
- 按播放量排序找到最热门的内容
- 自动获取全部视频的下载链接和封面图
预期收益：素材收集时间从小时级缩短到分钟级，一个对话完成全流程
场景二：竞品内容监控
需求：品牌运营需要持续跟踪竞品在 B站的内容发布情况
使用方式：
- 定期搜索竞品品牌关键词
- 按发布时间排序查看最新视频
- 下载竞品营销视频进行分析
预期收益：及时掌握竞品内容策略，为自身内容规划提供参考
场景三：热门趋势调研
需求：市场人员想了解某个话题在 B站的热度和内容方向
使用方式：
- 搜索行业热点关键词
- 按播放量或点赞数排序
- 下载头部视频研究其内容结构和表达方式
预期收益：快速把握平台内容风向，为选题策划提供数据支撑
场景四：视频二次创作
需求：剪辑师需要下载 B站视频作为二创素材
使用方式：
- 搜索目标视频
- 直接获取视频下载链接和封面图
- 导入剪辑软件进行二次创作
预期收益：省去手动录屏或使用第三方工具的时间，直接获取高清源文件
常见问答
安装相关
Q1: 提示"未找到 REDFOX_API_KEY"怎么办？
A: 请参见上方使用指南中的鉴权配置说明设置环境变量。如果不会配置，直接告诉 Agent，它会帮你操作。
Q2: 需要安装什么依赖？
A: 不需要。脚本使用 Python 标准库 urllib，Python 3.6+ 环境即可直接运行。
使用相关
Q3: 一次搜索能返回多少条结果？
A: 每次搜索返回一页结果，默认每页10条，最大可设置50条。通过翻页可以查看更多结果（每页消耗一次积分）。
Q4: 下载的视频是什么画质？
A: 系统自动解析视频的最高可用画质，具体取决于视频本身支持的最高清晰度。
Q5: 下载链接有效期多久？
A: 下载链接具有时效性，建议获取后尽快下载。若链接过期，重新执行下载即可获取新链接。
Q6: 可以同时下载多个视频吗？
A: 搜索完成后自动获取全部搜索结果的下载链接，无需手动选择。每次搜索最多返回10条结果。
Q7: 支持哪些排序方式和时间筛选？
A: 支持三种排序：综合排序（按播放量）、最新发布、最多点赞。默认按播放量降序。时间范围：最近7天（默认）、最近30天、最近90天、不限。
故障排除
Q8: 搜索不到想要的视频？
A: 可能原因：关键词过于生僻；尝试更换更通用的关键词或调整排序方式后重试。
Q9: 下载失败怎么办？
A: 可能原因：视频链接有误；视频已被删除或设为私密；网络波动。请检查链接后重试。
Q10: 提示积分不足？
A: 每次搜索和下载均消耗一次积分。请前往 红狐Hub 查看积分余额或充值。
项目架构
目录结构
bilibili-search-download/
├── SKILL.md # 技能说明文档（本文件）
├── scripts/
│ ├── bilibili_search.py # 关键词搜索脚本
│ └── bilibili_download.py # 视频下载脚本
└── references/
├── api_guide.md # API 接口说明
└── core_workflow.md # 核心工作流（Agent执行参考）
技术栈
| 组件 | 技术 |
|---|
| 运行环境 | Python 3.6+（零依赖） |
| 数据源 | 红狐数据平台 |
| 输出格式 | Markdown（对话内） |
| 请求方式 | HTTP POST（JSON） |
核心模块
| 模块 | 职责 |
|---|
| 搜索脚本 | 接收关键词 → 调用搜索服务 → 输出结构化结果 |
| 下载脚本 | 接收视频链接 → 调用解析服务 → 返回下载地址与资源列表 |
获取帮助
