superdesigndev/treg · 上手攻略
- 仓库：superdesigndev/treg
- 链接：https://github.com/superdesigndev/treg
- 分类：AI Agent 工具注册表 · 基础设施
- 作者：Tom
- 更新：2026-09-26
§1 是什么
treg（Tool Registry）是 OpenRouter 的逻辑翻版——但代理的不是模型，而是外部工具/API 端点。它是一个本地工具注册表代理，让 AI Agent 用一个 Token 访问 3,000+ 外部端点（SEO、社交数据、公司信息查询、广告投放、图片/视频生成等），无需分别注册各个平台账号。
类比理解： - OpenRouter = 模型的中介，一次 API Key 访问所有模型 - treg = 工具的中介，一次 Token 访问所有外部 API
核心价值：把 AI Agent 从"需要知道用什么工具"中解放出来——只描述需求，treg 负责找对应的 API 并完成调用。
§2 解决什么问题
AI Agent 真正干活时需要调用大量外部工具：查域名权重、搜 Twitter 趋势、找某人的工作邮箱、在 Crunchbase 查公司数据——但这些 API 大多： - 按月订阅（Semrush $139/mo、Moz $99/mo） - 有接入门槛（需审批/合作伙伴） - 甚至根本没有公开 API
treg 的思路是：把这些工具汇聚到一个注册表，按次计费（几分钱一次），无需单独注册，用多少付多少。同时支持把自己的付费账号接入作为"团队工具"，让整个团队的所有 Agent 共享同一套凭证。
§3 快速安装
方式一：官方托管（treg.to）
# 安装 CLI（同时将 CLI 指向 treg.to 托管注册表）
curl -fsSL https://treg.to/install.sh | sh
# 登录（GitHub OAuth，CI/Agent 场景可用 --token 标志）
treg login
# 立即可用，无需配置 key
treg catalog search "backlinks for a domain" # 找工具
treg call tikhub.tiktok.user.profile --query uniqueId=tiktok # 调用工具
treg balance # 查余额
托管版有免费试用额度，新用户获得 $1.00 免费余额。
方式二：自托管
# 拉取源码
git clone https://github.com/superdesigndev/treg.git
cd treg
# 按 docs/ 目录下的部署文档自行部署（需要一台可联网的服务器）
# 自托管后可接入自己的供应商账号体系
方式三：Claude Code 插件（零配置）
# 安装 treg 插件（skills-only 模式，无需 MCP）
/plugin marketplace add superdesigndev/treg
/plugin install treg@treg
# 安装后 skill 名为 treg:treg
# 首次运行自动引导：安装 CLI → 登录 → 安装 MCP 工具
⚠️ 安装插件后需要重启 Claude Code 才能使 MCP 工具生效（
claude mcp add在重启前不生效）。
§4 核心用法
工具目录检索（按需找工具）
# 浏览全部工具分类（SEO、反链、社媒、企业信息、广告等）
treg catalog
# 按任务描述搜索工具
treg catalog search "find a work email"
treg catalog search "backlinks for a domain"
treg catalog search "trending topics twitter"
# 查看工具详情（参数、价格、示例响应）
treg catalog get hunter.people.email.find
调用工具
# 基础调用（参数格式：--query key=value）
treg call hunter.people.email.find --query domain=reddit.com --query full_name="Alexis Ohanian"
# 查看工具需要哪些参数必须先查 catalog get
TTS 场景（Fish Audio 集成示例）
# 查找可用音色
treg call fishaudio.voices.discover --query self=false --query licensed=false --query language=en
# 调用 TTS（s2.1-pro 模型，输出到 stdout，需重定向到文件）
treg call fishaudio.tts.s2-1-pro --method POST \
--header model=s2.1-pro \
--data '{"text":"Hello from treg","format":"mp3"}' > speech.mp3
余额与凭证管理
treg balance # 查看当前余额
treg health # 检查所有已注册凭证的健康状态
treg tool ls # 查看团队共享的所有工具
treg resources list --provider fishaudio --kind voice # 列出团队资源
Claude Code MCP 接入（MCP 版）
# 安装 MCP 工具（需要先完成 treg login）
treg mcp install
# 之后 Claude Code 的 MCP 连接器页面（/mcp/v2/）会显示 treg 的工具目录
# 按 read/write 分类展示，Claude 可直接调用
§5 典型适用场景
| 场景 | 怎么用 treg |
|---|---|
| AI Agent 做竞品调研 | /queue 查竞品域名 DA/外链数据 → treg 调用 Semrush/Ahrefs 端点 |
| 社交媒体运营 Agent | 查 Twitter/X 趋势 → treg 调用社交数据端点 |
| B2B 销售线索挖掘 | 找某公司员工的真实工作邮箱 → treg 调用 Apollo/Hunter |
| 广告投放 Agent | 查 Google Ads 关键词数据 → treg 调用广告 API |
| 内容创作 Agent | 生成配图/短视频 → treg 调用图片/视频生成端点 |
| 团队共享付费 API | 把自己的 Moz 账号注册进 treg，团队所有 Agent 共用，按次计量 |
§6 坑与注意
- ⚠️ 凭证优先级：自己的凭证 > treg 团队凭证 > treg 公共路由。接入自己的 API Key 后，该提供商的调用不再从 treg 余额扣费（免费用自己账号）。
- ⚠️ 匿名调用限制：没有凭证且无公共路由的端点会被拒绝，不会静默降级——会明确报错并告知需要接入自己的 Key。
- ⚠️ strict_query 端点：部分端点严格要求参数格式，参数名不匹配或传了不支持的值会直接报错，需先
treg catalog get <id>看清参数规范。 - ⚠️ 按次计费不等于便宜：部分专业工具（Semrush 高级数据）单次调用可能几十分，调用前建议先查
treg catalog get里的报价。 - ⚠️ MCP 模式安装顺序：必须先
treg login，再treg mcp install，顺序反了则 MCP 安装静默失败。 - ⚠️ 自托管版需要维护：如果选择自部署，需要自己管理供应商账号的生命周期和余额。
- ⚠️ Fish Audio 音色 ID：通过
fishaudio.voices.discover找到的音色 ID 是动态的（自建音色是团队持久资源），每次用前建议重新 discover 确保 ID 有效。
§7 与同类对比
| 工具 | 定位 | 优势 | 劣势 |
|---|---|---|---|
| treg | 工具注册表代理 | 3,000+ 端点、按次计费、团队共享凭证 | 自身是闭源商业服务（可自托管但需维护） |
| MCP（Model Context Protocol） | Agent 工具标准协议 | 通用性强、生态大 | 每个工具单独接入，凭证管理分散 |
| RapidAPI | API 市场 | 端点种类多 | 按月订阅为主，不针对 Agent 场景优化 |
| 各平台独立 SDK | 官方工具包 | 功能完整、版本稳定 | 碎片化、凭证各自为政 |
| Browserbase / Steel | 浏览器自动化 API | 专为 Agent 设计 | 专注爬取，非全品类工具 |
treg 的核心差异化：让 Agent"问需求找工具"而不是"知道工具再执行"，大幅降低 Agent 接入外部系统的认知负担。
§8 一句话推荐结论
如果你正在构建需要调用大量外部 API 的 AI Agent，treg 把"找工具 + 管凭证 + 按次计费"三件事合一——一个 Token，3,000+ 端点，零供应商注册摩擦。