bilibili-search-download git:20260817.17b8940A

Immutable. This exact content is served forever at /api/v1/blob/688878bf1d3129d5.

---
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 平台。

### 前置条件
- 已安装 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 密钥 `REDFOX_API_KEY`：

1. 访问 [红狐Hub 官网](https://redfox.hk?source=github) 了解服务详情
2. 前往 [注册页面](https://redfox.hk/login?source=github) 注册账号（新用户获赠免费积分）
3. 登录后在 API 密钥管理页面创建密钥，格式为 `ak_xxxxxxxx`
4. 将密钥设置为环境变量 `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站视频链接并要求下载

### 常用命令速查

| 意图 | 示例话术 | 效果 |
|------|---------|------|
| 搜索视频 | 「搜索B站羽绒服评测视频」 | 搜索前提示积分消耗，确认后按关键词搜索并自动获取下载链接 |
| 排序搜索 | 「按最新发布排序搜索B站手机评测」 | 搜索并按指定维度排序，可限定时间范围 |
| 翻页 | 「下一页」 | 获取下一页搜索结果（消耗一次积分） |
| 直接下载 | 「下载 https://www.bilibili.com/video/BVxxx/」 | 通过链接直接获取下载地址 |

### 使用示例

**示例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} 页
- 提示语：「以下是详细数据：」

**数据表格**：

| # | 视频标题 | UP主 | 播放量 | 点赞数 | 评论数 | 收藏数 | 发布时间 | 下载链接 |
|---|----------|------|--------|--------|--------|--------|----------|----------|
| 1 | [视频标题](https://www.bilibili.com/video/BVxxxxxx/) | [UP主名](https://space.bilibili.com/作者ID) | 447.9w | 18.5w | 8301 | 32.7w | 07月31 | [封面图](cover_url) / [视频下载](download_url) |

- 视频标题为可点击链接，跳转至B站视频详情页
- UP主名称为可点击链接，跳转至B站UP主个人空间
- 视频标题和UP主字段中的特殊字符需替换为空字符串
- 播放量/点赞数/收藏数 >= 10000 使用 `x.xw` 格式
- 下载链接列包含封面图链接和视频下载链接，搜索完成后自动获取
- 展示后主动询问：「回复「下一页」查看更多视频。查询约消耗6积分左右，确认积分是否足够。」

> ⚠️ **搜索前积分确认**：执行搜索前，必须先提示用户：
> 「⚠️技能中包含视频下载功能，每条视频作品下载约消耗0.6积分，单次查询10条数据，约消耗10×0.6约6积分。是否执行？
> 回复"是"将会立即查询相关数据」
> 待用户确认后才执行搜索。搜索完成后自动调用下载接口获取全部结果的下载链接。

#### 下载结果输出

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

`[封面图]({cover_url}) / [视频下载]({download_url})`

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

---

## 使用场景

### 场景一：素材快速采集
**需求**：视频创作者需要快速搜集某个主题的 B站视频素材

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

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

---

### 场景二：竞品内容监控
**需求**：品牌运营需要持续跟踪竞品在 B站的内容发布情况

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

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

---

### 场景三：热门趋势调研
**需求**：市场人员想了解某个话题在 B站的热度和内容方向

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

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

---

### 场景四：视频二次创作
**需求**：剪辑师需要下载 B站视频作为二创素材

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

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

---

## 常见问答

### 安装相关

**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](https://redfox.hk?source=github) 查看积分余额或充值。

---

## 项目架构

### 目录结构

```
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） |

### 核心模块

| 模块 | 职责 |
|------|------|
| 搜索脚本 | 接收关键词 → 调用搜索服务 → 输出结构化结果 |
| 下载脚本 | 接收视频链接 → 调用解析服务 → 返回下载地址与资源列表 |

---

### 获取帮助

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