bangumi-explorer

Query Bangumi (bgm.tv) for anime, manga, light novels, games, and music. Search subjects, view details and episode lists, browse seasonal anime charts, ratin...

Query Bangumi (bgm.tv) for anime, manga, light novels, games, and music.

When to Use

Use this skill when the user asks about:

• Anime search, manga search, game search
• New anime this season, season chart
• Anime ranking, anime details, episode list
• Voice actor / seiyuu lookup
• Bangumi, bgm, or any ACGN subject inquiry

Environment Check

Before using this skill, check if Python is available:

python --version  # or python3 --version

If Python 3.9+ is available: Use the commands below with bangumi.py script (recommended, token-efficient).

If Python is NOT available: Use the fallback method — call Bangumi API directly via web_fetch or browser. This works without Python but consumes significantly more tokens (~3-5x) and is slower.

Fallback API Reference

• API Base: https://api.bgm.tv/v0
• User-Agent Required: MountLynx/bangumi_skill (https://github.com/MountLynx/bangumi_skill)
• Rate Limit: 0.5s between requests
• OpenAPI Spec: https://github.com/bangumi/api/blob/master/open-api/v0.yaml
• API Docs: https://github.com/bangumi/api

Steps

1. Check Python environment availability
2. If Python available: Run bangumi.py commands via exec
3. If Python not available: Use fallback API calls via web_fetch or browser
4. Present script output as-is — do not reformat

Commands

Run bangumi.py via exec in the skill directory:

# Search subjects (default: anime)
python bangumi.py search "<keyword>" [--type anime|book|game|music|real] [--limit 10]

# Subject details
python bangumi.py info <subject_id>

# Episode list
python bangumi.py episodes <subject_id>

# Seasonal chart (default: current season)
python bangumi.py season [--year 2026] [--month 4]

# Rating ranking
python bangumi.py rank [--type anime|book|game|music|real] [--top 20]

# Person search (voice actors, staff)
python bangumi.py person "<keyword>"

# Daily broadcast calendar
python bangumi.py calendar

# Character search
python bangumi.py character "<keyword>"

Parameters

Flag	Values	Default
--type	anime, book, game, music, real	anime
--limit / --top	integer	10 / 20
--year / --month	integer	current year / season start month

Notes

• No authentication needed. Does not support collections or progress tracking.
• Script caches API responses in ~/.bangumi/cache/ (auto-expires, auto-cleans).
• Requires Python 3.9+. Zero third-party dependencies (stdlib only).
• Rate-limited to 0.5s between requests to respect Bangumi API.
• Search API is experimental — use precise keywords for best results.
• Episode descriptions may be in Japanese.