openclaw-trakt

# Trakt.tv Integration for OpenClaw

Integrate with Trakt.tv to track watch history and provide personalized show/movie recommendations.

**📚 Trakt API Documentation:** <https://trakt.docs.apiary.io/>

## First-Time Setup Required

**Before using this skill, run the interactive setup:**

### Automated Setup (Recommended)
```bash
python3 scripts/setup.py
```

This will guide you through:
1. Installing dependencies
2. Creating a Trakt application
3. Configuring credentials
4. Authenticating with PIN
5. Testing the integration

### Manual Setup
If automated setup doesn't work, follow the manual steps in the Setup section below.

### Interactive Setup for OpenClaw
When a user asks to "install Trakt" or "set up Trakt integration," OpenClaw should:
1. Read `INSTALL.md` for detailed interactive flow
2. Or run `python3 scripts/setup.py` and guide user through prompts

---

## Features

- Track watch history (automatically synced by Trakt from streaming services)
- Get personalized recommendations based on viewing habits
- Access user watchlists and collections
- Search for shows and movies
- View trending content

## Prerequisites

1. **Python dependencies:**
   ```bash
   # Install via pip (with --break-system-packages if needed)
   pip3 install requests
   
   # OR use a virtual environment (recommended)
   python3 -m venv ~/.openclaw-venv
   source ~/.openclaw-venv/bin/activate
   pip install requests
   ```
   
   Alternatively, install via Homebrew if available:
   ```bash
   brew install python-requests
   ```

2. **Trakt.tv account** with Pro subscription (required for automatic watch tracking)

3. **Trakt API application** - Create at <https://trakt.tv/oauth/applications>

4. **Configuration file:** `~/.openclaw/trakt_config.json` (see setup below)

## Setup

### 1. Create Trakt Application

1. Visit <https://trakt.tv/oauth/applications>
2. Click "New Application"
3. Fill in the form:
   - Name: "OpenClaw Assistant"
   - Description: "Personal AI assistant integrat...

# openclaw-trakt

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

## Overview

This OpenClaw skill integrates with [Trakt.tv](https://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:

```bash
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

```bash
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`:

```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

```bash
# Get PIN URL
pytho...