SuperAPI AI 工具集

qbittorrent

通用与其它

查看项目

更新于 10-15 23:33

技能介绍

用途:该技能通过 qBittorrent WebUI API(v4.1+)对 qBittorrent 客户端进行读写操作,适合列出种子、添加种子、暂停或恢复、删除、查看详情与调整限速等日常管理场景。

主要能力:监控活动、做种与已完成种子;按磁力链接、URL 或 .torrent 文件添加;控制种子状态(暂停、恢复、删除,可选择同时删除文件);管理分类与标签;设置全局与单种子限速;查看种子文件、追踪器与属性;重新校验数据完整性。

使用方式:先在 ~/.claude-homelab/.env 配置 QBITTORRENT_URL、QBITTORRENT_USERNAME、QBITTORRENT_PASSWORD,并执行 chmod 600 ~/.claude-homelab/.env。随后调用脚本,例如 ./scripts/qbit-api.sh list、list --filter downloading、list --category movies、info <hash>、files <hash>、trackers <hash>、add "magnet:?xt=..." --category movies、add-file /path/to/file.torrent --paused、pause/resume/delete/recheck <hash>(delete 可加 --files)、categories、tags、set-category、add-tags、transfer、speedlimit、set-speedlimit --down 5M --up 1M、version、preferences。Agent 调用脚本时须使用 pty: true,否则输出可能不可见。

限制:需要能访问 qBittorrent 服务器的网络;接口基于 WebUI API v4.1+;所有数据操作返回 JSON;带 --files 的删除为永久操作,执行前应确认;限速单位支持 K、M 或原始字节;磁力链接与种子 URL 不经过本地上传;分类需预先存在才能分配。