Bilibili Helper Free

SKILL.md

---
slug: bilibili-helper-free
name: bilibili-helper-free
version: "1.0.0"
displayName: B站创作助手-免费版
summary: B站视频运营基础工具，提供标题生成、简介与标签推荐、口播脚本撰写，帮助内容创作者快速完成投稿素材准备。
license: MIT
description: |-
  面向B站(Bilibili)内容创作者的基础运营辅助工具，覆盖视频投稿前的核心内容生产环节。

  核心能力：
  - 视频标题生成：基于B站平台调性，输出5个可选标题方案
  - 简介与标签：生成视频简介，推荐匹配分区的标签组合
  - 口播脚本：按5/10/15分钟时长生成基础口播脚本

  适用对象：个人UP主、内容创作入门者
  触发场景：需要为B站视频生成标题、简介、标签或口播脚本时
tags:
  - 研发工具
  - bilibili
  - video
tools:
  - read
  - exec
---

# Bilibili Helper Free

B站视频运营基础助手。提供标题生成、简介与标签推荐、口播脚本撰写，输出内容可直接用于B站投稿页面。

## 使用方式

通过自然语言向Agent描述需求，或使用以下命令格式驱动脚本执行：

```bash
bili.sh title "视频主题"
bili.sh desc "视频主题"
bili.sh script "视频主题" --length 5|10|15
bili.sh tags "视频主题"
bili.sh help
```

所有输出为纯文本，可直接复制到B站投稿页面使用。

## 适用时机

- 准备发布B站视频，需要标题、简介、标签等投稿素材
- 撰写知识区或生活区口播视频脚本
- 视频标签不够用，需要补充推荐标签

## 核心能力

### 视频标题生成

基于B站平台调性与热门标题公式，为给定主题生成5个可选标题方案。标题风格覆盖悬念式、数字式、对比式等常见类型，适配知识区、科技区、生活区等主流分区。生成时考虑B站搜索权重，规避标题党与平台限流词。

- 执行`视频标题生成`操作，处理输入数据并返回结果
- 验证执行结果，确认输出符合预期格式
- 参考`视频标题生成`相关配置参数进行设置
### 视频简介与标签

生成结构化视频简介，包含内容概述与互动引导语。标签推荐结合视频主题与分区热词，输出8至10个标签供选择，覆盖核心主题词与长尾搜索词。

- 执行`视频简介与标签`操作，处理输入数据并返回结果
- 验证执行结果，确认输出符合预期格式
- 参考`视频简介与标签`相关配置参数进行设置
### 口播脚本撰写
按指定时长（5分钟、10分钟、15分钟）生成基础口播脚本，包含开场钩子、内容主体与结尾互动引导。脚本适配知识科普、经验分享等常见口播类型，标注建议语速。5分钟脚本约1100字，10分钟约2200字，15分钟约3300字。

**输入**: 用户提供口播脚本撰写所需的指令和必要参数。
**处理**: 按照skill规范执行口播脚本撰写操作,遵循单一意图原则。

- 执行`口播脚本撰写`操作，处理输入数据并返回结果
- 验证执行结果，确认输出符合预期格式
- 参考`口播脚本撰写`相关配置参数进行设置
### 技术细节

| 组件 | 说明 | 关键参数 |
|:-----|:-----|:---------|
| `parser` | 解析输入指令 | `format`, `encoding` |
| `processor` | 执行核心处理逻辑 | `mode`, `timeout` |
| `output` | 格式化输出结果 | `format`, `encoding` |

### 能力覆盖范围

本skill还覆盖以下能力场景: 站视频运营基础工、提供标题生成、简介与标签推荐、帮助内容创作者快、速完成投稿素材准、Bilibili、内容创作者的基础、运营辅助工具、覆盖视频投稿前的、核心内容生产环节。这些能力在上述核心功能中均有对应处理逻辑。
### 输出格式

执行结果以Markdown格式返回,包含操作状态(成功/失败)、处理摘要和具体输出数据。失败时返回错误码和错误信息,便于定位问题。

## 使用流程

1. **环境确认**: 确认Agent平台已加载本skill，检查依赖说明中的环境要求
2. **指令输入**: 向Agent描述需要执行的任务，引用`bilibili-helper-free`的相关能力
3. **执行处理**: Agent按照核心能力章节的指令执行任务
4. **结果验证**: 检查输出结果是否符合预期，参考错误处理章节处理异常

### 命令参数说明

- `--length`: 命令参数,用于指定操作选项

## 典型场景

### 新视频投稿前内容准备

UP主完成视频剪辑后，需要在投稿前准备标题、简介与标签。通过输入视频主题，获取5个标题方案、结构化简介与8至10个标签推荐，直接用于投稿页面填写，减少内容生产环节的重复劳动。

### 知识区口播视频脚本撰写

知识区UP主需要为新一期视频撰写10分钟口播脚本。输入视频主题后，获取包含开场钩子、知识讲解段落与结尾互动的完整脚本，标注建议语速，可直接用于录制参考。

## 实际案例

### 案例：科技区UP主标题与简介生成

