treg

npx add-mcp 'https://treg.to/mcp/v2/'

Treg（工具版 OpenRouter）

OpenRouter，但對象是代理工具而非模型。 讓代理指向一個基礎 URL 並使用一個 token， 即可完成工作：橫跨多家供應商的數千個端點精選目錄 — SEO 與反向連結、 社群與趨勢、人物與公司資料豐富化、廣告、爬蟲、圖片與影片生成 — 按次計費，最低一分錢起， 無需註冊任何供應商帳號。此外還有您團隊自己的金鑰、技能與 CLI，每位團隊成員的 代理皆可呼叫，而憑證從不離開伺服器。

描述任務，而非工具。 您無需知道哪家廠商販售反向連結資料，也無需 持有他們的帳號。搜尋您想做的事、查看價格、直接呼叫。

專為 Superdesign 團隊打造，上線於 treg.to — 任何人都可以自行架設。

為什麼存在

代理在實際工作中需要的工具，背後往往是沒人會為了單次執行而購買的訂閱 — Semrush 每月 $139、Moz 每月 $99、Crunchbase 每月 $99、Apollo 每席位 $59 — 被擋在註冊牆之後， 或根本沒有公開 API（僅限邀請、僅限合作夥伴、僅限應用程式審核）。treg 承擔這些帳號， 並按次收取極小額費用。

兩種工具，一個 token

• 目錄 — treg 可以用自己的金鑰或透過無需供應商金鑰的已驗證公開 路由來服務的外部端點。自有金鑰呼叫使用團隊的預付餘額；匿名呼叫 免費。無需持有供應商帳號。新驗證帳號在建立符合資格的團隊時， 可獲得一次 $1.00 免費額度。
• 您自己的工具 — 團隊成員註冊的任何東西：付費 API 帳號、OAuth 連線、 廠商 CLI、SKILL.md。您自己的金鑰永遠優先於 treg 的，且這些呼叫永遠不會被計量。

第二部分的詞彙：

• tool（工具） = 登錄檔使用組織憑證為您呼叫的東西。兩種：
  • endpoint（端點） — 上游 base_url + 憑證 bindings（綁定）（每個綁定會將一個 密鑰注入請求；一個請求可以攜帶多個，例如 OAuth bearer 和 developer-token 標頭）。
  • CLI — 廠商二進位檔（stripe、gh、vercel、...），執行時注入憑證。
• skill / bundle（技能／套件） = 一份配方（SKILL.md）+ 其密鑰 + 其工具，一起註冊。

唯一規則： 代理 轉送，而非模擬 上游，且 在伺服器端注入驗證 — 因此它能承受上游 API 變更，呼叫者永遠不會持有金鑰。

---

第 1 部分 · 使用登錄檔

造訪 treg.to（託管於 Render）— 儀表板、 登入，以及下方所有 URL 都在那裡。

快速入門

與儀表板的 Getting started 指南流程相同：

# 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)

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

使用您自己的 Fish 金鑰時，請求會保持為不受限制、不計量的上游轉送，且 Fish 擁有 帳號邊界。

目錄工具輸入由 treg catalog get <id> 描述。標記為 strict_query 的工具會拒絕未宣告或重複的查詢參數、不支援的值與請求主體。

您的 token 在每次呼叫中識別您（X-Treg-Token 標頭），且所有工具共用同一個。 探索您的團隊分享了什麼：treg tool ls · 檢查憑證健康狀態：treg health。

或安裝為 Claude Code 外掛

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

安裝時無需 token 與設定。技能會載入為 treg:treg，並在首次執行時 引導您的代理完成其餘步驟 — CLI、登入，然後 treg mcp install — 因此您最終會擁有 命令列 和 treg 的工具。其他代理：npx skills add superdesigndev/treg -s treg （或參閱 Workflow skills 了解其餘部分）。 參閱 docs/CLAUDE-PLUGIN.md。MiniMax Code / MiniMax Agent 使用者：相同的 技能透過 MiniMax Plugin Marketplace 提供（docs/MINIMAX-PLUGIN.md）。

工作流程技能

現成配方，您的代理可端到端執行，每次呼叫都透過 treg：

