letterboxd-companion

Your personal movie assistant. Track what you watch, check your lists, and get movie info from Letterboxd instantly.

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 username
  • limit: Optional, default 10

lb_watchlist

• command: python lb_tool.py watchlist "{{username}}" [limit]
• description: Gets movies in user's watchlist
• parameters:
  • username: The Letterboxd username
  • limit: 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")