trakt

# Trakt API Integration

Interact with Trakt.tv to manage your watchlist, track viewing history, maintain your collection, rate content, and discover new movies and shows.

## Authentication

Before using this skill, you need to set up Trakt API credentials:

1. Create a Trakt application at https://trakt.tv/oauth/applications
2. Get your Client ID and Client Secret
3. Complete OAuth flow to get an access token
4. Set environment variables in `~/.openclaw/openclaw.json`:

```json
{
  "skills": {
    "entries": {
      "trakt": {
        "enabled": true,
        "env": {
          "TRAKT_CLIENT_ID": "your_client_id",
          "TRAKT_CLIENT_SECRET": "your_client_secret",
          "TRAKT_ACCESS_TOKEN": "your_access_token",
          "TRAKT_REFRESH_TOKEN": "your_refresh_token"
        }
      }
    }
  }
}
```

## Available Commands

### Watchlist Management

**Add to watchlist:**
```bash
curl -X POST https://api.trakt.tv/sync/watchlist \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $TRAKT_ACCESS_TOKEN" \
  -H "trakt-api-version: 2" \
  -H "trakt-api-key: $TRAKT_CLIENT_ID" \
  -d '{"movies":[{"title":"Inception","year":2010}]}'
```

**Get watchlist:**
```bash
curl https://api.trakt.tv/sync/watchlist/movies \
  -H "Authorization: Bearer $TRAKT_ACCESS_TOKEN" \
  -H "trakt-api-version: 2" \
  -H "trakt-api-key: $TRAKT_CLIENT_ID"
```

**Remove from watchlist:**
```bash
curl -X POST https://api.trakt.tv/sync/watchlist/remove \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $TRAKT_ACCESS_TOKEN" \
  -H "trakt-api-version: 2" \
  -H "trakt-api-key: $TRAKT_CLIENT_ID" \
  -d '{"movies":[{"ids":{"trakt":12601}}]}'
```

### Search

**Search movies:**
```bash
curl "https://api.trakt.tv/search/movie?query=inception" \
  -H "trakt-api-version: 2" \
  -H "trakt-api-key: $TRAKT_CLIENT_ID"
```

**Search shows:**
```bash
curl "https://api.trakt.tv/search/show?query=breaking+bad" \
  -H "trakt-api-version: 2" \
  -H "trakt-api-key: $TRAKT_CLIEN...

# Trakt AgentSkill for OpenClaw

An [AgentSkills](https://agentskills.io/)-compatible skill that enables OpenClaw agents to interact with the Trakt API for managing watchlists, tracking viewing history, maintaining collections, rating content, and discovering movies and shows.

## What is AgentSkills?

AgentSkills is a standardized format for teaching AI agents how to use tools. Each skill is a folder containing a `SKILL.md` file with YAML frontmatter and usage instructions. OpenClaw loads these skills and makes them available to the agent.

This is **NOT** an MCP server - it's a simple skill file that teaches the agent how to use the Trakt API via curl commands.

## Installation

### Option 1: Install via ClawHub (Recommended)

```bash
npm install -g clawhub
clawhub install trakt
```

### Option 2: Manual Installation

1. Clone or download this repository to your OpenClaw skills directory:

```bash
# For workspace-specific (highest priority)
cd your-workspace
git clone https://github.com/yourusername/trakt-openclaw.git skills/trakt

# For user-wide (shared across all agents)
git clone https://github.com/yourusername/trakt-openclaw.git ~/.openclaw/skills/trakt
```

2. OpenClaw will automatically detect the skill in the next session.

## Setup

### Step 1: Create a Trakt Application

1. Go to https://trakt.tv/oauth/applications
2. Click "New Application"
3. Fill in:
   - **Name**: OpenClaw Trakt Integration (or your preferred name)
   - **Description**: AI agent access to Trakt
   - **Redirect URI**: `urn:ietf:wg:oauth:2.0:oob`
4. Save and note your **Client ID** and **Client Secret**

### Step 2: Get OAuth Access Token

Run the included helper script:

```bash
chmod +x get_trakt_token.sh
./get_trakt_token.sh
```

Follow the prompts to:
1. Open the authorization URL
2. Approve the application
3. Copy the code
4. Paste it into the script

The script will output the configuration you need.

### Step 3: Configure OpenClaw

Add the configuration to `~/.openclaw/openclaw....