A CLI-driven skill to access Trakt.tv watch history and search for media content via AI agents.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install trakt
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 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.tv CLI Integration?
The Trakt.tv CLI skill enables AI agents and developers to interact with their Trakt.tv profile directly through a terminal interface. This integration allows users to retrieve their recent watch history, paginate through viewed items, and perform global searches for movies and television series. By leveraging Openclaw Skills, this tool bridges the gap between media tracking and automated workflows, providing a seamless way to query entertainment data.
This skill is particularly useful for users who want to maintain a digital log of their media consumption without leaving their development environment. It provides a read-only interface to your history, ensuring your data remains secure while being easily accessible for queries and research.
Trakt.tv CLI Integration Use Cases
- Retrieving a list of recently watched movies or episodes for status updates.
- Searching for specific titles to get release years and metadata.
- Paginating through a deep history of watched content for personal data analysis.
- Verifying if a specific piece of media has been logged in a user profile before starting a new series.
How Trakt.tv CLI Integration Works
- The user or AI agent triggers the skill via command line requests for history or search.
- For history requests, the skill authenticates with Trakt.tv using stored OAuth credentials.
- The CLI queries the Trakt.tv API to fetch the requested media records or search results.
- The results are formatted and returned to the terminal or the calling AI agent for display and further processing.
Trakt.tv CLI Integration Setup
First, install the CLI tool globally using npm:
npm install -g trakt-cli
Follow these steps to configure your account:
- Create a new application at https://trakt.tv/oauth/applications/new to obtain your Client ID and Client Secret.
- Run the authentication command:
trakt-cli auth --client-id <id> --client-secret <secret>. - Visit the URL displayed in your terminal and enter the provided device code.
- Your credentials will be securely saved to
~/.trakt.yamlfor future use by Openclaw Skills.
Trakt.tv CLI Integration Data Schema & Taxonomy
The skill manages data primarily through a configuration file and structured API responses:
- Configuration File:
~/.trakt.yamlstores the OAuth tokens and application identifiers. - History Data: Returns lists containing movie/show titles, episode details, and watch timestamps.
- Search Data: Provides structured results including title names, release years, and media types (movie vs. show).
| Data Type | Access Level | Requirement |
|---|---|---|
| Watch History | Read-Only | Authentication Required |
| Media Search | Read-Only | Public Access |
Trakt.tv CLI Integration Advanced Features
- Paginated history retrieval allowing users to navigate through thousands of watched items using the
--pageflag. - Custom limit overrides (e.g.,
--limit 50) to adjust the volume of data returned in a single query. - Public search functionality that works without individual user authentication for quick metadata lookups.
- Integration ready for Openclaw Skills to allow AI agents to answer complex questions about your viewing habits.
SKILL.md
Loading
Related Openclaw Skills
Todoist
A powerful integration for managing Todoist tasks and projects directly through an AI agent via the TypeScript CLI.
Steam Games CLI
A powerful command-line interface for browsing, filtering, and discovering games within your Steam library based on playtime, ratings, and compatibility.
Resend Inbound Email Manager
A specialized CLI tool for programmatically accessing, listing, and inspecting received emails and domain configurations via the Resend API.
Paprika Recipe Manager CLI
A powerful command-line interface for the Paprika Recipe Manager that enables AI agents to query recipes, meal plans, and grocery lists.
TriMet Transit CLI
A command-line interface for accessing real-time Portland TriMet transit data, including arrivals, trip routing, and system alerts.
Elite Longterm Memory
A sophisticated multi-layered memory architecture for AI agents that integrates vector search, Git-based knowledge graphs, and write-ahead logging.
Featured*
