bilibili-keywords-search · git:20260623.8ce63c8 · 2026-06-23 · sha256 2a0dfcb0259afe91
bilibili-keywords-search git:20260623.8ce63c8A
Immutable. This exact content is served forever at /api/v1/blob/2a0dfcb0259afe91.
---
name: B站关键词实时搜索
description: B站关键词实时搜索工具。根据用户输入的关键词实时调用 Redfox 接口搜索B站最新视频，支持按排序方式和发布时间筛选，返回实时数据（非缓存/历史数据）。当用户明确要求「实时」「最新」「现在」「当前」搜索B站内容，或对已有数据时效性存疑时使用。触发词：B站实时搜索、B站最新视频、实时B站热门、当前B站数据、B站实时查询、bilibili搜索。
---
# B站关键词实时搜索
## 📝 简介
B站关键词实时搜索工具，根据关键词实时调用 Redfox 接口搜索B站最新视频，返回实时数据（非缓存/历史数据）。支持按排序方式和发布时间筛选。
## ✨ 功能特性
| 功能模块 | 能力描述 | 核心价值 |
| -------- | ------------------------------- | ------------------------ |
| 实时搜索 | 关键词实时搜索B站最新视频 | 获取非缓存的实时数据 |
| 多维排序 | 支持综合/最新/点赞三种排序 | 按不同维度发现优质内容 |
| 时间筛选 | 支持 7天/30天/90天/不限时间范围 | 灵活控制搜索时间窗口 |
| 智能拓展 | 无结果时自动生成 10 个扩展词 | 突破搜索瓶颈发现相关内容 |
| 分页浏览 | 支持多页结果浏览 | 逐步探索大量搜索结果 |
| 订阅推送 | 支持关键词每日推送 | 定时获取最新搜索结果 |
## 🔑 鉴权
### 获取 API Key
请前往 [红狐hub](https://redfox.hk/settings/api-keys?source=github) 获取 API KEY
### 配置 API Key
方案1: 以 OpenClaw 为例，将 REDFOX_API_KEY 添加到 `~/.openclaw/openclaw.json` 中：
```bash
{ "env": { "REDFOX_API_KEY": "ak_xxxx..." } }
```
方案2: 终端配置
```bash
export REDFOX_API_KEY="ak_xxxx..."
```
## 🔄 工作流程
### Step 1：理解用户意图，提取关键词和筛选参数
**⚠️ 核心规则：语义理解优先，优先提取细分方向词，而非泛化大类词**
**1. 提取关键词**
- 从用户描述中提取 2~6 字的细分关键词
- 若用户意图模糊（如"帮我搜B站"），主动询问：「请问你想搜索哪个方向或领域的内容？」
- 不得在用户未提供关键词时擅自猜测并调用脚本
**2. 识别筛选参数**（用户未指定时使用默认值）
- **排序方式**（`--sort`）：默认 `1`（综合排序）
- 用户提到"最新"、"最近发布" → `2`
- 用户提到"点赞"、"热门"、"爆款" → `3`
- 未提及排序 → `1`（默认）
- **发布时间**（`--time`）：默认 `7`（最近7天）
- 用户提到"近一个月"、"30天" → `30`
- 用户提到"近三个月"、"90天" → `90`
- 用户提到"不限时间"、"全部" → `0`
- 未提及时间 → `7`（默认）
- **页码**（`--page`）：默认 `1`
- 用户提到"下一页"、"第2页" → 对应页码
- 用户提到"上一页" → 当前页 - 1
- 未提及页码 → `1`（默认）
### Step 2：调用实时搜索脚本
**⚠️ 核心约束：每次查询严格只调用一次脚本，禁止重复调用。**
- 无论脚本返回成功还是失败，都不得重试或二次调用
- 不得为"验证数据""获取更多信息"等任何理由再次执行脚本
- 若脚本执行失败，直接向用户报告错误，不得重试
```bash
python3 "$SKILL_PATH/scripts/search_bili_realtime.py" "<关键词>" [--sort 排序] [--time 时间] [--page 页码]
```
**参数说明：**
| 参数 | 可选值 | 含义 |
| -------- | ----------------------- | --------------------------------------- |
| keyword | 任意字符串 | 搜索关键词，多个词用英文逗号连接 |
| `--sort` | `1` / `2` / `3` | 综合排序 / 最新发布 / 最多点赞（默认1） |
| `--time` | `7` / `30` / `90` / `0` | 最近7天 / 30天 / 90天 / 不限（默认7） |
| `--page` | 正整数 | 页码，从1开始（默认1） |
脚本以 JSON 格式输出：
| 字段 | 说明 |
| -------------------- | -------------------------------- |
| `articles` | 关键词匹配视频列表（按点赞降序） |
| `sort_type_label` | 本次排序方式文字说明 |
| `publish_time_label` | 本次时间范围文字说明 |
| `page` | 当前页码 |
| `total_pages` | 总页数 |
| `has_next` | 是否有下一页（true/false） |
每条视频字段：
| 字段 | 说明 |
| --------------- | ---------------------------------------------------------- |
| `title` | 视频标题（已清洗HTML标签、空格、特殊字符，[]已替换为【】） |
| `author` | UP主昵称 |
| `like_count` | 点赞数 |
| `comment_count` | 评论数 |
| `collect_count` | 收藏数 |
| `play_count` | 播放量 |
| `danmaku_count` | 弹幕数 |
| `work_url` | 视频链接（直接可用） |
| `publish_time` | 发布时间（格式化） |
| `cover_url` | 封面图（https协议） |
| `tags` | 视频标签（逗号分隔） |
| `category` | 视频分区名称 |
### Step 3：判断结果并展示
#### 情况 A：articles 数量 > 0（有匹配结果）
**A1. 告知用户查询范围**
> 📊 关键词「**XXX**」实时查询到 **N 条**视频（排序：{sort_type_label} | 时间范围：{publish_time_label} | 第 {page} 页），以下是详细数据：
**A2. 渲染 Markdown 表格（全部展示）**
```markdown
| # | 视频标题 | UP主 | 播放量 | 点赞数 | 评论数 | 收藏数 |
| --- | -------------------- | ------ | ------ | ------ | ------ | ------ |
| 1 | [标题文字](视频链接) | UP主名 | 105.2w | 30.5w | 7.1w | 3.5w |
```
**数字格式化规则：**
- `< 10000`：原始数字（如 `320`）
- `≥ 10000`：`x.xw` 格式（如 `1.2w`）
**标题规则：** 脚本已自动清洗标题（去除HTML标签、空格、特殊字符，将`[]`替换为`【】`），直接使用 `title` 字段即可。Markdown 表格中使用 `[标题](work_url)` 格式展示；超过 30 字截断并加 `...`。⚠️ 标题中已不含 `[]`，不会与 Markdown 链接语法冲突。
**A3. 筛选能力提示（紧接在表格之后，每次必须输出）**
> 🔧 **支持筛选，回复以下指令可切换条件重新搜索：**
>
> - **排序方式**：综合排序 / 最新发布 / 最多点赞（当前：{sort_type_label}）
> - **发布时间**：最近7天 / 最近30天 / 最近90天 / 不限（当前：{publish_time_label}）
>
> 示例：「按最新发布、最近30天重新搜索」
**A4. 翻页提示（⚠️ 紧接在 A3 之后，不可省略，每次必须输出）**
- 若 `has_next` 为 true：
> 📄 当前第 **{page}** 页。回复「下一页」继续查看。
- 若 `has_next` 为 false（当前页不足 9 条或为空，已是最后一页）：
> 📄 当前第 **{page}** 页，已无更多数据。
**⚠️ A1~A4 缺一不可，必须在同一轮输出中连续完成。输出 A4 后紧跟 Step 4 订阅提示。若缺少 A4，视为执行错误，必须重新补充输出。**
#### 情况 B：articles 数量 = 0（无匹配结果）
**B1. 抱歉提示 + 拓词推荐**
> 😔 抱歉，未找到与「**XXX**」直接相关的内容，你可以尝试用更短或更宽泛的关键词重试（扩展词1,扩展词2,...扩展词10）
AI 必须生成**固定 10 个**扩展词，2~6 字，英文逗号分隔，不得少于 10 个。
**B2. 筛选能力提示（紧接在 B1 之后，每次必须输出，格式同 A3）**
**⚠️ B1~B2 必须在同一轮输出中连续完成，输出 B2 后紧跟 Step 4 订阅提示，不得中断。**
### Step 4：提示订阅
全部内容展示完毕后，**不等待、立刻结束输出**，仅在末尾附上订阅提示：
> 📩 是否订阅「**XXX**」的每日推送？订阅后每天 10:00 自动推送最新爆款视频。回复「确认订阅」即可创建定时任务。
### Step 5：创建定时任务（用户回复「确认订阅」时执行）
优先使用平台内置定时任务能力，若无则提供通用方案：
**平台内置定时任务（优先）：**
- 任务名称：`B站实时搜索订阅 - <关键词>`
- 执行频率：每天 10:00（cron：`0 10 * * *`）
- 执行内容：运行脚本并将结果按 Step 3~4 格式展示推送到当前对话
**通用配置方案：**
```bash
# Linux/macOS crontab
0 10 * * * python3 "$SKILL_PATH/scripts/search_bili_realtime.py" "<关键词>"
```
创建成功后告知用户："已成功订阅关键词「<关键词>」的B站实时视频推送，每天 10:00 将自动查询最新数据并通知你。"