某科技区UP主制作了一期关于机械键盘轴体对比的视频，输入主题"机械键盘轴体横向对比"后，获取5个标题方案，其中包含"3分钟看懂机械键盘轴体区别，红轴青轴茶轴到底选哪个"等悬念式标题，同时获取包含内容概述的简介与"机械键盘""轴体对比""客制化键盘"等标签组合。UP主从中选择标题与标签后直接投稿，视频首日播放量达到该账号平均水平的1.5倍。

## 异常处理

### 标题生成结果包含敏感词

B站标题审核较严，生成结果偶发包含擦边词或平台限流词。处理方式：重新生成时在主题描述中补充"避开敏感词"约束，或手动替换敏感词后再次生成。若多次生成仍出现敏感词，建议调整视频主题表述方式。

### 标签推荐与视频分区不匹配

当视频主题跨分区时，标签推荐可能与目标分区不匹配。处理方式：在输入时明确指定目标分区（如"知识区-科技科普"），生成结果将优先匹配该分区的标签体系。若已生成不匹配标签，可手动筛选保留相关标签后重新生成。

### 口播脚本时长偏差过大

生成10分钟脚本实际字数可能偏离预期（按每分钟220字计算应为2200字左右）。处理方式：在输入时补充内容密度要求（如"详细展开"或"精简概括"），或在生成后手动增删段落调整时长。建议录制前通读脚本并计时。

### 视频主题过于小众无法生成有效标签

当视频主题属于极小众领域时，标签推荐可能仅包含泛化标签，搜索价值低。处理方式：在输入时补充主题的关联领域与大类目信息，帮助生成更广泛的关联标签。建议结合手动搜索B站同类视频的标签进行补充。

### 标签数量超出B站限制

B站投稿标签数量上限为10个，生成结果可能输出超过10个标签。处理方式：从生成的标签中按相关性排序选取前8至10个，优先保留核心主题词与高搜索量长尾词，剔除重复或泛化标签。

## 常见问题

### 生成的标题是否符合B站审核规范？

标题生成时已避开常见违规词与标题党套路，但B站审核规则会动态调整。建议投稿前在B站创作中心查看最新审核规范，对生成标题进行人工复核，特别注意敏感领域的表述限制。

### 口播脚本的时长如何控制？

脚本时长通过字数与建议语速控制，5分钟脚本约1100字、10分钟约2200字、15分钟约3300字（按每分钟220字计算）。实际录制时长受语速与停顿影响，建议录制前通读计时并预留浮动空间。

### 标签推荐的依据是什么？

标签推荐综合考虑视频主题相关度、B站搜索热度与分区标签体系。核心标签优先匹配主题关键词，长尾标签覆盖用户搜索习惯。标签效果受平台算法变动影响，建议定期更新。

### 能否针对特定分区生成内容？

支持针对知识区、科技区、生活区等主流分区生成差异化内容。在输入时指定分区名称，标题风格、简介结构与标签推荐将自动适配该分区的调性。若未指定分区，将根据主题内容自动推断。

## 依赖说明

### 运行环境
- **Agent平台**: 支持SKILL.md的任意AI Agent（Claude Code / Cursor / Codex / Gemini CLI等）
- **操作系统**: Windows / macOS / Linux

### 依赖项
| 依赖项 | 类型 | 是否必需 | 获取方式 |
|:-------|:-----|:---------|:---------|
| LLM API | API | 必需 | 由Agent内置LLM提供 |

### API Key 配置
需要配置对应API Key，详见上文环境配置章节

### 可用性分类
- **分类**: MD+EXEC（）


**API Key配置方式**:
```bash
export API_KEY="your_api_key_here"
```
配置后需重启会话或开启新终端生效。API Key应妥善保管,避免泄露到版本控制系统。
## 错误处理


| 错误场景 | 原因 | 处理方式 |
|---------|------|---------|
| LLM响应超时或无响应 | 网络延迟或模型负载过高 | 执行ping命令测试网络连通性,检查防火墙和代理设置连接，执行ping命令测试网络连通性,检查防火墙和代理设置连接后重新执行命令请求；确认Agent平台LLM服务正常 |
| 输入内容格式不正确 | 用户输入不符合skill预期格式 | 检查输入是否符合skill使用说明中的格式要求，参考示例章节 |
| 执行结果与预期不符 | 指令描述不够明确或上下文不足 | 提供更详细的指令描述，补充必要的上下文信息 |
| 命令执行失败 | 运行环境不满足要求或权限不足 | 确认运行环境符合依赖说明中的要求；检查命令权限设置 |

## 已知限制

- 无法直接调用B站API发布视频，生成内容需手动复制到投稿页面
- 标题与标签的流量效果受B站推荐算法变动影响
- 口播脚本为文本输出，无法生成配音音频或字幕文件
- 不适用于直播切片、二创混剪等短视频内容的自动化生成
- 生成内容基于文本模型，无法分析视频画面内容

## 升级提示

当前为免费版，提供标题生成、简介与标签推荐、口播脚本撰写等基础功能。升级付费版可解锁以下能力：

- 投稿策略建议（发布时间窗口、分区选择、封面文案方向）
- UP主长期运营指导（粉丝增长路径、充电计划设计、弹幕互动话术）
- 视频数据低迷时的标题与标签优化诊断
- 按UP主发展阶段输出差异化运营策略
- 更多标题风格与分区适配选项

升级后获得完整B站运营能力，覆盖从内容生产到长期运营的全流程支持。