← All skills

Tencent SkillHub · Developer Tools

Trakt.tv

Interact with the Trakt API to manage your watchlist, collection, ratings, and discover content

skill openclawclawhub Free

0 Downloads

0 Stars

0 Installs

0 Score

High Signal

Interact with the Trakt API to manage your watchlist, collection, ratings, and discover content

⬇ 0 downloads ★ 0 stars Unverified but indexed

Install for OpenClaw

Quick setup

Download the package from Yavira.
Extract the archive and review SKILL.md first.
Import or place the package into your OpenClaw setup.

Requirements

Target platform: OpenClaw
Install method: Manual import
Extraction: Extract archive
Prerequisites: OpenClaw
Primary doc: SKILL.md

Package facts

Download mode: Yavira redirect
Package format: ZIP package
Source platform: Tencent SkillHub
What's included: SKILL.md, get_trakt_token.sh, README.md

Validation

Use the Yavira download entry.
Review SKILL.md after the package is downloaded.
Confirm the extracted package contains the expected setup assets.

Install with your agent

Agent handoff

Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.

Download the package from Yavira.
Extract it into a folder your agent can access.
Paste one of the prompts below and point your agent at the extracted folder.

New install

I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Then review README.md for any prerequisites, environment setup, or post-install checks. Tell me what you changed and call out any manual steps you could not complete.

Upgrade existing

I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run.

Open Send to Agent page Open JSON manifest Open Markdown brief

Trust & source

Release facts

Source: Tencent SkillHub
Verification: Indexed source record
Version: 1.0.0

Provenance

Publisher: d-meagher
Source page: View original listing
Canonical URL: Open canonical page

Documentation

ClawHub primary doc Primary doc: SKILL.md 16 sections Open source page

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: Create a Trakt application at https://trakt.tv/oauth/applications Get your Client ID and Client Secret Complete OAuth flow to get an access token Set environment variables in ~/.openclaw/openclaw.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" } } } } }

Watchlist Management

Add to watchlist: 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: 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: 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: curl "https://api.trakt.tv/search/movie?query=inception" \ -H "trakt-api-version: 2" \ -H "trakt-api-key: $TRAKT_CLIENT_ID" Search shows: curl "https://api.trakt.tv/search/show?query=breaking+bad" \ -H "trakt-api-version: 2" \ -H "trakt-api-key: $TRAKT_CLIENT_ID"

History

Get watch history: curl https://api.trakt.tv/sync/history \ -H "Authorization: Bearer $TRAKT_ACCESS_TOKEN" \ -H "trakt-api-version: 2" \ -H "trakt-api-key: $TRAKT_CLIENT_ID" Add to history (mark as watched): curl -X POST https://api.trakt.tv/sync/history \ -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":"The Matrix","year":1999,"watched_at":"2024-01-15T20:00:00.000Z"}]}'

Collection

Get collection: curl https://api.trakt.tv/sync/collection/movies \ -H "Authorization: Bearer $TRAKT_ACCESS_TOKEN" \ -H "trakt-api-version: 2" \ -H "trakt-api-key: $TRAKT_CLIENT_ID" Add to collection: curl -X POST https://api.trakt.tv/sync/collection \ -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":"Blade Runner 2049","year":2017,"collected_at":"2024-01-15T20:00:00.000Z","media_type":"bluray","resolution":"uhd_4k"}]}'

Ratings

Get ratings: curl https://api.trakt.tv/sync/ratings/movies \ -H "Authorization: Bearer $TRAKT_ACCESS_TOKEN" \ -H "trakt-api-version: 2" \ -H "trakt-api-key: $TRAKT_CLIENT_ID" Add rating: curl -X POST https://api.trakt.tv/sync/ratings \ -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":"The Shawshank Redemption","year":1994,"rating":10}]}'

Discovery

Get recommendations: curl https://api.trakt.tv/recommendations/movies?limit=10 \ -H "Authorization: Bearer $TRAKT_ACCESS_TOKEN" \ -H "trakt-api-version: 2" \ -H "trakt-api-key: $TRAKT_CLIENT_ID" Get trending: curl https://api.trakt.tv/movies/trending \ -H "trakt-api-version: 2" \ -H "trakt-api-key: $TRAKT_CLIENT_ID" Get popular: curl https://api.trakt.tv/movies/popular \ -H "trakt-api-version: 2" \ -H "trakt-api-key: $TRAKT_CLIENT_ID"

Movie Object

{ "title": "Inception", "year": 2010, "ids": { "trakt": 16662, "slug": "inception-2010", "imdb": "tt1375666", "tmdb": 27205 } }