技能	您的代理可以做的事
treg	尋找並呼叫目錄中的任何工具，以及您自己的工具
lead-signals	從公開訊號（投訴、工作變動、招聘、融資、工具採用）尋找市場中的買家，並監控主題、競爭對手或帳號清單（treg.to/leads-signals）
make-ugc	製作 AI UGC 影片：熱門鉤子、主持人、 talking-head 片段、字幕（treg.to/ugc）

install.sh 會為您安裝全部技能。若要改為新增至現有代理 （skills.sh CLI）：

npx skills add superdesigndev/treg                        # every public skill
npx skills add superdesigndev/treg --skill lead-signals   # just one
treg skill bootstrap                                      # same set, with the treg CLI you already have

工作流程技能在 treg 上執行，因此請先設定好（上述快速入門，或將您的代理指向 treg.to/llms.txt）。

Claude.ai 連接器

Claude Connectors Directory 介面為 https://treg.to/mcp/v2/。它僅暴露精選的 目錄端點，並將讀取呼叫與寫入呼叫分離，以便 Claude 接收準確的安全 訊號。現有的 /mcp/ 介面仍可用於目錄端點、團隊擁有的工具 與匯入的技能。參閱 MCP 與 OAuth 架構 了解邊界與實作，以及 提交 runbook 了解發布門檻。

呼叫您沒有金鑰的工具

目錄按端點的功能分組：關鍵字與排名追蹤、反向連結與權威度、 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"

目錄呼叫如何被服務 — 憑證階梯，依序：

1. 您的團隊為該供應商註冊了自己的工具 → 使用該工具、該金鑰；
2. 您的團隊為該供應商儲存了密鑰 → 透過虛擬工具注入；
3. 兩者皆無，且端點有已驗證的公開路由 → 無需供應商金鑰，免費；
4. 否則 → treg 自己的金鑰，從團隊的預付餘額計費。

匿名價格假設呼叫者不傳送供應商憑證標頭。忠實的 轉送會保留呼叫者標頭，因此呼叫者提供的供應商金鑰可以使用該金鑰的額度。 您自己的憑證永遠優於 treg 的，因此連接您已在付費的金鑰會讓那些呼叫 不消耗餘額，而非重複計費。treg 沒有發布價格的端點會被 拒絕，而非免費服務 — 系統會告訴您改為連接自己的金鑰。當多家供應商 提供同一種能力時，treg catalog search 會並排顯示價格；選擇權在 您手中 — treg 不會默默為您挑選或在供應商之間切換。（當 treg 自己 某供應商的帳號額度用盡時，可能會透過 treg 擁有的轉送帳號服務相同端點， 並在回應中揭露；團隊可以選擇退出。）您可選擇加入的例外：treg.<capability> 路由端點，treg 會為您挑選供應商並指名。

treg balance          # credit left, calls in flight, recent spend
treg topup            # add funds, or set up automatic top-ups

餘額不足時會回傳 HTTP 402，攜帶 balance_micro、estimated_cost_micro 與 topup_url， 讓代理無需閱讀文字即可採取行動。

Enrich Arena 位於 /enrich-arena，在儀表板之外。比較資料豐富化答案與各家廠商的成本與速度， 一鍵投票選出最佳答案，或觀看循序瀑布流。能力相容的 非同步供應商也參與其中；Arena 內部處理提交與輪詢。瀏覽是 公開的；提交需要登入，且可計費的嘗試會使用您團隊的額度。參閱 Arena 指南。

分享與使用您自己的工具

零思考路徑 — 將 treg 指向一個專案，它會自動判斷什麼可以分享：

treg scan     # read-only preview: the keys, skills & CLIs upload would register
treg upload   # register them (encrypted server-side); idempotent, --replace to update

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     # or straight from the .env

使用 — 代理原生方式：建構真實的上游請求，並加上代理前綴。 treg 依主機解析工具、注入憑證，並忠實轉送其他一切 （您的 X-Treg-Token 會在上游看到之前被剝除）：

Real request:   GET https://api.intercom.io/conversations?per_page=5
Through treg:   GET https://treg.to/call/https://api.intercom.io/conversations?per_page=5
                    header:  X-Treg-Token: <your 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   # runs on the registry server: the key never reaches you

--local（預設）在您的機器上執行；--server 在登錄檔上執行並串流輸出回來。 對於整個工作階段，treg shell start 會開啟一個子 shell，其中每個已註冊的 CLI 都會自動注入 — 只需正常使用 stripe、gh、…；exit 還原。treg runs 是稽核日誌。

3. 技能

