Bilibili Search Download Agent Skill

B站搜索批量下载

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

简介

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

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

功能特性

核心能力

| 功能 | 说明 |

|------|------|

| 关键词搜索 | 输入任意关键词，全站搜索 B站视频作品，支持翻页查看更多结果 |

| 多维排序 | 默认按综合排序排列，同时支持最新发布、最多点赞，可按最近7天/30天/90天/不限筛选发布时间 |

| 灵活翻页 | 搜索结果分页展示，支持前后翻页，每页最多50条结果 |

| 一键批量下载 | 搜索后自动批量获取全部结果的高清下载链接与封面图，一次搜索即完成采集 |

| 高清资源 | 自动解析视频最高可用画质，同时返回视频、音频、封面等多种资源类型 |

| 积分保护 | 搜索前主动提示积分消耗预估，用户确认后执行；下载直接执行，无需二次确认 |

特色亮点

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

一键安装

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

前置条件

• 已安装 Python 3.6+

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站视频链接并要求下载

常用命令速查

| 意图 | 示例话术 | 效果 |

|------|---------|------|

| 搜索视频 | 「搜索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 | 视频标题 | UP主名 | 447.9w | 18.5w | 8301 | 32.7w | 07月31 | 封面图 / 视频下载 |

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

> ⚠️ 搜索前积分确认：执行搜索前，必须先提示用户：

> 「⚠️技能中包含视频下载功能，每条视频作品下载约消耗0.6积分，单次查询10条数据，约消耗10×0.6约6积分。是否执行？

> 回复"是"将会立即查询相关数据」

> 待用户确认后才执行搜索。搜索完成后自动调用下载接口获取全部结果的下载链接。

下载结果输出

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

封面图 / 视频下载

> 详细执行流程、输出格式模板、错误处理请参见 核心工作流；接口字段与调用细节参见 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） |

核心模块

| 模块 | 职责 |

|------|------|

| 搜索脚本 | 接收关键词 → 调用搜索服务 → 输出结构化结果 |

| 下载脚本 | 接收视频链接 → 调用解析服务 → 返回下载地址与资源列表 |

获取帮助

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