A high-performance Python-based tool to scrape and export public Letterboxd watchlists into structured data formats.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install letterboxd-watchlist
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 letterboxd-watchlist 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 Letterboxd Watchlist Scraper?
The Letterboxd Watchlist Scraper is a specialized tool designed to extract film titles and URLs from any public Letterboxd profile without requiring authentication. It effectively bridges the gap between web-based movie tracking and local data management, making it an essential addition to the Openclaw Skills library for cinephiles and developers alike.
This skill automates the tedious process of manual data entry by programmatically navigating through paginated watchlist results. By utilizing a robust regex-based parsing approach, it ensures that movie data is accurately captured and formatted for immediate use in other applications or personal databases.
Letterboxd Watchlist Scraper Use Cases
- Archiving a personal Letterboxd watchlist into a local CSV file for offline access.
- Migrating movie lists from Letterboxd to other media management systems or spreadsheets.
- Building custom watch-next queues by programmatically fetching public lists.
- Generating structured JSONL datasets for movie-related research or data analysis projects.
How Letterboxd Watchlist Scraper Works
- The skill receives a public Letterboxd username from the user.
- It triggers a Python script that targets the paginated watchlist URL structure.
- The scraper identifies film entries by looking for specific data-target-link attributes within the HTML.
- It automatically navigates through all available pages until no more film posters are detected.
- The gathered metadata is cleaned and written to the specified output format (CSV or JSONL).
Letterboxd Watchlist Scraper Setup
To use this tool within the Openclaw Skills framework, ensure you have the uv package manager installed. Run the following commands from your terminal:
# Basic export to CSV
uv run scripts/scrape_watchlist.py <username> --out watchlist.csv
# Advanced export to JSONL with custom delays and retries
uv run scripts/scrape_watchlist.py <username> --out watchlist.jsonl --delay-ms 300 --timeout 30 --retries 2
Letterboxd Watchlist Scraper Data Schema & Taxonomy
The skill generates structured data in two primary formats depending on the file extension provided:
| Format | Fields | Description |
|---|---|---|
| CSV | title, link | Standard comma-separated values for spreadsheet compatibility. |
| JSONL | {"title": "...", "link": "..."} | One JSON object per line, ideal for programmatic processing. |
Letterboxd Watchlist Scraper Advanced Features
- Configurable crawl delays (default 250ms) to ensure polite scraping and avoid IP rate limiting.
- Built-in retry logic and timeout settings to handle transient network failures or slow responses.
- Automated pagination detection to ensure the entire watchlist is captured regardless of length.
- Input validation for Letterboxd usernames to prevent malformed request errors.
SKILL.md
Loading
Related Openclaw Skills
tweet-cli
A secure CLI tool for AI agents to post, reply, and quote on X/Twitter using official API v2 credentials.
LinkedIn CLI
A streamlined command-line tool for managing LinkedIn posts and shares via the official API v2 with OAuth security.
ClawdTM Review
A specialized skill for AI agents to interact with the ClawdTM platform to review, rate, and discover peer-recommended Openclaw Skills.
ClawdTM Skill Advisor
A security-first discovery and installation engine designed to help AI agents expand their capabilities using Openclaw Skills.
Council of High Intelligence
Convene a council of 11 historical thinkers to deliberate on complex technical and strategic problems using a structured multi-round protocol.
Rent My Browser
Turn your AI agent's idle time into a revenue stream by executing automated browser tasks for the Rent My Browser marketplace.
METADATA
Featured*
