superdesigndev / treg

Treg (OpenRouter for Tools) Treg (OpenRouter for Tools) 是一个面向智能体（Agent）工具而非模型的 OpenRouter。只需一个基础 URL 和一个令牌（Token），智能体即可完成任务：它拥有超过 60 个提供商的 3,000 多个编目端点，涵盖 SEO 和反向链接、社交与趋势、人员与公司信息丰富、广告、抓取、图像和视频生成等功能。按调用次数计费，低至一美分，且无需注册任何提供商账号。此外，你还可以使用团队自己的密钥、技能和 CLI，所有团队成员的智能体均可调用，而凭据永远不会离开服务器。

Ask for the task, not the tool. You do not need to know which vendor sells backlink data, or to hold an account with them. Search for what you want to do, read the price, call it. Built for the Superdesign team, live at treg.to — anyone can self-host.

只管提出任务，无需关心工具。 你不需要知道哪个供应商出售反向链接数据，也不需要拥有他们的账户。只需搜索你想做的事情，查看价格，然后调用即可。该项目由 Superdesign 团队开发，现已上线 treg.to，任何人都可以自行托管。

Why it exists The tools an agent needs for real work sit behind subscriptions nobody buys for a single run — Semrush $139/mo, Moz $99/mo, Crunchbase $99/mo, Apollo $59/seat — behind signup walls, or behind no public API at all (invite-only, partner-only, app-review-only). treg carries those accounts and bills fractions of a cent per call.

存在的原因 智能体进行实际工作所需的工具往往被高昂的订阅费阻挡，没人会为了单次运行去购买这些服务——Semrush 每月 139 美元、Moz 每月 99 美元、Crunchbase 每月 99 美元、Apollo 每个席位 59 美元——有些工具还设置了注册门槛，或者根本没有公开 API（仅限邀请、仅限合作伙伴或仅限应用审核）。Treg 维护了这些账户，并按单次调用仅几分之一美分的价格进行计费。

Two kinds of tool, one token The catalog — external endpoints treg can serve with its own key or through a verified public route that needs no provider key. Own-key calls use the team’s prepaid balance; anonymous calls are free. No account with the provider is needed. New verified accounts receive $1.00 free once, when they create an eligible team.

两种工具，一个令牌 目录（Catalog）——外部端点，Treg 可以使用自己的密钥或通过无需提供商密钥的验证公共路由来提供服务。使用自有密钥的调用会消耗团队的预付余额；匿名调用则是免费的。无需拥有提供商账户。新验证账户在创建符合条件的团队后，可获得 1.00 美元的免费额度。

Your own tools Anything a teammate registered: a paid API account, an OAuth connection, a vendor CLI, a SKILL.md. Your own key always wins over treg’s, and those calls are never metered.

你自己的工具 任何团队成员注册的内容：付费 API 账户、OAuth 连接、供应商 CLI 或 SKILL.md。你自己的密钥优先级永远高于 Treg 的密钥，且这些调用从不计费。

The vocabulary for the second half: tool = something the registry calls for you with the org’s credential. Two kinds:

endpoint — an upstream base_url + credential bindings (each binding injects one secret into the request; a request can carry several, e.g. an OAuth bearer and a developer-token header).
CLI — a vendor binary (stripe, gh, vercel, …) run with the credential injected.
skill / bundle = a recipe (SKILL.md) + its secrets + its tool(s), registered together.

后半部分的术语表： 工具（tool）= 注册中心使用组织凭据为你调用的内容。分为两种：

端点（endpoint） — 上游 base_url + 凭据绑定（每个绑定将一个密钥注入请求；一个请求可以携带多个，例如 OAuth bearer 和开发者令牌头）。
CLI — 注入凭据后运行的供应商二进制文件（如 stripe, gh, vercel 等）。
技能/包（skill / bundle） = 一个配方（SKILL.md）+ 其密钥 + 其工具，共同注册。

The one rule: The proxy relays, never models the upstream, and injects auth server-side — so it survives upstream API changes and callers never hold keys.

唯一规则： 代理仅负责转发，从不模拟上游，并在服务器端注入身份验证——因此它能适应上游 API 的变更，且调用者永远无需持有密钥。

Part 1 · Using the registry Visit treg.to (hosted on Render) — the dashboard, sign-in, and every URL below live there.

第一部分 · 使用注册中心 访问 treg.to（托管在 Render 上）——仪表板、登录以及下方的所有 URL 均在此处。

Quickstart Same flow as the dashboard’s Getting started guide:

# 1. install the CLI — also points it at the registry
curl -fsSL https://treg.to/install.sh | sh

# 2. sign in (GitHub default · --email for a one-time code · --token for agents/CI)
treg login

# 3. do something useful immediately — no key, nothing registered
treg catalog search "backlinks for a domain" # find a tool by what it DOES
treg call tikhub.tiktok.user.profile --query uniqueId=tiktok
treg balance # exactly what that cost
# (or `treg onboard` for the guided walkthrough)