分享 — 技能是完整的能力（SKILL.md 配方 + 其密鑰 + 其工具）， 一起註冊，讓整個團隊執行相同的技能，並在單一位置維護：

treg upload skills --dir ~/.claude/skills --all   # register a folder of skills in one pass

使用 — 將任何共享技能拉入您的代理；其 API 呼叫透過 treg 使用您的 token， 因此金鑰留在伺服器上，永遠不會進入技能：

treg skill install seo-blog-writer      # writes into ./.claude/skills/  (--all for the library)

手動註冊 — 當啟發式演算法無法判斷工具時

# multi-credential tool (e.g. google-ads: OAuth bearer + a developer-token header)
treg tool add google-ads --base-url https://googleads.googleapis.com \
  --bind "secret=<oauth-id>,injector=oauth" \
  --bind "secret=<dev-id>,name=developer-token,format={secret}"

# one skill, step by step
treg skill init --dir ./my-skill          # drafts treg.json (guesses base_url, finds secrets)
treg skill add  --dir ./my-skill          # registers recipe + secrets + tool, atomically

# OAuth via the browser (mints the first token, treg holds it and auto-refreshes)
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 停用。 參閱 analytics 詳細資訊。

團隊

一個帳號最多可擁有 10 個團隊。以成員身分加入其他團隊不計入此限制。

所有內容都以組織為範圍：一個 token = 一個 (user, org) 成員資格，且每個密鑰、工具 與技能都屬於目前組織。角色：owner / admin / member / viewer。

treg org create "Acme"                        # make a team, become owner
treg org invite teammate@acme.com             # invite by email (pick role + tool access)
treg org join <code> --email you@acme.com     # accept an invite (creates you if new)
treg org ls | use <slug> | members            # switch orgs, see the roster
treg org access <member> --tools a,b          # per-member tool access (admin+)

深入探索

• 意見回饋： treg feedback submit friction "The pagination example is unclear." 分享問題或建議，請勿包含私人資訊。參閱 feedback 說明。

• 評論： treg review CALL_ID useful 使用受邀目錄呼叫的結果後為其評分；not_sure 也可以。請省略私人資料並繼續任務。

• USAGE.md — 完整的 treg CLI 參考。

• /llms.txt — 代理入門檔案：呼叫 協定、探索、驗證、CLI、技能。一次擷取即可讓代理了解整個登錄檔。

• 儀表板 位於 treg.to — 完整 CRUD、引導式 教學（Help → Tutorial），以及可複製的代理設定說明。

• API — CLI 做的每件事都是純 HTTP；互動式 OpenAPI 文件位於 /docs。 代理端點為 /call/{...}；所有端點都接受 X-Treg-Token 標頭。

---

第 2 部分 · 自行架設與開發

在本機執行

一個指令（需要 tmux + uv；它會自行同步 venv）：

scripts/dev-local.sh up        # server on http://localhost:18790, dev-safe settings

這會在 tmux 中以熱重載執行伺服器、使用自己的 sqlite 資料庫（treg-dev.db），並啟用 email OTP 開發 模式（登入碼顯示在頁面上 — 無需郵件寄送者）。日常使用：

scripts/dev-local.sh cli login   # sandboxed CLI: never touches your real ~/.treg/config.json
scripts/dev-local.sh logs        # server output          · status / restart / down
scripts/dev-local.sh reset       # wipe the dev DB + CLI sandbox for a fresh start

或直接執行伺服器，不使用 tmux：

bash scripts/build-dashboard.sh # Node 22.12+ and npm; build the Dashboard
uv sync                        # create the venv from uv.lock (pulls the server deps for dev)
uv run python -m treg upgrade  # prepare schema + run idempotent release tasks without serving
uv run python -m treg          # serve on 0.0.0.0:18790 (add --reload for dev)
uv run python -m treg keygen   # print a fresh Fernet key for TREG_SECRET_KEY

安裝以執行伺服器（非從原始碼）： 基礎套件僅為 CLI。若要執行 registry，請安裝伺服器額外套件 — pip install "tools-registry[server]" — 它會加入 FastAPI、 資料庫驅動程式與加密功能。僅 pip install tools-registry 只提供 treg 命令，用於 與既有 registry 通訊。

官方代管服務位於 treg.to。其生產拓撲與即時設定 維護於私有的 operator runbook。

設定

