Binge Senpai

Adds anime or manga to the person's Binge Senpai library, 1 to 50 titles per call, each by id or by its title as typed. It only adds: a title already in the library is left unchanged and reported as already_in_library (update_library_entry changes it). status `seen` files a title as completed, or as in progress while it is still airing; a title that hasn't aired yet comes back not_aired. A typed title that could be more than one, or whose year doesn't match the title found, comes back ambiguous with up to 3 candidates and is not added; a year, or the candidate's id, chooses. A score (1–10) applies to titles this call adds. Titles saved as in progress or planning get new-episode alerts. Adult-rated (R+ and Rx) titles are not found.

add_to_library

Lists the titles in the person's Binge Senpai library (their anime and manga list) with each one's status, score and progress, 25 per page, plus how many titles they have in each status. Statuses: planning (plan to watch or read), in_progress (watching or reading), completed, on_hold, dropped. Adult-rated (R+ and Rx) titles are not included; hidden_count says how many were left out.

get_my_library

Recommends anime or manga for the person, ranked by Binge Senpai from their own library, 10 per page. Titles they have seen or marked Not for me are never included. With `like` (a title id), titles like that one. Without it, picks from the whole catalog (`from: anywhere`, the default) or from their plan-to-watch list (`from: my_plan`), optionally narrowed by mood, time budget, genres and things to avoid. `exclude_ids` leaves out titles already shown. Each pick has the person's Match % and a short reason. Under 3 seen titles the picks are popular titles, not personal (`personalized: false`). For the next episode of shows they are already watching, use get_up_next. Adult-rated (R+ and Rx) titles are not included.

get_recommendations

Details of one anime or manga by its id: a one-line description, genres, length, release status, when the next episode airs, streaming services, which season of its series it is with the ids of the previous and next seasons, the person's library entry, their Match %, and whether they marked it Not for me.

get_title_details

What's next in what the person is already watching or reading on Binge Senpai: anime they're watching with new episodes out that they haven't seen (with the next episode number), titles to continue or start from their list, and episodes airing today among the shows they watch or plan to, with times in their time zone. To pick something new to watch, use get_recommendations.

get_up_next

Marks one title, by its id, as Not for me: it won't be recommended to the person again, in Binge Senpai or through this connector. Their library is not changed. They can undo it in Binge Senpai under Settings → Connected assistants.

mark_not_for_me

Removes one title, by its id, from the person's Binge Senpai library, with its status, score, progress and dates. Returns what was removed. A title that isn't in the library is reported as not removed.

remove_from_library

Searches the Binge Senpai catalog of anime or manga, 10 results per page. `query` looks titles up by name and includes titles already in the person's library. `about` finds titles by theme, plot or mood described in a sentence, and leaves out titles the person has seen or marked Not for me. With neither, it browses by the filters. Each result carries the person's library entry and Match % when they have them. Adult-rated (R+ and Rx) titles are not included.

search_titles

Changes a title that is already in the person's Binge Senpai library, by its id: status, score (1–10), progress (episodes watched or chapters read), volumes read, and start or finish dates. Values are absolute, not increments: progress 7 means 7 episodes watched. Marking a title completed fills in its full progress and today's finish date unless given. A title that isn't in the library is not added; use add_to_library. Returns the entry before and after.

update_library_entry