Your personal movie assistant. Track what you watch, check your lists, and get movie info from Letterboxd instantly.
This is a custom skill for the OpenCLAW agent framework. It leverages the letterboxdpy library to scrape public data from Letterboxd.com, allowing your AI agent to answer questions about movies and user activity.
- 🎬 User Stats: Get a user's watched count, reviews, lists, and favorite movies.
- 📓 Diary: Fetch recently watched movies from a user's diary.
- 📺 Watchlist: Retrieve movies from a user's watchlist.
- ℹ️ Movie Details: Get information about a specific movie (directors, year, rating, runtime).
- Python 3.8 or higher
- An OpenCLAW installation
-
Clone this repository into your OpenCLAW skills directory:
git clone https://github.com/Tamil-Venthan/letterboxd-tracker.git
-
Install the required dependencies:
pip install -r requirements.txt
-
Ensure the folder is named
letterboxd-trackerin your skills path.
Once installed, the OpenCLAW agent can use the following commands:
| Command | Description | Example Usage |
|---|---|---|
lb_user |
Get a user's profile stats | Agent: "Check generic_user's profile" |
lb_diary |
Get recent diary entries | Agent: "What did generic_user watch recently?" |
lb_watchlist |
Get watchlist items | Agent: "Show generic_user's watchlist" |
lb_movie |
Get details for a movie | Agent: "Tell me about The Batman" |
No API keys are required as this skill scrapes public data. However, be mindful of rate limits when making frequent requests to Letterboxd.
Contributions are welcome! Please feel free to submit a Pull Request.
- Fork the project
- Create your feature branch (
git checkout -b feature/AmazingFeature) - Commit your changes (
git commit -m 'Add some AmazingFeature') - Push to the branch (
git push origin feature/AmazingFeature) - Open a Pull Request
This project is licensed under the MIT License - Copyright (c) 2026 Tamil-Venthan - see the LICENSE file for details.
- Built by Tamil-Venthan
- Powered by letterboxdpy