playbooks

home / skills / openclaw / skills / anime

anime skill

/skills/jeffaf/anime

This skill helps agents quickly search and retrieve anime details using Jikan, delivering MAL IDs, titles, and synopses for humans.

npx playbooks add skill openclaw/skills --skill anime

Review the files below or copy the command above to add this skill to your agents.

Files (3)
SKILL.md
2.3 KB
---
name: anime
version: 1.0.1
description: "CLI for AI agents to search and lookup anime info for their humans. Uses Jikan (unofficial MyAnimeList API). No auth required."
homepage: https://jikan.moe
metadata:
  openclaw:
    emoji: "šŸŽŒ"
    requires:
      bins: ["bash", "curl", "jq"]
    tags: ["anime", "myanimelist", "jikan", "entertainment", "cli"]
---

# 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).

Overview

This skill provides a simple CLI for AI agents to search and retrieve anime information for users. It queries the Jikan (unofficial MyAnimeList) API with no authentication required, returning search results, full anime details, seasonal lineups, top rankings, and upcoming titles. The interface is designed for quick lookups and integration into agent workflows.

How this skill works

The CLI issues REST calls to the Jikan v4 API to perform searches, fetch anime details by MAL ID, list the current or specific season, show upcoming titles, and return top-ranked anime. Typical flow: search by title to obtain a MAL ID, then request detailed info for synopsis, genres, episodes, studios, score, and trailer links. Rate limits (3 requests/sec, 60 requests/min) are handled client-side by spacing requests.

When to use it

  • Answering a user question about an anime title or character (identify title and details).
  • Providing synopsis, episode count, studios, and score for a specific MAL ID.
  • Recommending currently airing or seasonal anime to a user.
  • Listing top-ranked or upcoming anime for discovery or briefings.
  • Integrating quick anime lookups into a conversational agent or automated script.

Best practices

  • Search first to obtain the MAL ID, then call info for complete details.
  • Respect the API rate limits: batch queries or add brief delays if running multiple requests.
  • Use season commands (winter/spring/summer/fall) with a year for precise seasonal queries.
  • Prefer MAL ID lookups for deterministic results rather than relying on fuzzy title matches.
  • Avoid using this tool for non-anime catalogs like manga or unrelated media.

Example use cases

  • User asks: "What's that anime about the elf mage?" ā€” run search, return matching titles and IDs.
  • Provide a full info card when a user says: "Tell me about anime ID 52991."
  • Show current season picks during a weekly newsletter: run anime season and list highlights.
  • Create a short top-10 list for a recommendation feature: run anime top 10 and format results.
  • Populate an upcoming-release digest by running anime upcoming 5 and sharing trailers/synopses.

FAQ

Do I need an API key or account?

No. The skill uses the public Jikan API and does not require authentication.

How do I get reliable details for a specific title?

Run anime search "title" to find the MAL ID, then run anime info <mal_id> for full, deterministic metadata.