trakt

🎬 影视追踪与收藏智能管家

基于Trakt官方API的影视数据管理技能,支持 watchlist、评分、观影历史同步,帮助用户高效管理影音收藏与发现新内容。

收藏
5.9k
安装
2.2k
版本
v0.1.0
CLS 安全性认证2026-06-23
点击查看完整报告 >

使用说明

核心用法

该技能通过封装Trakt.tv官方API,提供完整的影视数据生命周期管理能力。用户可通过自然语言指令驱动标准curl命令,完成观看列表维护、观影历史记录、个人媒体库收藏、内容评分(1-10分制)以及基于算法推荐的新片发现等操作。技术实现上采用HTTPS加密通信,支持批量操作和多种元数据ID识别方式(包括IMDb、TMDb、TVDB等),确保与Trakt平台的深度数据互通。所有操作均通过OAuth2认证保护,符合RESTful API设计规范。

显著优点

功能覆盖全面,从基础的增删改查到智能推荐一应俱全,满足影视管理的全场景需求;依托Trakt.tv成熟的影视数据库,metadata质量高且与主流媒体中心(Plex、Kodi等)生态互通;采用业界标准OAuth2认证协议,数据安全性有保障;支持批量操作(单次请求可处理多部电影/剧集),显著提升整理效率;数据格式标准化,支持跨平台同步和备份。

潜在缺点与局限性

作为T3来源(社区个人开发者维护),长期更新稳定性存在不确定性;初次配置需要完成复杂的OAuth2授权流程,对非技术用户门槛较高,需手动获取Client ID/Secret并完成token交换;Access Token有效期仅3个月,需定期刷新或重新授权;辅助脚本在终端输出token时缺乏敏感信息屏蔽,存在凭证泄露风险;强依赖外部环境变量配置,跨设备迁移需重复配置流程。

适合的目标群体

适合影视发烧友、媒体库整理爱好者、追剧达人以及需要系统性管理观影记录的数据控。特别适合已使用Trakt.tv追踪观影习惯,希望将AI助手融入影音工作流程的技术型用户。对于拥有大量本地媒体库并需要与云端watchlist同步的Plex/Kodi用户尤为实用。

使用风险

主要风险集中于凭证管理:若环境变量配置不当或误将配置文件提交至版本控制,可能导致OAuth token泄露;API有明确的速率限制(认证用户1000次GET/5分钟,POST限1次/秒),高频自动化操作可能触发限流;T3来源意味着安全更新依赖个人维护者响应速度;OAuth token过期后服务将中断,需人工介入重新授权;此外,脚本执行错误时可能将敏感信息输出至终端日志。

安全解读

核心用法

Trakt skill 提供完整的Trakt.tv API交互能力,涵盖四大核心场景:

1. 片单管理:通过/sync/watchlist端点添加、查询、移除待观影内容;自动与观看历史联动,标记已看后自动从watchlist清除
2. 数据追踪:维护collection(收藏介质如蓝光/4K)、history(观看历史)、ratings(1-10分评分)三大数据集

3. 内容发现:调用trending/popular获取热榜,或通过recommendations获取个性化推荐

4. 精准检索:支持title+year或IMDb/TMDB/Trakt ID多维度搜索

所有请求严格遵循trakt-api-version: 2协议,需携带Authorization: Bearer令牌;未认证端点(搜索/趋势)仅受限于1000次/5分钟的频率控制。

显著优点

  • 权威数据源:Trakt.tv为运营十余年的专业影视追踪平台,覆盖全球主流影视元数据
  • OAuth 2.0安全架构:access_token/refresh_token双令牌机制,凭证全程环境变量托管,零硬编码风险
  • 轻量零依赖:仅依赖系统原生curl与jq,无npm/pip供应链攻击面
  • 批量操作支持:单次请求可提交多件影片/剧集,API设计符合RESTful规范
  • 元数据丰富:返回IMDb/TMDB/TVDB多平台ID映射,便于与其他工具链整合

潜在局限

  • 配置门槛较高:需自行创建Trakt OAuth应用、完成授权码流程、手动配置JSON环境变量,对非技术用户不够友好
  • Token生命周期限制:access_token有效期约3个月,需手动刷新或重新授权
  • 速率限制严格:写入操作限制1次/秒,高频批量更新可能触发429限流
  • 地域内容差异:部分国家/地区影视元数据覆盖存在缺口
  • 无实时同步回调:依赖轮询查询,无Webhook推送机制

适合人群

  • 重度观影用户:需数字化管理数百+片单、追踪多年观看历史的影视爱好者
  • 跨平台整合者:通过Trakt作为中枢,同步Plex/Kodi/Infuse等播放端数据
  • 数据分析师:导出个人观影偏好数据,进行可视化统计
  • 家庭共享场景:管理多成员观影计划与推荐分发

常规风险

  • OAuth凭证泄露:助手脚本输出的token若被终端日志记录或屏幕共享截获,可能导致账户被接管
  • 误操作数据覆盖:批量POST请求若构造错误,可能意外覆盖历史评分或重复标记观看记录
  • API服务中断:Trakt.tv偶有维护窗口,需客户端实现优雅降级
  • 隐私元数据暴露:观看历史、评分偏好属于敏感行为数据,存储于第三方平台需接受其隐私政策

trakt 内容

手动下载zip · 6.9 kB
get_trakt_token.shtext/x-shellscript
请选择文件