anime

CLI 用于 AI 代理搜索和查找人类的动漫信息。使用 Jikan（非官方 MyAnimeList API）。无需授权。

# Anime Lookup

CLI for AI agents to search and lookup anime for their humans. "What's that anime about the elf mage?" — now your agent can answer.

Uses Jikan (unofficial MyAnimeList API). No account or API key needed.

## Usage

```
"Search for anime called Frieren"
"What's the top anime right now?"
"What anime is airing this season?"
"Tell me about anime ID 52991"
```

## Commands

| Action | Command |
|--------|---------|
| Search | `anime search "query"` |
| Get details | `anime info <mal_id>` |
| Current season | `anime season` |
| Top ranked | `anime top [limit]` |
| Upcoming | `anime upcoming [limit]` |
| Specific season | `anime season <year> <season>` |

### Examples

```bash
anime search "one punch man"      # Find anime by title
anime info 30276                  # Get full details by MAL ID
anime top 10                      # Top 10 anime
anime season                      # Currently airing
anime season 2024 fall            # Fall 2024 season
anime upcoming 5                  # Next 5 upcoming anime
```

## Output

**Search/list output:**
```
[52991] Sousou no Frieren — 28 eps, Finished Airing, ⭐ 9.28
```

**Info output:**
```
🎬 Sousou no Frieren
   English: Frieren: Beyond Journey's End
   MAL ID: 52991 | Score: 9.28 | Rank: #1
   Episodes: 28 | Status: Finished Airing
   Genres: Adventure, Drama, Fantasy
   Studios: Madhouse

📖 Synopsis:
[Full synopsis text]

🎥 Trailer: [YouTube URL if available]
```

## Notes

- Uses Jikan v4 API (api.jikan.moe)
- Rate limit: 3 req/sec, 60 req/min
- No authentication required
- MAL ID is the MyAnimeList database ID
- Seasons: winter, spring, summer, fall

---

## Agent Implementation Notes

**Script location:** `{skill_folder}/anime` (symlink to `scripts/anime`)

**When user asks about anime:**
1. Run `./anime search "title"` to find MAL ID
2. Run `./anime info <id>` for full details
3. Run `./anime season` or `./anime top` for recommendations

**Don't use for:** Non-anime media (manga, movies unless anime films).

---

## 中文说明

# Anime Lookup

供 AI 代理为其用户搜索和查找动漫的 CLI 工具。"那部关于精灵法师的动漫叫什么来着？" —— 现在你的代理可以回答了。

使用 Jikan（非官方 MyAnimeList API）。无需账号或 API 密钥。

## 用法

```
"Search for anime called Frieren"
"What's the top anime right now?"
"What anime is airing this season?"
"Tell me about anime ID 52991"
```

## 命令

| 操作 | 命令 |
|--------|---------|
| 搜索 | `anime search "query"` |
| 获取详情 | `anime info <mal_id>` |
| 当前季度 | `anime season` |
| 排名靠前 | `anime top [limit]` |
| 即将上映 | `anime upcoming [limit]` |
| 指定季度 | `anime season <year> <season>` |

### 示例

```bash
anime search "one punch man"      # Find anime by title
anime info 30276                  # Get full details by MAL ID
anime top 10                      # Top 10 anime
anime season                      # Currently airing
anime season 2024 fall            # Fall 2024 season
anime upcoming 5                  # Next 5 upcoming anime
```

## 输出

**搜索/列表输出：**
```
[52991] Sousou no Frieren — 28 eps, Finished Airing, ⭐ 9.28
```

**详情输出：**
```
🎬 Sousou no Frieren
   English: Frieren: Beyond Journey's End
   MAL ID: 52991 | Score: 9.28 | Rank: #1
   Episodes: 28 | Status: Finished Airing
   Genres: Adventure, Drama, Fantasy
   Studios: Madhouse

📖 Synopsis:
[Full synopsis text]

🎥 Trailer: [YouTube URL if available]
```

## 说明

- 使用 Jikan v4 API（api.jikan.moe）
- 速率限制：3 req/sec，60 req/min
- 无需鉴权
- MAL ID 是 MyAnimeList 数据库 ID
- 季度：winter、spring、summer、fall

---

## 代理实现说明

**脚本位置：** `{skill_folder}/anime`（指向 `scripts/anime` 的符号链接）

**当用户询问动漫时：**
1. 运行 `./anime search "title"` 查找 MAL ID
2. 运行 `./anime info <id>` 获取完整详情
3. 运行 `./anime season` 或 `./anime top` 获取推荐

**不要用于：** 非动漫媒体（漫画、电影，除非是动漫电影）。