Bangumi Explorer

查询 Bangumi（bgm.tv）上的动画、漫画、轻小说、游戏及音乐信息。

适用场景

当用户提出以下类型的问题时，请使用该技能：

• 动画、漫画、游戏的搜索
• 本季度新番、季度榜单
• 动画排名、动画详情、分集列表
• 声优 / 配音演员查询
• 关于 Bangumi、bgm 或任何 ACGN 相关主题的询问

环境检查

使用该技能前，请先确认 Python 是否可用：

python --version  # 或 python3 --version

若已安装 Python 3.9+：推荐使用下方命令配合 bangumi.py 脚本（更节省 token）。

若未安装 Python：请改用备用方案——通过 web_fetch 或 browser 直接调用 Bangumi API。该方式无需 Python，但消耗 token 显著更高（约 3–5 倍），且响应更慢。

备用 API 参考

• API 基础地址: https://api.bgm.tv/v0
• 必需 User-Agent: MountLynx/bangumi_skill (https://github.com/MountLynx/bangumi_skill)
• 请求频率限制: 每次请求间隔至少 0.5 秒
• OpenAPI 规范: https://github.com/bangumi/api/blob/master/open-api/v0.yaml
• API 文档: https://github.com/bangumi/api

执行步骤

1. 检查 Python 环境是否可用
2. 若 Python 可用：在技能目录中通过 exec 执行 bangumi.py 命令
3. 若 Python 不可用：通过 web_fetch 或 browser 调用备用 API
4. 原样呈现脚本输出结果——请勿重新格式化

命令列表

在技能目录下，通过 exec 运行 bangumi.py：

# 搜索条目（默认类型为 anime）
python bangumi.py search "" [--type anime|book|game|music|real] [--limit 10]

# 条目详情
python bangumi.py info 

# 分集列表
python bangumi.py episodes 

# 季度榜单（默认为当前季度）
python bangumi.py season [--year 2026] [--month 4]

# 评分排名
python bangumi.py rank [--type anime|book|game|music|real] [--top 20]

# 人物搜索（声优、制作人员等）
python bangumi.py person ""

# 每日放送日历
python bangumi.py calendar

# 角色搜索
python bangumi.py character ""

参数说明

注意事项

• 无需身份认证；不支持收藏或进度追踪功能。
• 脚本将 API 响应缓存至 ~/.bangumi/cache/（自动过期、自动清理）。
• 要求 Python 3.9+；无任何第三方依赖（仅使用标准库）。
• 为尊重 Bangumi API 的使用规范，脚本已内置 0.5 秒请求间隔限频。
• 搜索接口处于实验阶段——建议使用精确关键词以获得最佳结果。
• 剧集简介内容可能为日文。