letterboxd-tracker

您的私人电影助理。跟踪您观看的内容、检查您的列表并立即从 Letterboxd 获取电影信息。

# Letterboxd Skill

This skill allows the agent to retrieve information about movies or user activity from Letterboxd.

## Setup

```bash
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")

---

## 中文说明

# Letterboxd 技能

此技能允许代理从 Letterboxd 检索有关电影或用户活动的信息。

## 安装设置

```bash
pip install letterboxdpy
```

## 用法

当用户询问以下内容时使用：
- 他们的 Letterboxd 个人资料统计数据
- 他们最近观看的电影
- 他们的待看列表
- 特定电影的详细信息

## 命令

### `lb_user`
- **command**: `python lb_tool.py user "{{username}}"`
- **description**: 获取用户个人资料统计数据（观看数量、评论、列表、收藏）
- **parameters**: 
  - `username`：Letterboxd 用户名

### `lb_diary`
- **command**: `python lb_tool.py diary "{{username}}" [limit]`
- **description**: 从用户的日记中获取最近观看的电影
- **parameters**: 
  - `username`：Letterboxd 用户名
  - `limit`：可选，默认为 10

### `lb_watchlist`
- **command**: `python lb_tool.py watchlist "{{username}}" [limit]`
- **description**: 获取用户待看列表中的电影
- **parameters**: 
  - `username`：Letterboxd 用户名
  - `limit`：可选，默认为 10

### `lb_movie`
- **command**: `python lb_tool.py movie "{{slug}}"`
- **description**: 获取电影详细信息（标题、年份、评分、导演、简介）
- **parameters**: 
  - `slug`：电影 URL 短链接（例如 `vikram-2022`、`the-batman`）

## 示例

用户："我在 Letterboxd 上看过多少部电影？"
代理：（以 username="tamilventhan" 调用 `lb_user`）

用户："我最近看了哪些电影？"
代理：（以 username="tamilventhan" 调用 `lb_diary`）

用户："显示我的待看列表"
代理：（以 username="tamilventhan" 调用 `lb_watchlist`）

用户："给我介绍一下电影 Vikram"
代理：（以 slug="vikram-2022" 调用 `lb_movie`）