快速入门 流程与仪表板的“入门指南”相同：

# 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` 进行引导式演练)

Fish Audio provides S2.1 Pro speech, public-voice discovery, and private voice cloning. Speech is binary stdout, so redirect it to a file. A discovered voice’s _id or a team voice id is the TTS reference_id; voices created on treg’s Fish account are durable team resources:

Fish Audio 提供 S2.1 Pro 语音、公共语音发现和私人语音克隆功能。语音输出为二进制标准输出（stdout），因此请将其重定向到文件。发现的语音的 _id 或团队语音 ID 即为 TTS 的 reference_id；在 Treg 的 Fish 账户上创建的语音是持久的团队资源：

treg call fishaudio.tts.s2-1-pro --method POST --header model=s2.1-pro \
  --data '{"text":"Hello from treg","format":"mp3"}' > speech.mp3
treg call fishaudio.voices.discover --query self=false --query licensed=false --query language=en
treg resources list --provider fishaudio --kind voice

With your own Fish key, requests remain an unrestricted, unmetered upstream relay and Fish owns the account boundary. Catalog tool inputs are described by treg catalog get <id>. Tools marked strict_query reject undeclared or repeated query parameters, unsupported values and request bodies. Your token identifies you on every call (X-Treg-Token header) and is the same for all tools.

使用你自己的 Fish 密钥，请求将保持为不受限制、不计费的上游转发，且账户边界由 Fish 管理。目录工具的输入可以通过 treg catalog get <id> 查看。标记为 strict_query 的工具会拒绝未声明或重复的查询参数、不支持的值以及请求体。你的令牌在每次调用时都会识别你的身份（X-Treg-Token 头），且对所有工具通用。

Discover what your team has shared: treg tool ls · check credential health: treg health. Or install it as a Claude Code plugin: /plugin marketplace add superdesigndev/treg /plugin install treg@treg

查看团队共享的内容：treg tool ls · 检查凭据健康状况：treg health。或者将其安装为 Claude Code 插件： /plugin marketplace add superdesigndev/treg /plugin install treg@treg

Installs with no token and no configuration. The skill loads as treg:treg and, on its first run, walks your agent through the rest — the CLI, sign-in, then treg mcp install — so you end up with the command line and treg’s tools.

安装时无需令牌和配置。该技能加载为 treg:treg，并在首次运行时引导你的智能体完成其余步骤——CLI、登录，然后是 treg mcp install——这样你最终就能同时拥有命令行和 Treg 的工具。

Other agents: npx skills add superdesigndev/treg -s treg (the -s matters — without it you also get this repo’s internal dev skills). See docs/CLAUDE-PLUGIN.md. MiniMax Code / MiniMax Agent users: the same skill ships via the MiniMax Plugin Marketplace (docs/MINIMAX-PLUGIN.md).

其他智能体：npx skills add superdesigndev/treg -s treg（-s 很重要——没有它，你还会获取该仓库内部的开发技能）。详见 docs/CLAUDE-PLUGIN.md。MiniMax Code / MiniMax Agent 用户：相同的技能可通过 MiniMax 插件市场获取（docs/MINIMAX-PLUGIN.md）。

Claude.ai connector The Claude Connectors Directory surface is https://treg.to/mcp/v2/. It exposes only curated catalog endpoints and separates read calls from write calls so Claude receives accurate safety signals. The existing /mcp/ surface remains available for catalog endpoints, team-owned tools, and imported skills. See the MCP and OAuth architecture for the boundary and implementation, and the submission runbook for release gates.

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

Call a tool you don’t have a key for The catalog is grouped by what endpoints do: keyword and rank tracking, backlinks and authority, AI visibility, trending and discovery, publishing to socials, people and company enrichment, ads management and creative, measurement.

调用你没有密钥的工具 目录按端点功能进行分组：关键词和排名跟踪、反向链接和权威度、AI 可见性、趋势和发现、社交媒体发布、人员和公司信息丰富、广告管理和创意、衡量指标。

treg catalog # every platform, busiest first
treg catalog search "find a work email" # by the job, not the vendor
treg catalog get hunter.people.email.find # params, PRICE, example response
treg call hunter.people.email.find --query domain=reddit.com --query full_name="Alexis Ohanian"

How a catalogued call is served — the credential ladder, in order:

your team registered its own tool for that provider → that tool, that key;
your team stored a secret for the provider → injected through a virtual tool;
neither, and the endpoint has a verified public route → no provider key, free;
otherwise → treg’s own key, billed to the team’s prepaid balance. The anonymous price assumes the caller does not send a provider credential.

编目调用的服务方式——凭据梯级（按顺序）：

你的团队为该提供商注册了自己的工具 → 使用该工具及其密钥；
你的团队存储了该提供商的密钥 → 通过虚拟工具注入；
以上皆无，且端点有验证过的公共路由 → 无需提供商密钥，免费；
其他情况 → 使用 Treg 自己的密钥，从团队预付余额中扣费。匿名价格假设调用者未发送提供商凭据。