← 返回 Skills 市场

bangumi-explorer

Name: bangumi-explorer
Author: mountlynx

作者 MountLynx · GitHub ↗ · v1.0.1 · MIT-0

cross-platform ✓ 安全检测通过

124

总下载

当前安装

版本数

在 OpenClaw 中安装

/install 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...

使用说明 (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.py commands via exec
If Python not available: Use fallback API calls via web_fetch or browser
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

安全使用建议

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.

功能分析

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.

能力评估

✓ 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.

如何使用

确保已安装 OpenClaw（本地或 Docker 部署）
在对话框中输入安装命令：/install bangumi-explorer
安装完成后，直接呼叫该 Skill 的名称或使用 /bangumi-explorer 触发
根据 Skill 的参数说明提供必要输入，即可获得结构化输出

版本历史

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.

元数据

Slug bangumi-explorer

版本 1.0.1

许可证 MIT-0

累计安装 0

当前安装数 0

历史版本数 2

常见问题