---
slug: "bilibili-helper-free"
name: "bilibili-helper-free"
version: 1.0.1
displayName: "B站创作助手-免费版"
summary: "B站视频运营基础工具，提供标题生成、简介与标签推荐、口播脚本撰写，帮助内容创作者快速完成投稿素材准备。"
summary_zh: "B站视频运营基础工具，提供标题生成、简介与标签推荐、口播脚本撰写，帮助内容创作者快速完成投稿素材准备。"
license: "MIT"
description: |-
  面向B站(Bilibili)内容创作者的基础运营辅助工具，覆盖视频投稿前的核心内容生产环节.
  核心能力：
  - 视频标题生成：基于B站平台调性，输出5个可选标题方案
  - 简介与标签：生成视频简介，推荐匹配分区的标签组合
  - 口播脚本：按5/10/15分钟时长生成基础口播脚本

  适用对象：个人UP主、内容创作入门者
  触发场景：需要为B站视频生成标题、简介、标签或口播脚本时
tags:
  - 研发工具
  - bilibili
  - video
  - B站
  - 视频
  - 媒体
  - 口播脚本
  - agent
  - 视频主题
  - api
  - 标签推荐
tools:
  - read
  - exec
  - write
homepage: ""
category: "Creative"
---
# Bilibili Helper Free

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

| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| input | string | 是 | B站创作助手-免费版处理的输入数据或指令 |
| options | object | 否 | 附加配置选项,如模式选择、格式偏好等 |
| callback_url | string | 否 | 异步处理完成后的回调通知URL |

## 使用方式

通过自然语言向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字.
**输入**: 用户提供口播脚本撰写所需的指令和必要参数.
**处理**: 解析口播脚本撰写的输入参数,执行核心处理逻辑,返回结构化结果和执行状态。- 验证返回数据的完整性和格式正确性
- 参考`口播脚本撰写`的配置文档进行参数调优
#
## 快速开始

1. 确认运行环境满足依赖说明中的要求
2. 在AI Agent对话中调用本技能,提供必要的输入参数
3. 检查输出结果,根据需要进行后续处理

> 详细的输入输出格式请参考下方章节说明。

## 使用流程

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

#
## 典型场景

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

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响应超时或无响应 | 网络延迟或模型负载过高 | 检查网络连接和配置后重试；确认Agent平台LLM服务正常 |
| 输入内容格式不正确 | 用户输入不符合skill预期格式 | 检查输入是否符合skill使用说明中的格式要求，参考示例章节 |
| 执行结果与预期不符 | 指令描述不够明确或上下文不足 | 提供更详细的指令描述，补充必要的上下文信息 |
| 命令执行失败 | 运行环境不满足要求或权限不足 | 确认运行环境符合依赖说明中的要求；检查命令权限设置 |

## 已知限制

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

## 升级提示

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

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

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

```json
{
  "success": true,
  "data": {
    "result": "B站创作助手-免费版处理结果",
    "execution_time": "0.5s",
    "metadata": {
      "version": "1.0",
      "processor": "bilibili-helper"
    }
  },
  "execution_log": [
    "解析输入参数",
    "执行核心处理",
    "格式化输出结果"
  ],
  "error": null
}
```