接入指南
在 Prowlarr 里把 TorrentClaw 添加为 Generic Torznab 索引器。
获取你的 API 密钥
在 TorrentClaw 创建免费账号,并在个人资料中生成 API 密钥。免费密钥可直接用于 Prowlarr、Sonarr 和 Radarr。
注册账号并获取 API 密钥 →添加到 Prowlarr
在 Prowlarr 中进入「索引器 → 添加 → Generic Torznab」,粘贴 URL 和你的 API 密钥。
Torznab URL
https://herecomesaconsequence.com/api/v1/torznab
API Key
登录后查看你的 API 密钥
API Path
留空即可(或用默认值)
常见错误 —— API Path
上面这个 Torznab URL 本身已经是完整地址。如果你的客户端(Prowlarr / AIOStreams / Jackett)单独有一个「API Path」栏,请留空。填成 /api 会让请求打到 /api/v1/torznab/api,返回 403 Forbidden。(我们也兼容这个路径作为兜底,但留空才是标准配置。)
菜单路径
Prowlarr → Indexers → + → Generic Torznab
添加 Custom Format(推荐)
每个应用导入一个 Custom Format 并给它一个适中的分数,即可优先选择经 TrueSpec 核验的资源。此步可选,但推荐。
适用于 Sonarr / Radarr 的 Custom Format
只需一个匹配索引器标记 Internal 的格式。TorrentClaw 只会给真实文件已被 TrueSpec 核验的资源打上该标记。
TrueSpec 已核验 · Sonarr
匹配索引器标记 Internal。
{
"name": "TrueSpec Verified",
"includeCustomFormatWhenRenaming": false,
"specifications": [
{
"name": "Internal",
"implementation": "IndexerFlagSpecification",
"negate": false,
"required": true,
"fields": {
"value": 8
}
}
]
}TrueSpec 已核验 · Radarr
匹配索引器标记 Internal。
{
"name": "TrueSpec Verified",
"includeCustomFormatWhenRenaming": false,
"specifications": [
{
"name": "Internal",
"implementation": "IndexerFlagSpecification",
"negate": false,
"required": true,
"fields": {
"value": 32
}
}
]
}建议分数:+100。这只是偏好,不是硬性规则。请在「设置 → Custom Formats」中导入,每个应用一个:Sonarr 和 Radarr 的标记编号不同。
为什么用标记而不是标题里的标签?
Sonarr 和 Radarr 是根据已导入文件自身的名称,以及下载时保存的索引器标记来打分的,从不使用索引器返回的标题。标题里的标签在搜索时算 +N,到了磁盘上却是 0,于是同一个资源会被反复下载。而标记在导入后依然保留。
实际分辨率低于名称所标注的资源默认不会出现在结果中。在 Torznab URL 后添加 &mismatch=1 即可包含它们。
已经导入过文件了?
在 TrueSpec 核验之前导入的文件没有该标记,因此搜索结果中已核验的资源仍可能把它们替换掉。请带 --backfill 运行一次此脚本,之后通过 cron 定期运行。TorrentClaw 只会收到 5 位字符的哈希前缀,绝不会收到你的媒体库。每次使用前请重新下载脚本:它会不断更新。对于数万个文件的媒体库,首次运行需要几分钟;免费密钥(每分钟 120 次请求)可能会自动暂停并重试。
curl -fsSL https://herecomesaconsequence.com/scripts/truespec-arr-sync.sh -o truespec-arr-sync.sh && chmod +x truespec-arr-sync.sh ./truespec-arr-sync.sh --tc-key TORRENTCLAW_KEY --sonarr https://sonarr:8989 --sonarr-key SONARR_KEY \ --radarr https://radarr:7878 --radarr-key RADARR_KEY --backfill --dry-run
上面的命令是预览(--dry-run):只显示将会更改的内容,不会写入任何东西。如果输出无误,请去掉 --dry-run 再运行一次。如果以 HTTP 401/403 中止,请检查你的 TorrentClaw 密钥;失败时不会更改任何内容。
请按此顺序操作
- 删除旧的基于正则的 TrueSpec Custom Formats([TrueSpec Verified]、[TrueSpec-9x]、[TrueSpec Mismatch])。标题里不再带这些标签。
- 带 --dry-run 运行同步脚本并检查输出,然后去掉 --dry-run 再运行一次(保留 --backfill)。
- 导入你所用应用对应的 Custom Format 并设置分数。
- Sonarr 4.0.x:如果期间它重新下载了内容,请重启 Sonarr。它会缓存已导入的哈希,直到重启为止。
