bangumi

name	bangumi
description	Bangumi (bgm.tv) API reference — search, subject detail, calendar, user collections, related subjects.
when_to_use	When you need to call a Bangumi API action. For search/discovery workflows, use anime-search instead.

bangumi

Bangumi (bgm.tv) API reference.

Actions

• search: Search anime/manga by keyword with filters (type, tag, date, rating).
• subject_detail: Get full details for a specific Bangumi subject.
• latest_episode: Get the latest aired main-story episode for a subject.
• calendar: View the weekly anime airing schedule.
• related_subjects: Find sequels, prequels, and related works.
• reviews: Fetch community discussion topics and blog reviews for a subject.
• user_collections: List the user's collection by status. Requires token.
• update_collection: Update collection status, rating, comment, or episode progress. Requires token.

Prerequisites

search, subject_detail, calendar, related_subjects, reviews are public APIs — no token needed.

user_collections and update_collection require a Bangumi access token configured in config.toml:

[bangumi]
access_token = "your_bangumi_token"

If missing, these actions return Error: Bangumi access token not configured. Tell the user to set [bangumi] access_token in config.toml.

Data Types

Collection types: 1=wish(想看), 2=done(看过), 3=doing(在看), 4=on_hold(搁置), 5=dropped(抛弃) Subject types: 1=book, 2=anime, 3=music, 4=game, 6=real

Latest aired episode

Use latest_episode when the user asks which episode of an anime is the latest/current aired episode. It needs a Bangumi subject ID. If the user gives only a title, call search first and then call latest_episode with the selected subject_id.

This action uses Bangumi episode airdate and only considers main-story episodes (type=0). Bangumi provides date precision only, so it cannot distinguish whether today's episode has already reached its exact broadcast time. The action treats "today" as the current UTC+8 date.