mal-anime-tracker Skill

Purpose

Track anime/manga lists on MyAnimeList (MAL) and receive automatic notifications via OpenClaw when new episodes are available.

Setup

1. Set the following environment variables (e.g., in your shell configuration or openclaw vault):

```bash

ACCESS_TOKEN=your_access_token

REFRESH_TOKEN=your_refresh_token

CLIENT_ID=your_client_id

CLIENT_SECRET=your_client_secret

```

1. Install dependencies:

```bash

pip install -r requirements.txt

```

Authorization

1. Register your application on the MyAnimeList Developer Portal.
2. Generate a code_challenge (12-char alphanumeric) and navigate to the MAL OAuth2 authorization URL to get your code.
3. Run the authorization command:

```bash

python3 auth.py authorize

```

This will output your tokens, which you should add to your environment.

Features

• Monitor progress for anime you are currently watching.
• Query current anime/manga lists.
• Automatic token refresh.
• Search and manage personal MAL data.

CLI Reference

• python3 api.py search - Search for anime.
• python3 api.py update - Update anime status (e.g., watching, completed).
• python3 api.py delete - Remove anime from list.
• python3 api.py list-anime - Show your anime list.
• python3 api.py check-updates - Check for new episodes and output updates.
• python3 api.py refresh-auth - Force a token refresh using your credentials.
• python3 api.py list-manga - Show your reading list.
• python3 api.py search-forums - Search MAL forums.

Automation

# Refresh token and check updates every 6 hours
0 */6 * * * python3 /path/to/skills/mal-anime-tracker/api.py refresh-auth && python3 /path/to/skills/mal-anime-tracker/api.py check-updates | xargs -I {} openclaw message send --target <CHAT_ID> --message "{}"