# API Features

This document defines the tools that will be exposed by the `anitabi-mcpserver` MCP server.

## 1. Search Bangumi (Anime)
- **Description**: Search for a bangumi (anime) by name to get its Bangumi ID, which is required for querying seichi junrei locations.
- **Original API Method**: `GET https://api.bgm.tv/search/subject/{keywords}?type=2`
- **Input Fields**:
  - `keyword` (str, required): The name of the anime to search for.
- **Output Fields**:
  - A JSON string containing a list of matched animes, each with:
    - `id` (int): Bangumi ID.
    - `name` (str): Original name.
    - `name_cn` (str): Chinese name.
    - `summary` (str): Brief summary.

## 2. Get Anime Pilgrimage (Seichi Junrei) Locations Lite Info
- **Description**: Get the lite info of seichi junrei (anime pilgrimage) locations for a specific anime using its Bangumi ID.
- **Original API Method**: `GET https://api.anitabi.cn/bangumi/{subjectID}/lite`
- **Input Fields**:
  - `subjectID` (int, required): The Bangumi ID of the anime.
- **Output Fields**:
  - A JSON string containing the lite info, including `litePoints` which are the top 10 iconic locations.

## 3. Get Anime Pilgrimage (Seichi Junrei) Locations Detail Info
- **Description**: Get the detailed seichi junrei (anime pilgrimage) locations for a specific anime using its Bangumi ID.
- **Original API Method**: `GET https://api.anitabi.cn/bangumi/{subjectID}/points/detail`
- **Input Fields**:
  - `subjectID` (int, required): The Bangumi ID of the anime.
- **Output Fields**:
  - A JSON string containing a list of detailed location points.

## 4. Get Anime Pilgrimage Map URL (Currently Unavailable)
- **Description**: Get the URL to view the anime pilgrimage map in browser. *(Note: This feature is currently disabled/unavailable due to API issues)*
- **Original API Method**: Local URL construction `https://anitabi.cn/map?bangumiId={subjectID}`
- **Input Fields**:
  - `subjectID` (int, required): The Bangumi ID of the anime.
- **Output Fields**:
  - A string containing the URL.

## 4. Get Anime Pilgrimage Map URL (Note: Currently Unstable)
- **Description**: Get the URL to view the anime pilgrimage map in browser. Please note that this feature might currently be unstable or unavailable.
- **Original API Method**: Local URL construction `https://anitabi.cn/map?bangumiId={subjectID}`
- **Input Fields**:
  - `subjectID` (int, required): The Bangumi ID of the anime.
- **Output Fields**:
  - A string containing the URL.

