# Pt Mteam

> Access M-Team PT public API with x-api-key authentication for member/profile stats and torrent-related calls. Use when building scripts, bots, indexers, or automations that query M-Team data safely with rate limiting and allowed-endpoint guardrails.

- Skill: `kyledh/pt-mteam` (Agent Skill, multi-file: 3 files)
- Install (CLI): `npx skillmds@latest add kyledh/pt-mteam`
- Raw SKILL.md: https://api.skillmd.com/api/skills/kyledh/pt-mteam/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Integrations & APIs
- Author: kyledh (https://skillmd.com/u/kyledh)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/kyledh/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` 切换到备用域名。

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

搜索示例：

```bash
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`