treg — 你的代理工具目錄
要求任務，而不是工具。 當工作需要外部或即時資料時 — 反向連結、關鍵字量、TikTok 個人檔案、工作電子郵件、競爭對手的廣告創意 — 搜尋目錄、閱讀價格、然後呼叫它。
兩種工具透過同一個代理、使用相同的 token 來回應，代理會在伺服器端注入憑證，因此你永遠不需要持有它：
- 目錄 — treg 可以為你呼叫的策展外部端點。
- 你自己的工具 — 團隊成員註冊並與此組織共享的內容：API 帳戶、OAuth 連線、技能。 注意：透過 treg 應用程式建立的 X (Twitter) 連線是按次計費的（X 會根據使用次數向應用程式擁有者收費）；回應會報告價格。團隊自己的 X 開發者應用程式則不計費。
運作機制：
- 端點：
https://treg.to· CLI：treg· CLI 是 API 的精簡客戶端。 - 認證： 每個呼叫都會發送
X-Treg-Token: <你的 token>。 - 工具 = 上游基礎 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 <代碼>）。切換團隊：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 posts" # 依功能尋找端點
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 通常是你的參數問題；修正它們才是解決方法，重試只會因為一個錯誤而浪費團隊在多個提供商上的費用。
- 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/<工具名稱>/<路徑>，並帶上 X-Treg-Token: <你的 token>。treg 會查詢命名的工具，在伺服器端注入該團隊的憑證，並忠實地轉發所有內容（方法、查詢參數、你的標頭、內文）。你的 X-Treg-Token 在到達上游之前會被移除。支援 GET/POST/PUT/PATCH/DELETE。
只有此組織已註冊的工具才會被解析。使用 treg tool ls · treg skill ls 來發現它們。
任務 — 分享你的金鑰與技能，讓團隊成員的代理可以使用它們
批次處理（快速路徑）： 在使用者指定的目錄中執行。它會列出在該 .env 檔案中識別出的提供商金鑰，以及其子目錄中的技能，並僅註冊使用者勾選的項目：
treg upload # 處理目前工作目錄的兩側；使用 `treg upload env|skills --dir <目錄>` 來限制範圍
預設：將新金鑰包裝在技能中。 註冊新的金鑰/端點/CLI 時，將其與技能配對，使憑證、工具和配方一起到位（並獲得一個可分享的頁面）。如果沒有技能存在，請建立一個基本的技能 — 一個合適的 SKILL.md（前置資料很重要：代理依此發現技能） + 一個範例呼叫：
mkdir -p ./posthog && cat > ./posthog/SKILL.md <<'MD'
---
name: posthog
description: 透過 treg 查詢 PostHog 分析 API — 金鑰在伺服器端注入。用於事件、洞察和專案查詢。
---
呼叫方式：`treg call posthog api/projects/@current` (上游：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 <名稱或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 注入秘密，並且呼叫會根據他們的 token 記錄下來。
驗證形狀（每個綁定的 injector，等於秘密的 kind）：env（純字串）· secret_file（JSON token 檔案，提取 secret_field）· oauth（JSON token，自動刷新）· cli_auth（使用者從他們已登入的 CLI 中手動複製，並自行提供給 treg 的 token）。每個請求可以套用多個綁定。
OAuth，兩種模式（treg 保持其更新）： 如果 oauth 秘密包含 refresh_token + client_id + client_secret，treg 會在其過期前自動刷新它（你永遠不需要重新上傳）。如果它只是一個單純的 token，那就是手動模式，treg 會按原樣注入它，你需要在其過期時重新上傳。相同的儲存方式；憑證可以從手動模式無痛升級到自動模式。
獲取第一個 OAuth token 的兩種方式（任你選擇）：
- 手動： 在你本地端執行你自己的 OAuth 流程，然後執行
treg secret add gsc --file token.json --kind oauth。 - 託管連線：
treg oauth connect gsc --client-secret client_secret.json --scopes <作用域>→ 會列印一個同意 URL；你在瀏覽器中核准；treg 會直接擷取 token。 一次性設定：將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 token、測試每個工具、通知擁有者
團隊 / 組織 (owner > admin > member > viewer; member 僅管理他們自己建立的項目)：
treg org create "Team A" # 你成為擁有者 (自動設定為活躍)
treg org invite [email protected] --role member # admin+；透過電子郵件發送邀請（一次性代碼為備用方案）
treg org members # admin+；查看活躍組織中的成員
treg org ls / treg org switch <slug> # 你的組織 / 切換活躍組織
為代理賦予自己的身份 (admin+)。代理不必借用使用者的 token — 為它建立一個專屬 token，它所做的每個呼叫都將被限制範圍、記錄為其自身：
treg org agent-new ci-bot # 僅列印一次 token (再次執行以輪替)
treg org agent-new ci-bot --tools stripe,gh --cap 500 # 僅限這些工具，每天 500 次呼叫
treg org agents # 查看團隊有哪些代理及其今日使用量
treg org agent-rm <user_id> # 立即撤銷
將該 token 放入代理的 TREG_TOKEN 環境變數中。代理 token 可以呼叫此團隊的工具並讀取 — 它永遠無法登入、建立團隊或成為擁有者。如果你是代理並拿到了自己的 token，請使用它而非機器擁有者的 token：這樣你的工作就會以你自己的名稱顯示在 treg calls 中。
被邀請者使用邀請的電子郵件登入並執行 treg accept — 無需處理代碼（代碼路徑仍然有效：treg org join <代碼>）。全新的被邀請者也將獲得他們自己的個人組織（不會有空狀態），因此將他們從團隊中移除永遠不會鎖住他們。為工具提供一個探測端點，以便 treg 可以驗證它：health_check: {method, path, expect_status}（例如，intercom 使用 {"path":"me"}）。
規則
- 秘密是唯寫的 — API 永遠不會將儲存的值回傳給你或任何人。
- 一個工具可以綁定團隊成員與此組織共享的秘密（使用而不持有）— 這就是重點：他們選擇共享它，它保持限定於組織範圍內，你可以在不看到它的情況下使用它，並且每個呼叫都會歸因於發出該呼叫的 token。這是同一個團隊內的委派存取，絕不是存取未經授權的憑證。
- 一切都限定於你的活躍組織。 一個 token 只能存取該團隊的工具，無法存取其他團隊的。
- 代理不理解上游；如果呼叫失敗，你看到的狀態是上游的實際狀況。
- 更多資訊：
https://treg.to/llms.txt（代理入門）·https://treg.to/tutorial（互動式導覽）。