Show Object

{ "title": "Breaking Bad", "year": 2008, "ids": { "trakt": 1, "slug": "breaking-bad", "tvdb": 81189, "imdb": "tt0903747", "tmdb": 1396 } }

Episode Object

{ "season": 1, "number": 1, "title": "Pilot", "ids": { "trakt": 73482, "tvdb": 349232, "imdb": "tt0959621", "tmdb": 62085 } }

Usage Instructions

When the user asks to interact with Trakt: Always use curl with proper headers including the access token Required headers for all requests: trakt-api-version: 2 trakt-api-key: $TRAKT_CLIENT_ID Authorization: Bearer $TRAKT_ACCESS_TOKEN (for authenticated endpoints) Content-Type: application/json (for POST/PUT/DELETE) Identify the item using title and year, or IDs if available Use appropriate endpoint based on the action: Watchlist: /sync/watchlist (POST to add, /sync/watchlist/remove to remove) History: /sync/history (GET for viewing, POST for adding) Collection: /sync/collection (GET for viewing, POST for adding) Ratings: /sync/ratings (GET for viewing, POST for adding) Search: /search/{type}?query={q} (no auth required) Trending: /{type}/trending (no auth required) Popular: /{type}/popular (no auth required) Recommendations: /recommendations/{type} (requires auth) Handle responses appropriately: Success: 200/201 status codes Not found: 404 Unauthorized: 401 (token may need refresh) Rate limited: 429

Rate Limits

Authenticated: 1000 GET requests per 5 minutes, 1 POST/PUT/DELETE per second Unauthenticated: 1000 GET requests per 5 minutes

Getting OAuth Token

To get an access token, use this helper script: #!/bin/bash # Save as get_trakt_token.sh CLIENT_ID="your_client_id" CLIENT_SECRET="your_client_secret" REDIRECT_URI="urn:ietf:wg:oauth:2.0:oob" echo "1. Open this URL in your browser:" echo "https://trakt.tv/oauth/authorize?response_type=code&client_id=$CLIENT_ID&redirect_uri=$REDIRECT_URI" echo "" echo "2. Authorize the app and copy the code" echo -n "3. Paste the code here: " read CODE echo "" echo "Exchanging code for token..." RESPONSE=$(curl -s -X POST https://api.trakt.tv/oauth/token \ -H "Content-Type: application/json" \ -d "{ \"code\": \"$CODE\", \"client_id\": \"$CLIENT_ID\", \"client_secret\": \"$CLIENT_SECRET\", \"redirect_uri\": \"$REDIRECT_URI\", \"grant_type\": \"authorization_code\" }") echo "" echo "Response:" echo "$RESPONSE" | jq . echo "" echo "Add these to your OpenClaw config:" echo "TRAKT_ACCESS_TOKEN=$(echo $RESPONSE | jq -r .access_token)" echo "TRAKT_REFRESH_TOKEN=$(echo $RESPONSE | jq -r .refresh_token)" Make it executable: chmod +x get_trakt_token.sh

Examples

User: "Add Dune to my Trakt watchlist" Assistant: I'll add Dune to your Trakt watchlist. 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":"Dune","year":2021}]}' User: "What movies are trending on Trakt?" Assistant: Let me check the trending movies on Trakt. curl "https://api.trakt.tv/movies/trending?limit=10" \ -H "trakt-api-version: 2" \ -H "trakt-api-key: $TRAKT_CLIENT_ID" User: "Rate Breaking Bad 10/10 on Trakt" Assistant: I'll rate Breaking Bad 10/10 on Trakt. curl -X POST https://api.trakt.tv/sync/ratings \ -H "Content-Type: application/json" \ -H "Authorization: Bearer $TRAKT_ACCESS_TOKEN" \ -H "trakt-api-version: 2" \ -H "trakt-api-key: $TRAKT_CLIENT_ID" \ -d '{"shows":[{"title":"Breaking Bad","year":2008,"rating":10}]}'

Notes

Items are automatically removed from watchlist when marked as watched You can use IDs instead of title/year for more accuracy Extended info can be requested with ?extended=full parameter All dates should be in UTC ISO 8601 format The API supports batch operations - you can add multiple items in one request

Category context

Code helpers, APIs, CLIs, browser automation, testing, and developer operations.

Source: Tencent SkillHub

Largest current source with strong distribution and engagement signals.

Package contents

Included in package

2 Docs1 Scripts

SKILL.md Primary doc
README.md Docs
get_trakt_token.sh Scripts