Pt Mteam

pt-mteam

使用 M-Team 的开放 API（x-api-key）进行安全调用，默认避免高风险/禁用接口。

1) 前置要求

• 已在 M-Team 控制台获取 Access Token（API Key）
• 通过请求头传递：x-api-key: <YOUR_TOKEN>
• API Base 建议优先：https://api.m-team.cc，可选备用：https://api.m-team.io
• 脚本默认附带 user-agent: Mozilla/5.0（降低被 Cloudflare 1010 风控拦截概率）

2) 快速调用（CLI）

脚本从环境变量 MTEAM_API_KEY 读取密钥（不要把密钥写进命令行参数）；--base 默认 https://api.m-team.cc，可用 MTEAM_API_BASE 或 --base 切换到备用域名。

export MTEAM_API_KEY=...
python3 scripts/mteam_api_probe.py --method POST --path /api/member/profile --json '{}'

搜索示例：

python3 scripts/mteam_api_probe.py \
  --method POST \
  --path /api/torrent/search \
  --json '{"keyword":"test","pageNumber":1,"pageSize":20}'

输出：第一行是 {"ok":..,"status":..,"elapsedMs":..} 元信息，第二行起是原始响应体。退出码：0 成功，1 请求失败，2 参数/护栏拦截，3 鉴权失败。限流状态存放在 ~/.cache/pt-mteam-rate.json（依赖 POSIX 文件锁，仅 macOS/Linux）。

3) 护栏（必须遵守）

• 不调用以下路径：
  • /admin/**
  • /login
  • /apikey/**
• 不用 cookie 模式伪装第三方工具，统一用 x-api-key
• 遇到 401/403：停止重试并提示用户检查 token/权限
• 实施限速：
  • 默认最小间隔 >= 1s/请求（脚本已实现跨进程限流）
  • /torrent/detail 默认 >= 36s/次
  • /torrent/search 默认 >= 90s/次（保守值，可通过参数调整）

4) 推荐实践

• 封装统一请求函数：
  • 注入 headers
  • 统一超时（10~20s）
  • 429/5xx 指数退避重试（含 jitter）
• 记录结构化日志（status、path、耗时、重试次数）
• 对外暴露“只读能力”为主（查询、统计、详情）

5) 参考资料

• 公开规则与限速摘要：references/public-api-notes.md