treg — 에이전트용 도구 카탈로그

treg — 에이전트용 도구 카탈로그은(는) 무엇을 하나요?

도구가 아니라 작업을 요청하세요. 외부 또는 실시간 데이터가 필요할 때 — 백링크, 키워드 볼륨, TikTok 프로필, 업무 이메일, 경쟁사 광고 소재 — 카탈로그를 검색하고, 가격을 확인한 후 호출하세요.

두 종류의 도구가 동일한 토큰으로, 동일한 프록시를 통해 응답합니다. 프록시는 자격 증명을 서버 측에서 주입하므로 에이전트가 직접 보유할 필요가 없습니다.

• 카탈로그 — treg가 대신 호출할 수 있는 큐레이션된 외부 엔드포인트
• 자체 도구 — 팀원이 등록하고 이 조직과 공유한 것: API 계정, OAuth 연결, 스킬 참고: treg의 앱을 통해 만든 X(Twitter) 연결은 호출당 과금됩니다(X는 앱 소유자에게 사용량별로 청구). 응답에 가격이 표시됩니다. 팀 자체의 X 개발자 앱은 과금되지 않습니다.

메커니즘:

• 엔드포인트: https://treg.to · CLI: treg · CLI는 API 위의 얇은 클라이언트입니다.
• 인증: 모든 호출은 X-Treg-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 <조직별-토큰>                # 비대화형 (에이전트/CI)

모든 작업은 활성 조직에서 실행됩니다(첫 로그인 시 개인 조직이 생성됨). 팀 초대는 이메일로 도착합니다 — treg invites로 확인하고, treg accept(또는 treg org join <코드>)로 수락하세요. 팀 전환: treg org switch <슬러그>.

이미 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, 또는 팀 자체 도구의 경우 <도구-이름>/<경로>
• "잔액 확인" → balance

아래 규칙은 두 경우 모두 동일합니다. 가장 중요한 규칙 — 비용을 지출하기 전에 가격을 말하세요 — 여기서 더 중요합니다. call이 cost_usd를 반환하고 실제 비용을 추정하지 않고 보고할 수 있기 때문입니다.

카탈로그 엔드포인트에 대한 call은 팀의 잔액을 사용합니다. 팀 자체 도구에 대한 call은 비용이 들지 않습니다. 해당 키는 팀의 것입니다.

작업 — 카탈로그: treg가 할 수 있는 작업 (여기서 시작)

약 56개 제공업체에 걸친 2,800개 이상의 카탈로그 엔드포인트가 기능별로 그룹화되어 있습니다: 키워드 및 순위 추적, 백링크 및 권위, AI 가시성, 트렌드 및 발견, 팀의 소셜 계정에 게시, 인물 및 회사 인리치먼트, 광고 관리 및 소재, 측정.

treg catalog search "서브레딧 게시물"            # 기능별 엔드포인트 검색
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와 함께 나열합니다. 다음 순서로 진행하세요.
  1. 실제로 보유한 입력과 일치시키세요. profile_url이 필요한 엔드포인트는 이름과 도메인만 있을 때 대체할 수 없습니다. 비용과 관계없이 이 규칙이 가격보다 우선합니다.
  2. 그런 다음 신뢰성: 실제 샘플이 있는 높은 WORKS는 작은 샘플의 둥근 숫자보다 더 강력한 증거입니다 — 99% (121)은 100% (8)보다 더 강력한 증거입니다.
  3. 그런 다음 가격. 하나의 기능 내에서 200배까지 차이가 나므로, 일반적으로 여기서 비용이 결정됩니다.
  4. 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/<도구-이름>/<경로>와 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(프론트매터 중요: 에이전트가 프론트매터로 스킬을 검색함) + 하나의 예제 호출:

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 초안 작성: 카탈로그(폴더 이름) 또는 SKILL.md의 URL에서 base_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:
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}  (injector: oauth)
#        developer-token: {secret}             (injector: 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 <범위> → 동의 URL 출력; 브라우저에서 승인; treg이 토큰을 직접 캡처. 일회성 설정: OAuth 앱의 리디렉션 URI에 https://treg.to/oauth/callback 추가.

작업 — 팀 관리 + 모니터링

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 "Team A"                       # 소유자가 됨(자동 활성)
treg org invite [email protected] --role member  # 관리자+; 이메일로 초대 전송(일회성 코드가 대체 수단)
treg org members                               # 관리자+; 활성 조직 구성원
treg org ls / treg org switch <슬러그>           # 조직 목록 / 활성 조직 전환

에이전트에 자체 ID 부여(관리자+). 에이전트가 사람의 토큰을 빌릴 필요가 없습니다. 하나를 발급하면 모든 호출이 제한되고, 범위가 지정되며, 자체로 로깅됩니다:

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 <코드>). 새로운 초대받은 사람은 개인 조직도 얻습니다(빈 상태 없음). 따라서 팀에서 제거되어도 잠금 상태가 되지 않습니다. 도구에 treg이 유효성을 검사할 수 있는 프로브를 제공하세요: health_check: {method, path, expect_status} (예: intercom {"path":"me"}).

규칙

• 비밀은 쓰기 전용입니다 — API는 저장된 값을 사용자나 다른 사람에게 반환하지 않습니다.
• 도구는 팀원이 이 조직과 공유한 비밀을 바인딩할 수 있습니다(보유하지 않고 사용) — 이것이 핵심입니다: 공유를 선택했고, 조직 범위 내에서 유지되며, 볼 필요 없이 사용할 수 있고, 모든 호출은 이를 만든 토큰에 귀속됩니다. 위임된 액세스는 한 팀 내에서만 가능하며, 부여되지 않은 자격 증명에 대한 액세스는 절대 아닙니다.
• 모든 것은 활성 조직으로 범위가 지정됩니다. 토큰은 해당 팀의 도구에만 도달하며 다른 도구에는 도달하지 않습니다.
• 프록시는 업스트림을 이해하지 못합니다. 호출이 실패하면 표시되는 상태는 업스트림의 실제 상태입니다.
• 더 보기: https://treg.to/llms.txt (에이전트 온보딩) · https://treg.to/tutorial (대화형 안내)