openclaw-trakt

🎬 Trakt.tv integration skill for OpenClaw - Track and recommend TV shows and movies

Overview

This OpenClaw skill integrates with Trakt.tv to provide:

• 📺 Personalized recommendations based on your watch history
• 📊 Watch history tracking (synced automatically with Trakt Pro)
• 📝 Watchlist management
• 🔍 Search for shows and movies
• 📈 Trending content discovery

Features

• ✅ Simple PIN-based authentication
• ✅ Native Trakt recommendation API
• ✅ Access to watch history, watchlist, and trending content
• ✅ Full search functionality
• ✅ Automatic token storage and refresh
• ✅ CLI interface for testing

Installation

Automated Setup (Easiest!)

Run the interactive setup wizard:

cd ~/.openclaw/skills/openclaw-trakt
python3 scripts/setup.py

This will guide you through the entire setup process automatically:

• Install dependencies
• Help you create a Trakt application
• Configure credentials
• Authenticate with PIN
• Test the integration

Manual Setup

If you prefer to configure manually, follow these steps:

1. Install Dependencies

pip3 install requests --break-system-packages

# OR use a virtual environment (recommended)
python3 -m venv ~/.openclaw-venv
source ~/.openclaw-venv/bin/activate
pip install requests

2. Create Trakt Application

1. Go to https://trakt.tv/oauth/applications
2. Click "New Application"
3. Fill in:
   • Name: OpenClaw Assistant
   • Redirect URI: urn:ietf:wg:oauth:2.0:oob
4. Save and copy your Client ID and Client Secret

3. Create Configuration File

Create ~/.openclaw/trakt_config.json:

{
  "client_id": "YOUR_CLIENT_ID_HERE",
  "client_secret": "YOUR_CLIENT_SECRET_HERE",
  "access_token": "",
  "refresh_token": ""
}

Replace the placeholder values with your actual Client ID and Secret. Leave access_token and refresh_token empty.

4. Authenticate

# Get PIN URL
python3 scripts/trakt_client.py auth

# Visit the URL, authorize, copy PIN, then:
python3 scripts/trakt_client.py auth <YOUR_PIN>

Authentication tokens are saved to ~/.openclaw/trakt_config.json

Usage

Get Recommendations

python3 scripts/trakt_client.py recommend

Watch History

python3 scripts/trakt_client.py history

Watchlist

python3 scripts/trakt_client.py watchlist

Search

python3 scripts/trakt_client.py search "Breaking Bad"

Trending

python3 scripts/trakt_client.py trending

How OpenClaw Uses It

When you ask your OpenClaw assistant:

• "What should I watch?" → Runs recommend command
• "What have I been watching?" → Runs history command
• "What's trending?" → Runs trending command
• "Search for Breaking Bad" → Runs search command

The skill automatically triggers when Trakt-related queries are detected.

Skill Structure

openclaw-trakt/
├── SKILL.md              # OpenClaw skill documentation
├── scripts/
│   └── trakt_client.py   # Full Trakt API client
├── references/
│   └── api.md            # Trakt API reference
└── requirements.txt      # Python dependencies

Requirements

• Python 3.7+
• requests library
• Trakt.tv account (Pro subscription recommended for auto-tracking)
• Trakt API application credentials

API Reference

See references/api.md for detailed Trakt API endpoint documentation.

Troubleshooting

"Module 'requests' not found"

pip3 install requests --break-system-packages

"Authentication failed"

• Double-check your credentials in ~/.openclaw/trakt_config.json
• Ensure PIN is copied exactly (case-sensitive)
• Verify your Trakt application has proper permissions

"No recommendations"

• You need watch history on Trakt first
• Trakt Pro subscription required for auto-tracking
• Try rating some shows on Trakt to improve recommendations

Technical Details

• Auth Method: PIN-based OAuth
• API Version: Trakt API v2
• Storage: ~/.openclaw/trakt_config.json
• Rate Limits: 1000 requests per 5 minutes (authenticated)

Links

• 🌐 Trakt.tv
• 📚 API Documentation
• 🔑 Create App
• 🦞 OpenClaw

License

MIT

---

Built for OpenClaw | February 2026