superdesigndev/treg 来源：https://github.com/superdesigndev/treg

Treg（工具的OpenRouter）

treg — 你的代理的工具目录 OpenRouter，但针对的是代理工具而非模型。 将代理指向一个基础 URL 和一个令牌，它就能完成工作：60 多个提供商的 3000 多个已编目端点 — SEO 和反向链接、社交和趋势、人员和公司信息增强、广告、抓取、图像和视频生成 — 按次计费，起价一分钱，无需注册提供商账户。加上你自己团队的密钥、技能和 CLI，每个队友的代理都可以调用，而凭证永远不会离开服务器。请求任务，而不是工具。 你不需要知道哪家供应商销售反向链接数据，也不需要在那里拥有账户。搜索你想做的事情，查看价格，调用它。

为 Superdesign 团队打造，上线于 treg.to (https://treg.to) — 任何人都可以自托管。

为何存在

代理完成实际工作所需的工具，往往位于那些不会为了单次运行而购买的订阅服务之后 — Semrush 139 美元/月、Moz 99 美元/月、Crunchbase 99 美元/月、Apollo 59 美元/席位 — 它们隐藏在注册墙之后，或者根本没有公开 API（仅限邀请、仅限合作伙伴、仅限应用审核）。treg 托管这些账户，并按每次调用收取几分之一美分的费用。

两种工具，一个令牌

• 目录 — treg 可以用自己的密钥或通过无需提供商密钥的验证公共路由提供的外部端点。自有密钥调用使用团队的预付余额；匿名调用是免费的。无需在提供商处拥有账户。新验证的团队在创建符合条件的团队时，可获得 $1.00 免费额度。
• 你自己的工具 — 任何队友注册的内容：付费 API 账户、OAuth 连接、供应商 CLI、一个 SKILL.md。你自己的密钥总是优先于 treg 的密钥，并且这些调用永远不会被计量。

第二部分的术语：

• 工具 = 注册表使用组织凭证为你调用的东西。两种类型：
  • 端点 — 上游 base_url + 凭证绑定（每个绑定将一个密钥注入请求；一个请求可以携带多个，例如一个 OAuth Bearer 令牌 和 一个 developer-token 头）。
  • CLI — 使用注入凭证运行的供应商二进制文件（stripe、gh、vercel…）。
• 技能 / 包 = 一个配方（SKILL.md）+ 其密钥 + 其工具，一起注册。

唯一规则： 代理转发，从不建模上游，并且在服务器端注入认证 — 因此它能适应上游 API 的更改，并且调用者永远不会持有密钥。

第 1 部分 · 使用注册表

访问 treg.to (https://treg.to)（托管在 Render 上）— 仪表盘、登录以及下面的所有 URL 都在那里。

快速开始

与仪表盘的 入门 指南流程相同：

# 1. 安装 CLI — 同时将其指向注册表
curl -fsSL https://treg.to/install.sh | sh

# 2. 登录（默认 GitHub · 使用 --email 获取一次性代码 · 使用 --token 用于代理/CI）
treg login

# 3. 立即执行一些有用的操作 — 无需密钥，无需注册任何内容
treg catalog search "backlinks for a domain"  # 按功能查找工具
treg call tikhub.tiktok.user.profile --query uniqueId=tiktok
treg balance  # 这花费了多少
# （或者使用 `treg onboard` 进行引导式演练）

目录工具输入由 treg catalog get <TOOL_ID> 描述。标记为 strict_query 的工具会拒绝未声明或重复的查询参数、不支持的值和请求体。你的令牌在每次调用时标识你（X-Treg-Token 头），并且对所有工具都是相同的。发现你的团队分享了什么：treg tool ls · 检查凭证健康状况：treg health。

或将其安装为 Claude Code 插件

/plugin marketplace add superdesigndev/treg
/plugin install treg@treg

无需令牌和配置即可安装。技能加载为 treg:treg，并在首次运行时引导你的代理完成其余部分 — CLI、登录，然后 treg mcp install — 这样你最终拥有命令行和 treg 的工具。

其他代理：npx skills add superdesigndev/treg -s treg（-s 很重要 — 没有它，你还会获得此仓库的内部开发技能）。参见 docs/CLAUDE-PLUGIN.md。

MiniMax Code / MiniMax Agent 用户：相同的技能通过 MiniMax 插件市场提供（docs/MINIMAX-PLUGIN.md）。

Claude.ai 连接器

Claude 连接器目录的表面是 https://treg.to/mcp/v2/。它仅公开精选的目录端点，并将读取调用与写入调用分开，以便 Claude 接收到准确的安全信号。现有的 /mcp/ 表面仍然可用于目录端点、团队拥有的工具和导入的技能。有关边界和实现的详细信息，请参阅 MCP 和 OAuth 架构；有关发布门控的详细信息，请参阅 提交手册。

调用你没有密钥的工具

目录按端点的功能分组：关键词和排名跟踪、反向链接和权威性、AI 可见性、趋势和发现、社交发布、人员和公司信息增强、广告管理和创意、衡量。

treg catalog # 所有平台，按最繁忙排序
treg catalog search "find a work email" # 按功能，而非供应商查找
treg catalog get hunter.people.email.find # 参数、价格、示例响应
treg call hunter.people.email.find --query domain=reddit.com --query full_name="Alexis Ohanian"

目录调用如何被服务 — 凭证阶梯，按顺序：

1. 你的团队为该提供商注册了自己的工具 → 使用该工具，该密钥；
2. 你的团队为该提供商存储了一个密钥 → 通过虚拟工具注入；
3. 都没有，并且端点有一个经过验证的公共路由 → 无需提供商密钥，免费；
4. 否则 → 使用 treg 自己的密钥，向团队的预付余额计费。

匿名价格假设调用者不发送提供商凭证头。忠实的中继保留调用者头，因此调用者提供的提供商密钥可以使用该密钥的信用额度。你自己的凭证总是优于 treg 的密钥，因此连接你已经付费的密钥会使这些调用免费使用余额，而不是重复计费。treg 没有公布价格的端点会被拒绝，而不是免费服务 — 你会被告知改用自己的密钥。

当多个提供商提供一项功能时，treg catalog search 会并排显示它们及价格；选择权在你 — treg 不会为你静默选择或在提供商之间故障转移。（当 treg 的某个提供商账户用尽时，它可能会通过 treg 拥有的中继账户提供相同的端点，并在响应中披露；团队可以选择退出。）

你可以选择加入的例外情况：treg. 路由的端点，其中 treg 为你选择提供商并命名。

treg balance # 剩余信用、正在进行的调用、最近花费
treg topup # 添加资金，或设置自动充值

余额不足是一个 HTTP 402 响应，包含 balance_micro、estimated_cost_micro 和 topup_url，以便代理无需阅读文本即可采取行动。

信息增强竞技场 位于 /enrich-arena，在仪表盘之外。比较每个供应商的成本和速度，一键投票选出最佳答案，或观看顺序瀑布式流程。浏览是公开的；提交需要登录，计费尝试使用你的团队信用额度。参见 竞技场指南。

分享和使用你自己的工具

零思考路径 — 将 treg 指向一个项目，它会弄清楚什么可以共享：

treg scan # 只读预览：上传将注册的密钥、技能和 CLI
treg upload # 注册它们（服务器端加密）；幂等操作，使用 --replace 更新

treg upload 扫描 .env（将密钥与约 80 个已知提供商匹配）、每个技能子目录和已安装的目录 CLI。三种东西进入注册表 — 以下是分享和使用每种类型的方法：

1. 端点（HTTP API）

分享 — 一个可以使用存储密钥调用的上游 URL，或从 .env 批量导入：

treg secret add STRIPE_KEY --value sk_live_123
treg add stripe --base-url https://api.stripe.com --secret STRIPE_KEY
treg upload env --select openai,stripe,resend # 或直接从 .env

使用 — 代理原生方式：构建真实的上游请求并加上代理前缀。treg 通过主机解析工具，注入凭证，并忠实地转发所有其他内容（你的 X-Treg-Token 在上游看到之前会被剥离）：

真实请求：GET https://api.intercom.io/conversations?per_page=5
通过 treg：GET https://treg.to/call/https://api.intercom.io/conversations?per_page=5
header: X-Treg-Token: <你的令牌>

或者 CLI 简写 — 并使用 treg calls 查看审计日志：

treg call intercom conversations --query per_page=5
treg call stripe v1/balance

2. CLI

分享 — 自动完成：treg upload 检测已安装的目录 CLI（stripe、gh、vercel…）并注册它们；纯配方的目录 CLI 技能（例如 stripe-cli）也会自动变为可运行的。 使用 — treg run 执行供应商 CLI 并注入组织的凭证，因此你永远不需要持有密钥或登录：

treg run stripe -- get /v1/balance
treg run gh -- pr list
treg run --server agentmail-cli inboxes list # 在注册表服务器上运行：密钥永远不会到达你这里

--local（默认）在你的机器上运行；--server 在注册表上运行并将输出流回。对于整个会话，treg shell start 打开一个子 shell，其中每个注册的 CLI 都会自动注入 — 只需像往常一样使用 stripe、gh…；exit 可恢复。treg runs 是审计日志。

3. 技能

分享 — 一个技能是一项完整的能力（SKILL.md 配方 + 其密钥 + 其工具），一起注册，以便整个团队运行相同的技能，并在一个地方维护：

treg upload skills --dir ~/.claude/skills --all # 一次性注册一个文件夹中的所有技能

使用 — 将任何共享技能拉入你的代理；其 API 调用通过 treg 使用你的令牌进行，因此密钥留在服务器上，永远不在技能中：

treg skill install seo-blog-writer # 写入 ./.claude/skills/（使用 --all 安装整个库）

手动注册 — 当启发式方法无法弄清楚一个工具时

# 多凭证工具（例如 google-ads：OAuth Bearer 令牌 + developer-token 头）
treg tool add google-ads --base-url https://googleads.googleapis.com \
  --bind "secret=OAUTH_TOKEN,injector=oauth" \
  --bind "secret=DEV_TOKEN,name=developer-token,format={secret}"

# 一个技能，逐步操作
treg skill init --dir ./my-skill # 起草 treg.json（猜测 base_url，查找密钥）
treg skill add --dir ./my-skill # 原子性地注册配方 + 密钥 + 工具

# 通过浏览器进行 OAuth（铸造第一个令牌，treg 持有它并自动刷新）
treg oauth connect gsc --client-secret client_secret.json \
  --scopes https://www.googleapis.com/auth/webmasters.readonly

每个命令的完整选项：USAGE.md。CLI 在使用 treg.to 时将匿名命令使用情况发送到 PostHog（不包含参数或凭证）。使用 TREG_TELEMETRY=0 或 DO_NOT_TRACK=1 禁用。参见 分析详情。

团队

一个账户最多可以拥有 10 个团队。作为成员加入其他团队不计入此限制。所有内容都限定在组织范围内：一个令牌 = 一个 (user, org) 成员资格，每个密钥、工具和技能都属于活跃的组织。

角色：所有者 / 管理员 / 成员 / 查看者。

treg org create "Acme" # 创建一个团队，成为所有者
treg org invite [email protected] # 通过电子邮件邀请（选择角色 + 工具访问权限）
treg org join --email [email protected] # 接受邀请（如果是新用户则创建）
treg org ls | use | members # 切换组织，查看成员名单
treg org access --tools a,b # 按成员设置工具访问权限（管理员及以上）

深入了解

• 反馈： treg feedback submit friction "分页示例不清楚。" 分享问题或建议，无需私人信息。参阅反馈说明 (https://treg.to/feedback.md)。
• 评价： treg review CALL_ID useful 在使用目录调用结果后进行评分；not_sure 也可以。省略私人数据并继续任务。
• USAGE.md — 完整的 treg CLI 参考。
• /llms.txt (https://treg.to/llms.txt) — 代理入门文件：调用协议、发现、认证、CLI、技能。一次获取即可让代理了解整个注册表。
• 仪表盘 位于 treg.to (https://treg.to) — 完整的 CRUD、引导教程（帮助 → 教程）以及可复制的代理设置说明。
• API — CLI 所做的一切都是普通的 HTTP；交互式 OpenAPI 文档位于 /docs。代理端点是 /call/{...}；所有端点都接受 X-Treg-Token 头。

第 2 部分 · 自托管与开发

在本地运行

一条命令（需要 tmux + uv (https://docs.astral.sh/uv/)；它会同步虚拟环境本身）：

scripts/dev-local.sh up # 服务器运行在 http://localhost:18790，开发安全设置

这会在 tmux 中运行服务器，支持热重载、独立的 sqlite 数据库（treg-dev.db）和电子邮件 OTP 开发模式（登录代码显示在页面上 — 无需邮件发送器）。

日常操作：

scripts/dev-local.sh cli login # 沙盒化的 CLI：永远不会接触你真实的 ~/.treg/config.json
scripts/dev-local.sh logs # 服务器输出 · 状态 / 重启 / 停止
scripts/dev-local.sh reset # 清除开发数据库 + CLI 沙盒，以全新开始

或者直接运行服务器，无需 tmux：

uv sync # 从 uv.lock 创建虚拟环境（拉取开发所需的服务器依赖）
uv run python -m treg upgrade # 准备架构并运行幂等的发布任务（不提供服务）
uv run python -m treg # 在 0.0.0.0:18790 上提供服务（添加 --reload 用于开发）
uv run python -m treg keygen # 打印一个新的 Fernet 密钥，用于 TREG_SECRET_KEY

安装以运行服务器（非从源码）： 基础包仅包含 CLI。要运行注册表，请安装服务器附加组件 — pip install "tools-registry[server]" — 这将添加 FastAPI、数据库驱动程序和加密功能。单独 pip install tools-registry 仅提供用于与现有注册表通信的 treg 命令。官方托管服务位于 treg.to。其生产拓扑结构和实时设置维护在私有操作手册中 (https://github.com/superdesigndev/treg-internal/blob/main/docs/production/deploy.md)。

配置

环境变量（前缀 TREG_，从 .env 读取）：