前言¶
写番剧推荐、做追番清单、核对声优或 Staff 时，常见做法是打开 bgm.tv 手搜，或自己调 Bangumi 开放 API。前者打断对话上下文，后者要在项目里维护请求脚本和字段含义。若你希望 Agent 在对话里就能查条目、季番表和排名，又不想先配 API Key，可以装一个面向 Bangumi 的 Skill。下面介绍社区 Skill bangumi-explorer（坐标 @user_5bf608fc/bangumi-explorer，当前版本 1.0.1）能做什么、怎么装、使用时要注意什么。
这是什么¶
bangumi-explorer 是 SkillHub 上分类为 knowledge-management 的社区 Skill（来源：community），发布者为 user_5bf608fc；SkillHub 页面标注作者为 MountLynx。它面向 Bangumi（bgm.tv），让 Agent 查询动画、漫画、轻小说、游戏和音乐等主题数据。
官方说明：不需要身份验证（标签 requires_api_key=false）。Skill 说明里提到需要 Python 环境 时体验更完整；若没有 Python，仍可通过 WebSearch 等能力阅读 Bangumi 官方 API 文档来间接查询，但会额外消耗 token。
核心功能¶
以下能力均来自 SkillHub 简介，未在资料中出现的接口名或脚本不展开。
- 搜索主题（Subject）：按关键词查找动画、漫画、轻小说、游戏、音乐等条目。
- 条目详情与剧集列表：查看某一主题的详细信息与分集/章节列表。
- 季番表：浏览按季度整理的动画图表（季节性动画图表）。
- 评级与排名：查看评分、排名类列表。
- 人物与制作人员：查询配音演员、Staff 等相关信息。
数据均来自 Bangumi 站点生态；Skill 本身不替代 bgm.tv 的账号体系，也不要求登录。
安装与启用¶
SkillHub 给出的安装方式是：让 Agent 按官方安装文档操作，并安装坐标 @user_5bf608fc/bangumi-explorer。文档地址：
https://skillhub.cn/install/skillhub.md
也可在终端使用 SkillHub CLI（需已安装 skillhub）。安装时必须用 --dir 指向当前 Agent 实际读取的 skills 目录，否则默认会装到 ./skills/，Agent 可能识别不到。
command -v skillhub && skillhub --version
skillhub install @user_5bf608fc/bangumi-explorer --dir <skills 目录>
常见客户端的 skills 目录（以 SkillHub 安装文档为准）：
| 环境 | skills 目录 |
|---|---|
| Cursor | ~/.cursor/skills/ |
| Claude Code | ~/.claude/skills/ |
| Codex | ~/.codex/skills/ 或项目下 .agents/skills/ |
安装后按你所用客户端的惯例重启或刷新 Agent，使新 Skill 被加载。SkillHub 页面未单独列出 Cursor 与 Codex 的差异命令，二者仅在 --dir 路径上不同。
自然语言安装示例（与 SkillHub 页面一致）：
请根据 https://skillhub.cn/install/skillhub.md，安装 @user_5bf608fc/bangumi-explorer。
典型用法¶
官方未公开单独的 SKILL.md 示例段落，典型用法是在启用 Skill 后，用自然语言描述你想查的 Bangumi 信息，由 Agent 按 Skill 指引调用查询能力。下列表述与官方功能描述对应，可在对话中直接复现意图（具体返回字段以 Bangumi 数据为准）：
- 搜条目：「在 Bangumi 上搜索动画《某某》，列出匹配的主题。」
- 看详情与集数：「查 Bangumi subject id 为 … 的条目详情和剧集列表。」
- 季番：「列出 2026 年 1 月季番表 / 当季动画图表。」
- 排名：「查 Bangumi 动画评分排名前列的条目。」
- 声优 / Staff：「查某声优在 Bangumi 上的作品，或某部作品的 Staff 列表。」
若本机没有 Python，Agent 可能改为依赖 WebSearch 阅读 Bangumi API 文档再请求，响应会更慢、token 开销更大；有 Python 时更适合让 Skill 按既定脚本路径执行查询。
适用场景与注意¶
适合谁
- 需要在写作、整理、问答里频繁引用 Bangumi 条目、分集、季番或排名，又不想每次手动打开浏览器的人。
- 希望 Agent 侧免 API Key 访问公开 Bangumi 数据的场景。
限制与注意
- 社区 Skill，行为与维护节奏取决于发布者；升级前可在 SkillHub 查看版本（当前 1.0.1）。
- 无 Python 时仍可用，但依赖其他 Skill 读文档，成本和稳定性不如本地 Python 环境。
- 查询结果受 Bangumi 站点与开放 API 规则约束；敏感或需登录的操作不在「不需要身份验证」的范围内。
- SkillHub 统计（以抓取资料为准）：评分 100000，下载 803，安装 63——仅作商店热度参考，不代表数据时效性。
结尾¶
bangumi-explorer 把 Bangumi 的搜索、详情、季番表、排名和声优/Staff 查询收敛进 Agent 工作流，且无需配置 API Key。安装时记住坐标 @user_5bf608fc/bangumi-explorer 与 --dir 指向正确的 skills 目录即可。
- SkillHub 页面：https://www.skillhub.cn/skills/user_5bf608fc/bangumi-explorer
- API / 资源入口：https://api.skillhub.cn/user_5bf608fc/bangumi-explorer
