5 分钟快速上手 torrent-cli：安装配置与第一个磁力搜索命令完整教程

5 分钟快速上手 torrent-cli：安装配置与第一个磁力搜索命令完整教程

【免费下载链接】torrent-cli🔨 磁力获取器命令行工具项目地址: https://gitcode.com/gh_mirrors/to/torrent-cli

torrent-cli是一款开源的「磁力获取器命令行工具」，让你告别浏览器里层层翻页找资源的麻烦，直接在终端输入关键词，几秒钟就能拿到一批磁力链接。本文是一篇面向新手的完整教程，从环境要求、安装配置到第一个磁力搜索命令，全程只需 5 分钟，零代码基础也能轻松上手。下面就开始吧！

1. torrent-cli 是什么？为什么用命令行搜索磁力？

很多人找影视、软件、学习资料时，习惯打开网页搜索，然后被广告、弹窗和各种无效链接折磨。torrent-cli的思路很干脆：写一个命令行工具，替你完成「爬取 → 解析 → 排序 → 输出」的全流程，你只需要输入关键词。

它的核心亮点有这些：

• ⚡一条命令出结果：输入torrent-cli 关键词即返回磁力链接、名称、大小、日期、热度
• 🖥️全平台兼容：Windows / Linux / macOS 都能跑
• 🧰参数灵活：可控制数量、排序方式、输出格式，甚至保存成文件
• 🐍Python 实现：核心逻辑集中在 torrent.py 一个文件里，逻辑清晰、依赖少

本质上，它就是一个磁力链接搜索爬虫工具，帮你自动完成「搜索 + 解析 + 筛选」三步操作。

2. 安装前的环境准备

torrent-cli 是纯 Python 工具，依赖很少。安装前确认两件事：

检查 Python 环境：

python --version pip --version

看到版本号输出就说明环境没问题 ✅

3. 最快安装方法：一行 pip 命令

3.1 pip 在线安装（推荐新手）

这是最快配置方法，一条命令搞定：

pip install torrent-cli

装完验证一下版本：

torrent-cli -v

能输出版本号（如VERSION 0.0.9），就说明安装成功。入口配置在 setup.py 中通过console_scripts定义，所以命令名就是torrent-cli。

3.2 源码安装方式

想自己折腾源码，可以先克隆仓库：

git clone https://gitcode.com/gh_mirrors/to/torrent-cli cd torrent-cli pip install -r requirements.txt python setup.py install

依赖只有 4 个，都在 requirements.txt 里：requests、beautifulsoup4、lxml、future。

4. 第一个磁力搜索命令：3 步跑通

安装完成后，打开终端（Windows 用 CMD 或 PowerShell），跟着做：

第 1 步：输入关键词搜索

torrent-cli 战狼2

第 2 步：等待爬取完成

终端会先显示Crawling data for you.....，表示正在抓取数据，稍等几秒。

第 3 步：查看结果

你会看到类似这样的输出：

磁链: magnet:?xt=urn:btih:80B24033541A8DE529876488E68DCD707B074990 名称: 战狼2.2017.tc720p.中英双字... 大小: 829.0 MB 日期: 2018-05-15 热度: 1

每条结果包含磁力链接、资源名称、文件大小、发布日期、热度五项信息，直接复制磁链:开头的链接到下载工具即可使用 🎉

默认返回 10 条结果，按日期从新到旧排序，完全够用了。

5. 进阶玩法：让磁力搜索更高效

5.1 空格匹配多关键字

关键词之间用空格分隔，可以组合搜索更精确的结果：

torrent-cli 钢铁侠 3

工具会匹配同时包含「钢铁侠」和「3」的资源，帮你过滤掉无关内容。

5.2 控制返回数量

用-n参数指定需要几条结果（最大 200）：

torrent-cli 战狼2 -n 20

5.3 按大小 / 热度排序

-s参数支持 3 种排序方式，非常实用：

比如想找最大的高清版本：

torrent-cli 战狼2 -s 1

5.4 单行紧凑输出

配合-p参数，每条结果只显示一行，方便批量复制：

torrent-cli 战狼2 -p -s 1

输出格式为：磁力链接 大小 日期

5.5 导出 CSV / JSON 文件

搜到一堆结果想保存下来慢慢挑？用-o参数导出（推荐 CSV 格式，Excel 直接打开）：

torrent-cli 战狼2 -o movie.csv

保存成功会提示Save successfully!，之后就能用表格工具整理了。JSON 输出也支持，导出逻辑可参考 torrent.py 中的_output函数。

6. 常用参数速查表

收藏这张表，随时查阅 👇

7. 常见问题与避坑提示

• ❓提示command not found：多半是 Python Scripts 目录没加进 PATH，重新安装或手动配置环境变量即可。
• ❓搜索不到结果：会提示Sorry, found nothing :(，试试更换关键词或减少关键字数量。
• ❓导出 JSON 乱码：项目文档建议优先导出 CSV，JSON 数据会被序列化为 UTF 编码，用 UTF-8 编码的编辑器打开即可。
• ⚠️合理使用：本工具仅用于学习与技术交流，请遵守相关法律法规，勿用于侵权用途。

8. 小结：你的第一条磁力搜索命令已跑通

从「安装配置」到「第一条磁力搜索命令」，整个过程真的只要 5 分钟。回顾一下关键路径：

1. pip install torrent-cli一键安装
2. torrent-cli 关键词完成第一次搜索
3. 用-s、-p、-o等参数组合出适合自己的玩法

现在，打开你的终端，输入第一个关键词试试吧！🚀

【免费下载链接】torrent-cli🔨 磁力获取器命令行工具项目地址: https://gitcode.com/gh_mirrors/to/torrent-cli