| name | letterboxd-tracker |
| description | Your personal movie assistant. Track what you watch, check your lists, and get movie info from Letterboxd instantly. |
| author | Tamizh |
| version | 1.1.0 |
Letterboxd Skill
This skill allows the agent to retrieve information about movies or user activity from Letterboxd.
Setup
pip install letterboxdpy
Usage
Use this when the user asks about:
- Their Letterboxd profile stats
- Movies they've watched recently
- Their watchlist
- Specific movie details
Commands
lb_user
- command:
python lb_tool.py user "{{username}}"
- description: Gets user profile stats (watched count, reviews, lists, favorites)
- parameters:
username: The Letterboxd username
lb_diary
- command:
python lb_tool.py diary "{{username}}" [limit]
- description: Gets recently watched movies from user's diary
- parameters:
username: The Letterboxd usernamelimit: Optional, default 10
lb_watchlist
- command:
python lb_tool.py watchlist "{{username}}" [limit]
- description: Gets movies in user's watchlist
- parameters:
username: The Letterboxd usernamelimit: Optional, default 10
lb_movie
- command:
python lb_tool.py movie "{{slug}}"
- description: Gets movie details (title, year, rating, directors, description)
- parameters:
slug: Movie URL slug (e.g., vikram-2022, the-batman)
Examples
User: "How many movies have I watched on Letterboxd?"
Agent: (Calls lb_user with username="tamilventhan")
User: "What movies did I watch recently?"
Agent: (Calls lb_diary with username="tamilventhan")
User: "Show my watchlist"
Agent: (Calls lb_watchlist with username="tamilventhan")
User: "Tell me about the movie Vikram"
Agent: (Calls lb_movie with slug="vikram-2022")