環境變數（前綴 TREG_，從 .env 讀取）：

變數	預設值	用途
TREG_DATABASE_URL	sqlite+aiosqlite:///./treg.db	資料庫 URL（開發用 SQLite，生產用 Postgres）
TREG_READ_DATABASE_URL	(空)	選用的 SQLite / PostgreSQL 讀取資料來源；空白則重用主要來源。需要呼叫端選擇啟用；既有查詢不變。請參閱 read datasource setup。
TREG_SECRET_KEY	(空)	用於靜態資料加密的 Fernet 金鑰；空白 → 產生暫時金鑰（機密在重新啟動後不會保留）
TREG_PUBLIC_URL	https://treg.to	treg 的公開基礎網址，用於建構 OAuth 回呼 URI
TREG_SESSION_SECRET	(空)	簽署儀表板工作階段 Cookie；若無則回退至 TREG_SECRET_KEY。在生產環境請設定真實值
TREG_GITHUB_CLIENT_ID / _SECRET	(空)	GitHub OAuth 登入（回呼 <public_url>/auth/github/callback）；空白則隱藏按鈕
TREG_GOOGLE_CLIENT_ID / _SECRET	(空)	Google OAuth 登入（重新導向 <public_url>/auth/google/callback）；空白則隱藏按鈕
TREG_INSTAGRAM_CLIENT_ID / _SECRET	(空)	Instagram 應用程式 ID 與密鑰，用於直接 Instagram 登入（重新導向 <public_url>/oauth/callback）
TREG_META_CLIENT_ID / _SECRET	(空)	Meta 應用程式憑證，用於 Facebook 粉絲專頁、Meta 廣告與選用的 Instagram page-tools
TREG_OAUTH_REVIEW_PENDING	instagram-login,page-messages	逗號分隔的 registry 審查金鑰，其功能必須保持受限；代管的審查狀態私下維護。
TREG_RESEND_API_KEY / TREG_EMAIL_FROM	(空)	透過 Resend 發送交易電子郵件（OTP 驗證碼 + 邀請）；寄件者必須是 Resend 驗證過的寄件者
TREG_BLOCKED_EMAIL_DOMAINS	(空)	逗號分隔的電子郵件網域，在每個註冊/登入入口及建立團隊時拒絕（包含子網域，不區分大小寫）。空白則不阻擋任何項目 — 程式碼中不內建任何清單
TREG_ADMIN_TOKEN	(空)	跨租戶 超級管理員 bearer；授權每個 /admin/* 端點。空白則停用環境變數路徑（僅 is_superadmin 使用者可達 /admin）。請保持長且機密。
TREG_EMAIL_DEV_MODE	false	為 true 時，/auth/email/start 會在回應中回傳 OTP（無需郵件寄送者）— 僅限開發/本機，絕不可用於生產。
TREG_KV_URL	(空)	共用鍵值儲存（Redis 協定），用於所有 worker 必須一致的計數器，目前用於每團隊的審查邀請預算。空白 = 程序內回退，適用於單一 worker

本機開發無需 .env — 每個設定都有可用的預設值（暫時金鑰、sqlite）。

⚠️ 在搬移或重新部署前請備份這些項目： Fernet 金鑰（TREG_SECRET_KEY）與 資料庫（生產用 Postgres；本機 sqlite 執行用 treg.db）。遺失 Fernet 金鑰將導致 所有儲存的機密無法復原。

架構

/call 的請求流程： 解析工具（依 URL 主機 + 最長 base_url 前綴，或依名稱）→ 解密其機密 → 套用每個綁定的注入器 → 串流至上游 → fire-and-forget 稽核記錄。基礎設施中繼僅串流位元組，不含商業邏輯。呼叫應用程式會緩衝 需要結算或所有權證據的回應，上限 8 MiB；較大的回應回傳 502 而不計費，而非回傳截斷的成功。授權的免費最終下載若無需主體證據 則完整串流，自有金鑰與自有工具的回應亦同。

模組對應（src/treg/）：

模組	角色
proxy.py	relay() — 整個產品濃縮於一個函式：忠實的串流代理
injectors.py	認證形狀的接縫：env、cli_auth、secret_file、oauth 將機密放入標頭/查詢
oauth.py	權杖新鮮度（單飛重新整理）+ 連線流程（同意 URL、代碼交換）
health.py	憑證健康狀態：重新整理 oauth、探測工具、將任何異常項目的擁有者以 webhook 通知
convert.py	將技能目錄建構成可註冊的套件 manifest
api.py	API — 唯一的大腦；CLI 與技能是其上的精簡客戶端
cli.py	treg CLI
models.py	SQLModel 資料表：Org、User、Membership、Invite、Secret、Tool、Bundle、PendingOAuth、CallRecord
crypto.py config.py db.py audit.py	Fernet 加密 + 權杖 · 設定 · 非同步資料庫 · 延遲稽核寫入器

4 種認證形狀（每個綁定 injector）：env（純字串 / API 金鑰）· secret_file（ JSON 權杖檔案，提取欄位）· oauth（JSON OAuth 權杖，若可重新整理則自動重新整理）· cli_auth（從 CLI 的鑰匙圈提取的素材）。

忠實中繼契約： 代理僅變更三件事，其餘皆原封不動：

1. 逐跳傳輸標頭（每跳重新推導），
2. treg 自身的控制與邊緣轉發標頭（x-treg-token、x-treg-org、 ngrok-skip-browser-warning、x-forwarded-*、via、…）以及 treg 的工作階段 Cookie — 全部剝除， 絕不洩漏至上游，
3. 注入的憑證。

OAuth，取得第一個權杖的三種方式： 手動上傳（放入 token.json）· 自動重新整理（若權杖帶有 refresh_token + 客戶端憑證，treg 會保持其新鮮，您無需 重新上傳）· 代管連線流程（treg oauth connect → 瀏覽器同意 → treg 自行 擷取權杖）。

健康檢查： 為工具提供選用的探測（{method, path, expect_status}）；定期執行 （依需求或透過 cron）驗證每個憑證、重新整理 OAuth，並以 webhook 通知任何 異常項目的擁有者。

深度設計位於 docs/context/（依子系統的片段）。

測試

uv run --with pytest-xdist pytest -n auto -q   # daily local default (same shape as CI)
uv run --frozen python -m pytest -q            # serial: debugging one test, or order

覆蓋範圍：代理 walking-skeleton、所有注入器形狀、每使用者認證 + CRUD + 稽核、技能組合器、 URL 直通 + 忠實中繼、OAuth 重新整理 + 連線流程、健康檢查、treg run/shell、 上傳/掃描、組織 + 邀請、儀表板 API、CLI。

貢獻與文件

treg/
├── src/treg/            # the package (api, cli, proxy, injectors, oauth, health, convert, models, …)
│   └── web/             # dashboard, landing, tutorial, llms.txt, skill.md, install.sh
├── tests/               # pytest suite (CI + local default: pytest-xdist -n auto)
├── docs/
│   ├── context/         # design fragments (codemap system) + generated index
│   └── ONBOARDING.md    # first-time bootstrap
├── USAGE.md             # full treg CLI reference
└── pyproject.toml

每個子系統的設計文件是 docs/context/ 中的片段，每個皆引用其 src/treg/* 來源。在此儲存庫中與 AI 代理協作？/tools-registry-context 技能會載入 您正在處理內容的正確片段，並保持文件同步 — 在推送前執行 /tools-registry-context sync。

路線圖： MCP 支援 · 更細緻的權限層級 · 靜態金鑰管理強化 · 可能的 Loopni 合併。

授權

Apache 2.0 附加條款（LICENSE）：可自由使用 — 包含商業用途、 在您自己的組織內（鼓勵自行代管自己的 registry）。限制：未經書面許可，不得 將程式碼重新散布給第三方作為競爭性的代管/受管 registry 服務 （jason@superdesign.dev）。在您自己的產品中使用代管的 treg.to API — 透過 X-Treg-Meta 與 usage/by-tag 進行轉嫁計費 — 無需許可即可使用； 這是呼叫我們的 API，而非重新散布我們的軟體。

固定的客戶端讀取範圍

對於受限的客戶端代理，treg org agent-new bot --pin customer=cust_A 強制歸屬， 並將呼叫/執行歷史、封存結果與共用提供者非同步所有權範圍限定於該固定範圍。 外部或無歸屬的 ID 回傳 404；未固定的操作者保留組織範圍檢視與共用 餘額。BYOK 帳戶存取與公開媒體 URL 保留其既有權限。請參閱 multi-tenancy contract 以了解多個固定範圍、遷移與重播行為。