核心用法
TorrentClaw 是一款面向电影和电视剧的智能化种子搜索与下载工具。用户通过自然语言描述需求（如"搜索 2024 年 4K 科幻电影"或"下载《绝命毒师》第五季第 14 集"），系统会自动调用 TorrentClaw API 进行多源聚合搜索。工作流程分为四步：首先检测本地已安装的 torrent 客户端（Transmission 或 aria2），然后执行搜索并支持丰富的过滤条件（画质 480p-2160p、HDR 类型、音频编码、年份、评分、语言等），接着以结构化表格展示结果（含海报、评分、种子质量评分、做种数），最后根据检测结果提供直接添加 magnet 链接、复制链接或下载 .torrent 文件的选项。
显著优点
多源聚合与智能匹配：整合 YTS、EZTV、Knaben、Prowlarr 等 30+ 个种子源，配合 TMDB 元数据增强，提供 AI 验证的匹配结果和质量评分（0-100），大幅降低虚假资源风险。
深度过滤能力：支持专业级筛选，包括 Dolby Vision/HDR10/HLG 等 HDR 格式、Atmos/FLAC/Opus 等音频编码、特定季集（S01E05 或 1x05 格式）、多语言本地化标题，满足发烧友对音画质的苛刻要求。
无缝本地集成：自动检测 Transmission 和 aria2 客户端，支持直接推送 magnet 链接并指定下载目录；未检测到客户端时提供安装指南，降低新手使用门槛。
灵活的访问层级：匿名用户即可使用（30 请求/分钟），免费 API key 提升至 120 请求/分钟，Pro tier 可达 1000 请求/分钟，兼顾 casual 用户和重度使用者。
潜在缺点与局限性
版权合规灰色地带：核心功能涉及版权内容的搜索与下载，用户需自行承担法律风险，工具本身不提供内容合法性判断。
依赖外部服务可用性：所有搜索功能依赖 torrentclaw.com API，若服务宕机或受限，技能将完全失效；种子源的做种数实时变化，可能出现"有结果但无法下载"的情况。
平台限制：Shell 脚本依赖 bash，Windows 用户必须借助 WSL 或 Git Bash，原生支持不足。
无内置播放功能：仅完成下载任务管理，视频播放需用户自行使用其他软件。
适合的目标群体
- 影音发烧友：追求 4K HDR、Dolby Atmos 等高品质资源的用户
- 剧集追更者：需要精准定位特定季集（如 S03E08）的 TV show 爱好者
- 技术型用户：已部署 Transmission/aria2 下载机、熟悉命令行操作的人群
- 多语言用户：需要搜索非英语内容（支持 10+ 语言本地化）的国际用户
使用风险
性能风险：聚合多源搜索可能产生较高延迟，复杂过滤条件下响应时间可达数秒；高峰期 API 速率限制可能触发 429 错误。
依赖项风险：依赖 curl、jq 等系统工具，若版本过旧可能导致 JSON 解析失败；aria2 RPC 模式需确保本地 6800 端口未被占用。
隐私风险：搜索查询通过 HTTPS 发送至 torrentclaw.com，虽加密传输但搜索关键词可能被记录用于分析；建议敏感内容使用 API key 认证以提升匿名性。
安全风险：magnet 链接直接传递给本地客户端，虽客户端会验证，但恶意构造的链接理论上可能导致客户端异常行为。