A powerful integration for managing movie and TV show watchlists, history, and ratings via the Trakt.tv API.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install trakt-tv
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install trakt-tv using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is Trakt API Integration?
The Trakt API skill empowers your AI agent to interact directly with Trakt.tv, the premier platform for tracking TV shows and movies. By leveraging this Openclaw Skills integration, developers can automate media management tasks such as updating watch histories, organizing digital collections, and generating personalized content recommendations.
This skill provides a comprehensive bridge between your AI agent and the Trakt ecosystem. It allows for deep metadata retrieval and list synchronization, ensuring your entertainment profile remains accurate and up-to-date across all connected devices and applications. Whether building a personal recommendation engine or a media logging tool, this skill handles the complexities of the Trakt API with ease.
Trakt API Integration Use Cases
- Syncing movie watchlists and digital collection data across different media platforms.
- Automating the rating of TV shows and movies immediately after viewing.
- Retrieving trending or popular content to suggest new media to users based on community data.
- Searching for specific titles and high-quality metadata using Trakt's extensive database.
- Marking episodes or movies as watched to maintain an accurate viewing history without manual entry.
How Trakt API Integration Works
- The AI agent receives a user request related to movie or TV show management within the Openclaw Skills framework.
- The agent identifies the correct Trakt API endpoint based on the intent, such as synchronization, search, or discovery.
- A curl request is constructed using the stored environment variables for authentication and identification.
- The skill executes the request with required headers, including the Trakt API version and specific client credentials.
- The agent parses the returned JSON data and provides a formatted response or confirms the requested action to the user.
Trakt API Integration Setup
To get started with this skill, you must first create a Trakt application at https://trakt.tv/oauth/applications to obtain your credentials. Once you have your Client ID and Secret, follow these steps:
- Complete the OAuth flow to generate an access token.
- Add the following configuration to your
~/.openclaw/openclaw.jsonfile:
{
"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"
}
}
}
}
}
- Ensure your environment variables are correctly exported if running manual commands:
export TRAKT_CLIENT_ID="your_client_id"
export TRAKT_ACCESS_TOKEN="your_access_token"
Trakt API Integration Data Schema & Taxonomy
This skill utilizes standard Trakt objects to ensure high metadata accuracy and interoperability. Data is organized according to the following structures:
| Object Type | Key Fields | Supported Identifiers |
|---|---|---|
| Movie | Title, Year | Trakt ID, Slug, IMDB ID, TMDB ID |
| Show | Title, Year | Trakt ID, Slug, TVDB ID, IMDB ID, TMDB ID |
| Episode | Season, Number, Title | Trakt ID, TVDB ID, IMDB ID, TMDB ID |
All timestamps and date fields used by Openclaw Skills follow the UTC ISO 8601 format to ensure global consistency.
Trakt API Integration Advanced Features
- Batch processing support for adding or removing multiple media items in a single API request.
- Extended metadata retrieval using the full information parameter for detailed plot and cast data.
- Automatic watchlist cleanup where items are removed once marked as watched in the history.
- Built-in support for both authenticated user actions and unauthenticated public data discovery.
- Rate limit awareness to maintain stability during high-volume sync operations.
SKILL.md
Loading
Related Openclaw Skills
Daily Game News Skill
An automated scraping and reporting tool that aggregates news from top gaming websites into structured daily digests.
Self-Improvement Agent Skill
A structured logging and promotion system that enables AI coding agents to learn from errors, user corrections, and discovered best practices.
PinchBoard
A specialized social networking protocol for AI agents to communicate, share status updates, and engage with a machine-centric community.
OpenAI Whisper CLI
A powerful command-line tool for local speech-to-text transcription and translation without cloud dependency.
Local Task Runner
A streamlined execution engine for running Node.js scripts and code snippets locally without the overhead of full subagents.
NVIDIA NIM Integration
A performance-focused skill that delegates tasks from OpenClaw to specialized LLMs via the NVIDIA NIM platform.
Featured*
