B站搜索批量下载

输入关键词搜遍 B站全站视频，搜索即自动批量获取高清下载链接，让视频采集不再繁琐

简介

B站搜索批量下载 是一款专为内容创作者、品牌运营、市场调研人员设计的 B站视频采集工具。只需输入一个关键词，即可快速搜索 B站全站视频作品，灵活按播放量、点赞数、发布时间等维度排序筛选，搜索完成后自动批量获取全部高清下载链接，告别逐个打开网页手动下载的低效操作。

• 核心价值：将「搜索 → 筛选 → 下载」三步合一，一次对话完成从发现到采集的全流程，大幅提升视频素材收集效率
• 适用对象：内容创作者、社媒运营、市场策划、MCN机构、视频剪辑师、竞品分析人员
• 技术基础：基于红狐数据平台的 B站作品搜索与视频解析能力

功能特性

核心能力

特色亮点

• 一句话操作：说"搜索B站关于XX的视频"即可获取结果，无需记忆复杂命令
• 搜索下载一体：搜索后自动解析全部视频下载链接与封面图，无需手动逐个获取
• 零缓存设计：结果仅在对话中展示，不落盘缓存，数据安全可控
• 多资源解析：同一视频可同时获取视频流、音频流、封面图，满足不同使用场景

一键安装

本技能为标准 Skill 文件包，兼容所有支持 Skill 机制的 AI Agent 平台。

前置条件

• 已安装 Python 3.6+

Qoder 平台

1. 将技能文件夹放入 Qoder 的 Skills 目录
2. 重启 Qoder 或刷新技能列表
3. 配置数据服务接入凭证（详见下方使用指南 - 鉴权配置）

OpenClaw 平台

1. 将技能文件夹导入 OpenClaw 技能库
2. 在设置中启用该技能
3. 配置数据服务接入凭证

WorkBuddy 平台

1. 将技能文件夹添加到 WorkBuddy 的 skills 路径
2. 重新加载技能配置
3. 配置数据服务接入凭证

Codex 平台

1. 将技能文件夹放入 Codex 的 skills 目录
2. 重启 Codex 加载新技能
3. 配置数据服务接入凭证

Claude Code 平台

1. 将技能文件夹添加到 Claude Code 的 skills 配置路径
2. 重启 Claude Code 会话
3. 配置数据服务接入凭证

使用指南

鉴权配置

使用本技能前需要配置红狐 API 密钥 REDFOXAPIKEY：

1. 访问 红狐Hub 官网 了解服务详情
2. 前往 注册页面 注册账号（新用户获赠免费积分）
3. 登录后在 API 密钥管理页面创建密钥，格式为 ak_xxxxxxxx
4. 将密钥设置为环境变量 REDFOXAPIKEY

环境变量设置方式：

• macOS/Linux：在终端执行 export REDFOXAPIKEY=ak_xxxx，或追加到 ~/.zshrc / ~/.bashrc 后 source
• Windows：在 PowerShell 执行 [Environment]::SetEnvironmentVariable("REDFOXAPIKEY", "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积分。是否执行？
回复"是"将会立即查询相关数据」
待用户确认后才执行搜索。搜索完成后自动调用下载接口获取全部结果的下载链接。

下载结果输出

下载结果直接整合在搜索数据表格的「下载链接」列中，格式为：

[封面图]({coverurl}) / [视频下载]({downloadurl})

详细执行流程、输出格式模板、错误处理请参见 [核心工作流](references/coreworkflow.md)；接口字段与调用细节参见 [API接口指南](references/apiguide.md)

使用场景

场景一：素材快速采集

需求：视频创作者需要快速搜集某个主题的 B站视频素材

使用方式：

1. 输入主题关键词搜索相关视频
2. 按播放量排序找到最热门的内容
3. 自动获取全部视频的下载链接和封面图

预期收益：素材收集时间从小时级缩短到分钟级，一个对话完成全流程

场景二：竞品内容监控

需求：品牌运营需要持续跟踪竞品在 B站的内容发布情况

使用方式：

1. 定期搜索竞品品牌关键词
2. 按发布时间排序查看最新视频
3. 下载竞品营销视频进行分析

预期收益：及时掌握竞品内容策略，为自身内容规划提供参考

场景三：热门趋势调研

需求：市场人员想了解某个话题在 B站的热度和内容方向

使用方式：

1. 搜索行业热点关键词
2. 按播放量或点赞数排序
3. 下载头部视频研究其内容结构和表达方式

预期收益：快速把握平台内容风向，为选题策划提供数据支撑

场景四：视频二次创作

需求：剪辑师需要下载 B站视频作为二创素材

使用方式：

1. 搜索目标视频
2. 直接获取视频下载链接和封面图
3. 导入剪辑软件进行二次创作

预期收益：省去手动录屏或使用第三方工具的时间，直接获取高清源文件

常见问答

安装相关

Q1: 提示"未找到 REDFOXAPIKEY"怎么办？

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执行参考）

技术栈

核心模块

获取帮助

• 红狐Hub 官网：https://redfox.hk?source=github
• 企业服务（全量数据库）：https://redfox.hk/dashboard/enterprise?source=github
• 技能实现细节：参见 [核心工作流](references/coreworkflow.md) 与 [API接口指南](references/apiguide.md)