anime

What This Skill Does

The Anime Lookup skill provides a powerful command-line interface (CLI) for AI agents to interact with the Jikan API, an unofficial MyAnimeList API. This allows agents to effortlessly search for and retrieve detailed information about anime series for their human users. Whether a user is curious about a specific anime title, wants to know what's currently popular, or needs details about a particular show, this skill can deliver. It can fetch details by anime title or by its MyAnimeList ID (MAL ID), list anime airing in the current season, display top-ranked anime, and even show upcoming releases. No authentication or API keys are required, making it simple to integrate and use.

Installation

To install the Anime Lookup skill, use the following command:

clawhub install openclaw/skills/skills/jeffaf/anime-lookup

This command will download and set up the skill within your OpenClaw environment. The skill is located at {skill_folder}/anime and is a symlink to scripts/anime.

Use Cases

This skill is ideal for a wide range of user queries related to anime:

• Discovering New Anime: Users can ask for top-rated anime, anime airing this season, or upcoming releases to find new shows to watch.
• Getting Information on Specific Anime: If a user remembers a plot point or character, they can search for the anime by title to get details like synopsis, genres, studios, and status.
• Answering Anime Trivia: Agents can quickly look up MAL IDs to provide precise information about specific anime.
• Recommendation Engine: By querying seasonal or top-ranked lists, the agent can act as a basic recommendation engine.
• Quick Lookups: For users who know the MAL ID, a direct info lookup is very fast.

Agents should leverage this skill by first searching for an anime by title to obtain its MAL ID, then using the MAL ID to fetch comprehensive details. For general recommendations, seasonal and top-ranked queries are effective.

Example Prompts

• "Hey, can you find out what the anime 'Jujutsu Kaisen' is about?"
• "What are the top 10 anime currently airing?"
• "Tell me more about the anime with MAL ID 44501."

Tips & Limitations

• Data Source: Relies on the Jikan v4 API (api.jikan.moe). Ensure this API is accessible.
• Rate Limiting: Be mindful of Jikan's rate limits: 3 requests per second and 60 requests per minute. Implement delays if making rapid sequential calls.
• Scope: This skill is strictly for anime. It should not be used for manga, live-action movies, or other media unless they are anime films.
• MAL ID: The most precise way to get information is by using the MyAnimeList ID (MAL ID). If a user provides a title, the agent should first search to resolve the ID before requesting detailed info.
• Seasons: Supported seasons are winter, spring, summer, and fall. For current season, simply use anime season.
• Output Formatting: The output is designed for human readability. For programmatic use, parsing might be necessary.