← Back to Skills Marketplace
124
Downloads
0
Stars
0
Active Installs
2
Versions
Install in OpenClaw
/install bangumi-explorer
Description
Query Bangumi (bgm.tv) for anime, manga, light novels, games, and music. Search subjects, view details and episode lists, browse seasonal anime charts, ratin...
README (SKILL.md)
Bangumi Explorer
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
- Check Python environment availability
- If Python available: Run
bangumi.pycommands viaexec - If Python not available: Use fallback API calls via
web_fetchorbrowser - 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 "\x3Ckeyword>" [--type anime|book|game|music|real] [--limit 10]
# Subject details
python bangumi.py info \x3Csubject_id>
# Episode list
python bangumi.py episodes \x3Csubject_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 "\x3Ckeyword>"
# Daily broadcast calendar
python bangumi.py calendar
# Character search
python bangumi.py character "\x3Ckeyword>"
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.\r
Usage Guidance
This skill appears to be a straightforward Bangumi query tool. Before installing consider: (1) it will execute a local Python script (requires Python 3.9+) — run in an environment you trust or sandbox if you have concerns; (2) it writes cached JSON to ~/.bangumi/cache (auto-expires/cleans) — check that directory if you care about local files; (3) the fallback uses web_fetch/browser and will cause the agent to issue HTTP requests itself (token cost if using an LLM-based fetcher) — prefer running the bundled script if available; (4) no credentials are requested and the code shown uses only the official API base and a User-Agent header, but if you want maximal assurance review the full bangumi.py file yourself before enabling. If you need higher assurance, run the script manually first to observe its behavior and network calls.
Capability Analysis
Type: OpenClaw Skill
Name: bangumi-explorer
Version: 1.0.1
The bangumi-explorer skill is a legitimate tool for querying the Bangumi (bgm.tv) database for anime, manga, and games. The included Python script (bangumi.py) uses only standard libraries, implements responsible rate limiting, and manages a local cache in the user's home directory (~/.bangumi/cache). There is no evidence of data exfiltration, unauthorized network access, or malicious instructions in the SKILL.md file.
Capability Assessment
Purpose & Capability
Name/description match the actual behavior: the code queries the public Bangumi API (https://api.bgm.tv/v0) for subjects, people, episodes, rankings, etc. No credentials, unrelated services, or surprising binaries are required.
Instruction Scope
SKILL.md directs the agent to run the included bangumi.py (preferred) or fall back to direct API calls via web_fetch/browser. The runtime instructions are narrowly scoped to search/info/episodes/season/rank/person/calendar/character queries. The script performs HTTP GET/POST, rate-limits requests, and reads/writes cache files in the user's home (~/.bangumi/cache). Note: the skill instructs to 'present script output as-is' which gives the script control over formatting; that is expected but worth noting.
Install Mechanism
No install spec; the skill is instruction-only plus a bundled Python script. This is low-risk compared to downloading/extracting external installers. The script claims zero third-party dependencies and uses Python stdlib (urllib, json, pathlib).
Credentials
The skill requests no environment variables or credentials. It does perform network requests to the public Bangumi API and writes cache files under ~/.bangumi/cache. Those are proportionate to a read-only query tool; there is no sign it attempts to read unrelated config or secrets.
Persistence & Privilege
always is false and the skill does not request permanent platform privileges. It writes its own cache under ~/.bangumi and includes a cache-cleaning helper; it does not modify other skills or system-wide configs.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install bangumi-explorer - After installation, invoke the skill by name or use
/bangumi-explorer - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.1
- Added documentation for two new commands: `calendar` (daily broadcast calendar) and `character` (character search).
- Updated API fallback User-Agent to `MountLynx/bangumi_skill (https://github.com/MountLynx/bangumi_skill)` for identification.
v1.0.0
Initial release of Bangumi Explorer.
- Search and view details for anime, manga, games, light novels, and music from Bangumi (bgm.tv).
- Supports subject search, detailed info, episode lists, seasonal charts, and rating rankings.
- Look up voice actors, seiyuu, and staff members.
- No authentication required; works via Python script or direct API if Python is unavailable.
- Includes fallback method using Bangumi public API for environments without Python.
- Respects rate limits and uses cached API responses for efficiency.
Metadata
Frequently Asked Questions
What is 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... It is an AI Agent Skill for Claude Code / OpenClaw, with 124 downloads so far.
How do I install bangumi-explorer?
Run "/install bangumi-explorer" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is bangumi-explorer free?
Yes, bangumi-explorer is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does bangumi-explorer support?
bangumi-explorer is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created bangumi-explorer?
It is built and maintained by MountLynx (@mountlynx); the current version is v1.0.1.
More Skills