treg — 你的代理的工具目录
**要求任务，而不是工具。**当需要外部或实时数据时 — 外链、关键词量、TikTok 资料、工作邮箱、竞争对手广告创意 — 搜索目录，阅读价格，调用它。
两种工具通过同一个代理，使用相同的令牌进行响应，该代理在服务端注入凭据，因此你永远不需要持有它：
- 目录 — treg 可以为你调用的精心策划的外部端点。
- 你自己的工具 — 团队成员注册并与该组织共享的内容：API 账户、OAuth 连接、技能。 注意：通过 treg 应用创建的 X（Twitter）连接按调用计费（X 按使用向应用所有者收费）；响应会报告价格。团队自己的 X 开发者应用不计费。
工作方式：
- 端点：
https://treg.to· CLI：treg· CLI 是 API 的轻量客户端。 - 认证： 每次调用发送
X-Treg-Token: <你的令牌>。 - 工具 = 上游 base URL + 凭据绑定。技能/包 = 配方 (SKILL.md) + 其秘密 + 其工具。代理中继，从不模型化上游。
首先：安装 + 登录
curl -fsSL https://treg.to/install.sh | sh # 安装 CLI 并将其指向此处
treg login # 浏览器登录（GitHub / Google / 邮箱验证码）— 首次登录注册你
treg login --email [email protected] # 仅终端替代方案（通过邮件发送 6 位验证码）
treg login --token <per-org-token> # 非交互式（代理/CI）
所有操作都在你的活动组织中运行（首次登录会创建一个个人组织）。团队邀请通过电子邮件发送 — 使用 treg invites 查看，使用 treg accept 接受（或 treg org join <code>）。切换团队：treg org switch <slug>。
已通过 MCP 连接？那么你拥有工具，而不是 CLI
如果你通过 https://treg.to/mcp/ 访问 treg — ChatGPT、Claude Code、Cursor — 上面的 CLI 步骤不适用于你。你拥有五个工具：catalog_search、catalog_get、call、balance、my_tools。本文档中的所有内容都映射到它们：
- "搜索目录" →
catalog_search，然后使用catalog_get获取确切的价格和参数 - "调用它" → 使用端点 ID 调用
call，或对团队自己的工具之一使用<tool-name>/<path> - "检查余额" →
balance
无论是哪种方式，以下规则都是相同的。最重要的一条 — 在花费之前说出价格 — 在这里更重要，因为 call 会返回 cost_usd，你可以报告实际花费而不是估计。
对目录端点的 call 会消耗团队的余额。对团队自己工具的 call 不消耗任何东西：该密钥属于他们。
任务 — 目录：treg 能为你做什么（从这里开始）
约 2,800 个目录端点，涵盖约 56 个提供商，按功能分组：关键词与排名跟踪、外链与权威性、AI 可见性、趋势与发现、发布到团队自己的社交媒体账户、人物与公司信息丰富、广告管理与创意、测量。
treg catalog search "subreddit 帖子" # 通过功能查找端点
treg catalog get scrapecreators.reddit.subreddit.posts # 参数、价格、你将如何被服务
treg call scrapecreators.reddit.subreddit.posts --query subreddit=news
treg balance # 预付费余额 + 最近费用
treg catalog request "<你需要的>" # 搜索不到？提交请求 — 指导接下来添加什么
注意：
- 每个端点的价格都在
treg catalog get中，在你调用它之前。 - HTTP 402 = 余额不足，带有机器可操作的主体（
balance_micro、estimated_cost_micro、topup_url）。恢复：treg balance→ 在仪表板中充值（团队 → 计费）→ 或存储该提供商的组织的自己的密钥（自己的密钥永远不会计入余额 — 它们会自动优先）。 - 该提供商的某个组织工具或密钥总是优先于 treg 的密钥，自动地 — 目录是后备方案，而不是替代团队已有的密钥。
- 在具有相同能力的提供商之间进行选择 — 步骤。
treg catalog get <id>列出每个提供相同任务的提供商，包含COST、WORKS（treg 观察到的成功率，带有样本量）、SPEED（中位数）和LAST OK。按此顺序工作：- 匹配你实际拥有的输入。 当你只有姓名和域名时，需要
profile_url的端点无论价格如何都不能替代。这条规则始终优先于价格。 - 然后是可靠性：具有真实样本的高
WORKS值优于具有小样本的整数 —99% (121)比100% (8)更有力。 - 然后是价格。同一能力内的价差可达 200 倍，因此这通常是花钱的地方。
LAST OK打破平局。裸年龄意味着真实调用返回；✓年龄是目录自己的验证标记，不是实时流量；—意味着没有人验证过它，也没有人调用过它 — 优先选择几乎任何其他内容。
- 如果调用因 429 / 5xx / 超时而失败，请尝试下一个提供商。 你知道其参数，因此你可以构建其请求。说明你切换到了哪个。
- 永远不要在其他地方重试 4xx。 4xx 通常是你的参数问题；修复它们是解决方案，重试会在一个错误上浪费团队的资金在 N 个提供商上。
- treg 不会为你选择或自动故障转移。这是故意的：只有你知道你拥有哪些输入，并且 treg 中继而不是重写你的请求。
- 匹配你实际拥有的输入。 当你只有姓名和域名时，需要
- 没有发布价格的端点会被拒绝而不是免费提供；请连接你自己的密钥。
重试调用而不重复付费
如果调用超时或你从未看到其答案，请使用相同的 idempotency_key（通过 MCP）或 Idempotency-Key 标头（通过 HTTP）重复它。treg 返回存储的答案，不会再次调用提供商，并且不收取任何费用。结果会显示 replayed: true。
仅用于真正的重试。重复询问相同问题以查看发生了什么变化是新工作：使用新密钥或不使用密钥，否则你将得到旧答案。为不同的请求重复使用同一个密钥会被拒绝。
大多数重试不需要这个 — 失败的调用从未被计费。
任务 — 你自己的工具：调用团队注册的一个
从已注册的内容开始，然后完全按照其自身文档使用 API。 没有 treg 词汇，没有特殊参数：
treg tool ls # 该团队注册了什么
treg call intercom conversations?per_page=5 # <工具名> + 上游路径
通过 HTTP 即 GET https://treg.to/call/<tool-name>/<path>，并带有 X-Treg-Token: <你的令牌>。treg 查找命名工具，服务端注入该团队的凭据，并忠实中继所有内容（方法、查询参数、你的标头、主体）。你的 X-Treg-Token 在上游看到之前会被剥离。支持 GET/POST/PUT/PATCH/DELETE。
只有该组织已注册的工具才能解析。使用 treg tool ls · treg skill ls 发现它们。
任务 — 分享你的密钥和技能，以便团队成员的代理可以使用它们
批量（快速路径）： 在人类命名的目录中运行它。它会列出在该 .env 中识别的提供商密钥以及其子目录中的技能，并且仅注册用户勾选的项：
treg upload # 当前工作目录的两侧；`treg upload env|skills --dir <d>` 以限制范围
默认：将新密钥包装在技能中。 注册新密钥/端点/CLI 时，将其与技能配对，以便凭据、工具和配方一起落地（并且它会获得一个可共享的页面）。如果技能不存在，请创建一个基本技能 — 一个合适的 SKILL.md（frontmatter 很重要：代理通过它发现技能）+ 一个示例调用：
mkdir -p ./posthog && cat > ./posthog/SKILL.md <<'MD'
---
name: posthog
description: 通过 treg 查询 PostHog 分析 API — 密钥在服务端注入。用于事件、洞察和项目查询。
---
调用它：`treg call posthog api/projects/@current` (upstream: https://us.posthog.com)
MD
treg skill init --dir ./posthog # 草拟 treg.json：base_url 来自目录（文件夹名）或 SKILL.md 中的 URL；检查它并添加密钥
treg skill add --dir ./posthog # 原子地注册配方 + 秘密 + 工具
永远不要孤立秘密： 存储的密钥如果没有绑定就是死重 — 如果你直接使用 secret add，请在同一操作中将其绑定到工具（端点/CLI）。
裸端点，无配方（仅当技能无用时）：
treg secret add posthog-key --value "$POSTHOG_API_KEY" # 或 --file ./.secret/token.json
treg tool add posthog --base-url https://us.posthog.com --secret posthog-key
# 查询密钥 API 而不是 bearer 标头：
treg tool add serpapi --base-url https://serpapi.com --secret <name-or-id> \
--auth-in query --auth-name api_key --auth-format '{secret}'
整个技能（配方 + 秘密 + 工具，可能多凭据）：
treg skill scaffold ~/.claude/skills/google-ads --out gads.json
# -> 遍历目录：捕获 SKILL.md 作为配方 + 每个 .secret/* 作为秘密。
# -> 然后你编辑 gads.json：设置 base_url，并完成每个绑定（位置/名称/格式）。
# 例如 google-ads 需要在一个请求上进行两次绑定：
# Authorization: Bearer {access_token} (注入器：oauth)
# developer-token: {secret} (注入器：env)
treg skill push gads.json # 原子地注册捆绑包
在组织内部共享它：将端点 + 工具名称提供给团队成员，他们的代理可以调用它而无需持有凭据 — 你授予了访问权限，treg 注入秘密，并且调用会记录在他们的令牌下。
认证形状（每个绑定 injector，= 秘密的 kind）：env（纯字符串）· secret_file（JSON 令牌文件，提取 secret_field）· oauth（JSON 令牌，自动刷新）· cli_auth（人类从他们已经登录的 CLI 中复制并自己提供给 treg 的令牌）。多个绑定适用于每个请求。
OAuth，两种模式（treg 保持其新鲜）： 如果 oauth 秘密带有 refresh_token + client_id + client_secret，treg 会在其过期前自动刷新它（你永远不需要重新上传）。如果只是一个裸令牌，那就是手动模式，treg 按原样注入它，你需要在它过期时重新上传。相同的存储；凭据可以从手动升级到自动，无需迁移。
获取第一个 OAuth 令牌，两种方式（你选择）：
- 手动： 在你本地执行自己的 OAuth，然后
treg secret add gsc --file token.json --kind oauth。 - 托管连接：
treg oauth connect gsc --client-secret client_secret.json --scopes <scope>→ 打印同意 URL；你在浏览器中批准；treg 直接捕获令牌。一次性设置：将https://treg.to/oauth/callback添加到你的 OAuth 应用的重定向 URI 中。
任务 — 管理团队 + 监控
treg tool ls / secret ls / skill ls / calls # 库存 + 审计日志 — 限定于活动组织
treg tool rm <id> / secret rm <id> / skill rm <id> # 当工具绑定时，secret rm 会被阻止
treg health # 该组织中每个凭据的状态 (ok | invalid | unknown)
treg health --run # 立即重新检查：刷新 oauth 令牌，探测每个工具，提醒所有者
团队 / 组织（所有者 > 管理员 > 成员 > 查看者；成员仅管理他们创建的内容）：
treg org create "团队 A" # 你成为所有者（自动激活）
treg org invite [email protected] --role member # 管理员+；通过电子邮件发送邀请（一次性代码是后备方案）
treg org members # 管理员+；谁在活动组织中
treg org ls / treg org switch <slug> # 你的组织 / 切换活动组织
给代理自己的身份（管理员+）。代理不必借用人类的令牌 — 为其创建一个令牌，它进行的每次调用都会被限制、限定范围并记录为其自身：
treg org agent-new ci-bot # 仅打印一次令牌（再次运行以轮换）
treg org agent-new ci-bot --tools stripe,gh --cap 500 # 仅这些工具，每天 500 次调用
treg org agents # 团队中的代理是谁 + 今日使用量
treg org agent-rm <user_id> # 立即撤销
将该令牌放入代理的 TREG_TOKEN 环境变量中。代理令牌可以调用此团队的工具和读取 — 它永远不能登录、创建团队或成为所有者。如果你是一个代理并且你被授予了自己的令牌，请使用它而不是机器所有者的：那么你的工作将显示在 treg calls 中你自己的名称下。
被邀请者使用被邀请的电子邮件登录并运行 treg accept — 无需处理代码（代码路径仍然有效：treg org join <code>）。全新的被邀请者还会获得他们自己的个人组织（没有空状态），因此从团队中移除他们永远不会将他们锁在外面。给工具一个探针以便 treg 可以验证它：health_check: {method, path, expect_status}（例如 intercom {"path":"me"}）。
规则
- 秘密是只写的 — API 永远不会返回存储的值，无论是给你还是给任何人。
- 工具可以绑定团队成员与此组织共享的秘密（使用而不持有）— 这就是重点：他们选择共享它，它限定于该组织，你可以在不看到它的情况下使用它，并且每次调用都归因于发起调用的令牌。这是团队内部的委派访问，绝不是访问没有人授予你的凭据。
- 所有内容都限定于你的活动组织。 一个令牌只能访问该团队的工具，不能访问其他人的。
- 代理不理解上游；如果调用失败，你看到的状态是上游的真实状态。
- 更多信息：
https://treg.to/llms.txt（代理入门）·https://treg.to/tutorial（交互式演练）。