> For the complete documentation index, see [llms.txt](https://wiki1.yemapt.org/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://wiki1.yemapt.org/torrent/torznab.md).

# Torznab对接

Torznab是一套通用的种子索引接口规范。YemaPT提供了原生Torznab接口，可用于Prowlarr、cross-seed及其他兼容Torznab的软件。

## 准备AuthKey

1. 登录[YemaPT](https://www.yemapt.org/)。
2. 进入个人详情页，创建“第三方对接专用AuthKey”。
3. 复制生成的AuthKey，并妥善保管。

AuthKey有效期为180天，每个用户最多同时保留3个有效AuthKey。删除AuthKey后，对应的Torznab配置会立即失效。请勿将AuthKey发布到截图、日志或公开代码中。

## 接口信息

| 配置项        | 内容                                           |
| ---------- | -------------------------------------------- |
| 网站地址       | `https://www.yemapt.org/`                    |
| API路径      | `/openApi/torznab/api`                       |
| 完整接口地址     | `https://www.yemapt.org/openApi/torznab/api` |
| API Key    | 个人详情页生成的AuthKey                              |
| API Key参数名 | `apikey`                                     |

如果软件将“网站地址”和“API路径”分开填写，请分别使用上表中的内容；如果软件只提供一个Torznab URL输入框，请填写完整接口地址。API Key字段直接填写AuthKey，不要添加`Bearer`等前缀。

## Prowlarr对接

1. 打开Prowlarr的“Indexers”页面，点击“Add Indexer”。
2. 搜索并选择“Generic Torznab”。
3. 名称可填写`YemaPT`。
4. URL填写`https://www.yemapt.org/`。
5. API Path填写`/openApi/torznab/api`。如果当前版本没有单独的API Path输入框，则使用完整接口地址。
6. API Key填写个人详情页生成的AuthKey。
7. 点击“Test”，测试成功后保存。

YemaPT已经直接提供Torznab接口，因此不需要再通过Jackett转换。其他支持自定义Torznab源的软件，也可以使用相同的完整接口地址和AuthKey进行对接。

## 使用cross-seed辅种

[cross-seed](https://github.com/cross-seed/cross-seed)是一款开源的自动辅种软件，可以根据下载器中已有的种子和数据，通过Torznab查找可辅种资源。

在cross-seed的`config.js`中，可以将YemaPT原生Torznab地址加入`torznab`配置：

```javascript
torznab: [
    "https://www.yemapt.org/openApi/torznab/api?apikey=你的AuthKey",
],
```

配置文件中包含AuthKey，请限制文件访问权限，不要上传到公开仓库。cross-seed的安装、下载器连接、目录映射及辅种模式请参考其[官方文档](https://www.cross-seed.org/docs/basics/getting-started)。不同版本的cross-seed对索引能力的判断可能不同；YemaPT目前只声明通用搜索能力，未声明分类、电影搜索和剧集搜索能力。

## 当前支持能力

* 获取最新发布的种子。
* 使用关键词`q`搜索。
* 使用`imdbid`或`tmdbid`搜索。
* 使用`limit`和`offset`分页，每页默认50条，最多100条。
* 返回种子大小、文件数、做种数、下载数、InfoHash、IMDb ID、TMDb ID及上传/下载系数等Torznab扩展属性。
* 下载链接使用短期签名令牌，获取后请及时交给下载器。

目前不支持分类筛选，也不支持Torznab的`movie`、`tvsearch`专用搜索类型。部分依赖分类或专用搜索类型的软件可能无法使用全部功能。

## 限流与常见问题

每个用户每天最多请求5000次。达到限制后，接口会返回HTTP 429，并通过`Retry-After`响应头告知建议等待时间。请勿设置过短的轮询间隔。

| 现象       | 排查方法                                  |
| -------- | ------------------------------------- |
| HTTP 401 | 检查AuthKey是否填写正确、是否过期或已在个人详情页删除        |
| HTTP 429 | 已达到当日请求上限，请按照`Retry-After`等待后重试       |
| 搜索结果为空   | 检查关键词、IMDb ID或TMDb ID是否正确，并确认站内存在对应资源 |
| 无法下载种子   | 下载链接为短期签名链接，请重新搜索并及时提交给下载器            |
