letterboxd-companion

🎬 影迷专属·观影追踪与片单管理

连接 Letterboxd 电影社交平台,追踪观影记录、查看片单、获取影片详情,影迷的个性化电影助手。

收藏
5.6k
安装
1.2k
版本
1.0.0
CLS 安全扫描中
预计需要 3 分钟...

使用说明

核心用法

Letterboxd Tracker 是一款面向电影爱好者的社交追踪工具技能,通过调用 letterboxdpy 库与 Letterboxd 平台交互。该技能支持四大核心功能:

1. 用户档案查询 (lb_user):获取用户的观影统计,包括已看影片数、评论数、创建的片单数及最爱电影
2. 观影日记 (lb_diary):检索用户最近标记为已看的电影记录,支持自定义返回数量

3. 想看片单 (lb_watchlist):获取用户保存的待观影清单

4. 影片详情 (lb_movie):查询特定电影的元数据,包括片名、年份、评分、导演及剧情简介

使用示例

  • "我今年在 Letterboxd 上看了多少部电影?" → 调用 lb_user
  • "我最近看了什么?" → 调用 lb_diary,默认返回最近 10 部
  • "我的想看列表里有什么?" → 调用 lb_watchlist
  • "《蝙蝠侠》2022 的评分怎么样?" → 调用 lb_movie,slug 为 the-batman

显著优点

  • 影迷生态深度整合:直接对接全球最大的电影社交记录平台之一,数据覆盖数百万部影片
  • 轻量无侵入:仅需用户名即可查询公开档案,无需 OAuth 授权流程
  • 场景化查询:针对"最近看了什么""想看清单"等高频率问答场景优化
  • 扩展性强:基于开源 letterboxdpy 库,可持续跟进平台功能迭代

潜在缺点与局限性

  • 依赖非官方 APIletterboxdpy 通过网页抓取获取数据,存在因 Letterboxd 反爬策略或页面结构调整导致失效的风险
  • 仅限公开档案:无法访问私密日记或隐藏片单,用户体验受用户隐私设置限制
  • 无写入权限:仅支持查询,无法直接标记"已看"或添加至想看清单
  • 片名匹配依赖 slug:非英语影片需手动确认 URL slug(如 vikram-2022),对中文用户不够直观
  • 速率限制敏感:高频查询可能触发平台限制

适合人群

  • 活跃 Letterboxd 用户,希望快速回顾个人观影历史
  • 电影博主或内容创作者,需要即时调取片单数据用于讨论
  • 影迷群体中的"数据控",关注观影数量、类型分布等统计

常规风险

  • 数据隐私:查询他人公开档案时需注意社交礼仪,避免过度窥探
  • 服务稳定性:依赖第三方抓取库,建议设置优雅降级机制(如提示用户直接访问网站)
  • 时效性:评分、简介等数据以 Letterboxd 缓存为准,非实时同步

letterboxd-companion 内容

手动下载zip · 4.1 kB
lb_tool.pytext/plain
请选择文件