Treg (OpenRouter for Tools)

treg — the tool catalog for your agent

모델 대신 에이전트 도구(agent tools)를 위한 OpenRouter입니다. 하나의 기본 URL과 하나의 토큰만 지정하면 에이전트가 작업을 수행할 수 있습니다. 즉, 다양한 제공업체에 걸친 수천 개의 엔드포인트로 구성된 큐레이션 카탈로그 — SEO 및 백링크, 소셜 및 트렌드, 인물 및 회사 정보 보강(enrichment), 광고, 스크래핑, 이미지 및 비디오 생성 등 — 호출당 비용이 부과되며, 센트 단위부터 시작합니다. 또한 제공업체 가입 절차 없이 사용할 수 있습니다. 여기에 팀원들의 자체 키, 기술(skills) 및 CLI도 포함되어 있으며, 이들은 자격 증명이 서버를 벗어나지 않도록 모든 팀원의 에이전트가 호출할 수 있습니다.

도구 대신 작업을 요청하세요. 어떤 공급업체가 백링크 데이터를 판매하는지 알 필요도 없고, 그곳에 계정을 보유하고 있을 필요도 없습니다. 원하는 작업에 대해 검색하고, 가격을 확인한 후, 호출하기만 하면 됩니다.

Superdesign 팀을 위해 구축되었으며 treg.to에서 라이브합니다 — 누구나 자체 호스팅할 수 있습니다.

존재하는 이유

에이전트가 실제 작업을 수행하는 데 필요한 도구들은 단 한 번의 실행만으로는 아무도 가입하지 않는 구독료 뒤에 숨겨져 있습니다 — Semrush $139/mo, Moz $99/mo, Crunchbase $99/mo, Apollo $59/seat 등. 이들은 가입 장벽 뒤에 있거나 아예 공개 API가 없는 경우(초대 전용, 파트너 전용, 앱 검토 전용)가 많습니다. treg는 이러한 계정을 보유하고 호출당 소수 센트만 청구합니다.

두 가지 종류의 도구, 하나의 토큰

카탈로그(The catalog) — treg가 자체 키로 제공하거나 공급업체의 키가 필요 없는 검증된 공개 경로를 통해 제공할 수 있는 외부 엔드포인트입니다. 자체 키 호출은 팀의 선불 잔액을 사용하며, 익명 호출은 무료입니다. 공급업체에 계정을 보유할 필요가 없습니다. 새로운 검증된 계정은 적격한 팀을 생성할 때 $1.00이 일회성으로 무료로 제공됩니다.
자체 도구(Your own tools) — 팀원이 등록한 모든 것: 유료 API 계정, OAuth 연결, 공급업체 CLI, SKILL.md 파일 등입니다. 자체 키는 항상 treg의 키보다 우선하며, 이러한 호출은 절대 사용량 측정 대상이 아닙니다.

두 번째 절반에 대한 어휘는 다음과 같습니다:

도구(tool) = 레지스트리가 조직의 자격 증명으로 호출하는 무언가 두 가지 종류:
- 엔드포인트(endpoint) — 상위(upstream) base_url + 자격 증명 바인딩(bindings) (각 바인딩은 요청에 하나의 비밀 정보를 주입하며, 요청은 여러 개를 가질 수 있음. 예: OAuth bearer 및 developer-token 헤더).
- CLI — 자격 증명이 주입되어 실행되는 공급업체 바이너리(stripe, gh, vercel, ...).
스킬/번들(skill / bundle) = 레시피 (SKILL.md) + 비밀 정보 + 해당 도구들을 함께 등록한 것.

유일한 규칙: 프록시는 상위 시스템을 모델링하는 것이 아니라 중계(relays)하며, 인증을 서버 측에서 주입합니다 — 따라서 상위 API 변경으로부터 살아남고 호출자는 키를 보유하지 않습니다.

파트 1 · 레지스트리 사용하기

treg.to (Render에 호스팅됨)를 방문하세요 — 대시보드, 로그인, 그리고 아래의 모든 URL이 여기에 있습니다.

빠른 시작(Quickstart)

대시보드의 사용 시작하기(Getting started) 가이드와 동일한 흐름입니다:

# 1. CLI를 설치하고 — 레지스트리를 가리키도록 설정합니다
curl -fsSL https://treg.to/install.sh | sh

...

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 '{

토큰은 모든 호출에서 사용자를 식별하며 (`X-Treg-Token` 헤더) 모든 도구에 동일하게 적용됩니다.
팀이 공유한 내용을 확인하세요: `treg tool ls` · 자격 증명 상태 확인: `treg health`.

### 또는 Claude Code 플러그인으로 설치

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


토큰이나 설정 없이 설치됩니다. 이 스킬은 `treg:treg`로 로드되며, 첫 실행 시 에이전트에게 나머지 과정(CLI, 로그인, 그리고 `treg mcp install`)을 안내하여 명령줄과 treg의 도구를 모두 갖게 됩니다. 다른 에이전트의 경우: `npx skills add superdesigndev/treg -s treg` (또는 [Workflow skills](#workflow-skills)에서 나머지 내용을 확인하세요).
[docs/CLAUDE-PLUGIN.md](docs/CLAUDE-PLUGIN.md)를 참조하세요. MiniMax Code / MiniMax Agent 사용자: 동일한 스킬이 MiniMax Plugin Marketplace([docs/MINIMAX-PLUGIN.md](docs/MINIMAX-PLUGIN.md))를 통해 제공됩니다.

### Workflow skills (워크플로우 스킬)

에이전트가 treg를 통해 모든 호출에서 끝까지 실행하는 준비된 레시피:

| Skill | What your agent can do | 
|---|---| 
| [`treg`](skills/treg/SKILL.md) | 카탈로그의 모든 도구와 사용자의 자체 도구를 찾고 호출할 수 있습니다. |
| ... | 

`install.sh`는 `jev-memory`를 제외한 모든 것을 설치합니다 (선택적). 기존 에이전트에 추가하려면 ([skills.sh](https://skills.sh) CLI): 

```bash
npx skills add superdesigndev/treg                        # 모든 공개 스킬
npx skills add superdesigndev/treg --skill lead-signals   # 단일 스킬만
treg skill bootstrap                                      # 동일한 세트, 이미 가지고 있는 treg CLI 사용

워크플로우 스킬은 treg에서 실행되므로 먼저 설정해야 합니다 (위의 Quickstart 또는 에이전트를 treg.to/llms.txt로 지정하세요).

Claude.ai connector

Claude Connectors Directory의 표면(surface)은 https://treg.to/mcp/v2/입니다. 이 경로는 이미지, 비디오 또는 오디오 생성 기능 없이 큐레이션된 카탈로그 엔드포인트만 노출하며, Claude가 정확한 안전 신호(safety signals)를 받을 수 있도록 읽기 호출(read calls)과 쓰기 호출(write calls)을 분리합니다. 기존의 /mcp/ 경로는 카탈로그 엔드포인트, 팀 소유 도구, 그리고 가져온 스킬에 계속 사용할 수 있습니다. 경계와 구현은 MCP 및 OAuth 아키텍처를 참조하고, 릴리스 게이트는 제출 운영 매뉴얼(submission runbook)를 참고하십시오.

키가 없는 도구 호출하기

카탈로그는 엔드포인트가 무엇을 하는지에 따라 그룹화되어 있습니다: 키워드 및 순위 추적, 백링크 및 권위(authority), AI 가시성(visibility), 트렌딩 및 발견(discovery), 소셜 미디어 게시, 인물 및 회사 정보 보강(enrichment), 광고 관리 및 크리에이티브, 측정.

treg catalog                                    # 모든 플랫폼, 사용 빈도 순
treg catalog search "find a work email"         # 공급업체별이 아닌 작업별로
treg catalog search --new                       # 지난 30일간 추가된 도구, 최신순
...

카탈로그화된 호출이 제공되는 방식 — 자격 증명 사다리(credential ladder) 순서:

팀이 해당 공급업체를 위한 자체 도구를 등록한 경우 → 그 도구와 그 키;
팀이 공급업체에 대한 비밀 정보(secret)를 저장한 경우 → 가상 도구를 통해 주입됨;
둘 다 아니며, 엔드포인트가 검증된 공개 경로인 경우 → 공급업체 키 없음, 무료;
그 외의 경우 → treg 자체 키, 팀의 선불 잔액에 청구됩니다.

익명 가격은 호출자가 제공자 자격 증명 헤더를 보내지 않는다고 가정합니다. 신뢰성 있는 릴레이(faithful relay)는 호출자 헤더를 보존하므로, 호출자가 제공한 공급자 키는 해당 키의 크레딧을 사용할 수 있습니다. 사용자의 자체 자격 증명이 항상 treg보다 우선하기 때문에, 이미 비용을 지불하는 키를 연결하면 해당 호출들이 잔액에서 중복으로 청구되는 대신 무료가 됩니다. treg가 공개 가격이 없는 엔드포인트는 무료로 제공되지 않고 거부되며 — 대신 사용자가 자신의 키를 연결하도록 안내받습니다. 여러 공급자가 하나의 기능을 제공할 때, treg catalog search는 해당 기능들을 나란히 가격과 함께 보여줍니다. 선택은 사용자에게 달려 있습니다 — treg가 자동으로 선택하거나 공급자 간에 장애 조치(fail over)를 해주지 않습니다. (만약 treg의 특정 공급자 계정이 고갈된 경우, 응답에 명시되듯이 treg 소유의 릴레이 계정을 통해 동일한 엔드포인트를 제공할 수 있습니다. 팀은 이를 거부하도록 선택할 수 있습니다.) 사용자가 옵트인하는 예외는 treg.<기능> 라우팅된 엔드포인트로, 여기서 treg가 공급자를 대신 선택하고 이름을 지정합니다. 페이지 스크래핑, 웹 검색, Google 결과 찾기, 이메일 찾기와 같은 일반적인 작업의 경우, 이름으로 기억하는 공급자보다는 treg.web.extract나 treg.web.search와 같은 라우팅된 엔드포인트부터 시작하십시오. treg.people.email.find 및 treg.people.phone.find에서는 X-Treg-Route-Verify: true가 동일한 호출에서 발견된 주소나 번호를 자체 비용으로 확인하고 그 결과를 알려줍니다.

treg balance          # 남은 크레딧, 진행 중인 호출, 최근 지출
treg topup            # 자금 추가 또는 자동 충전 설정```

잔액 부족 시에는 `balance_micro`, `estimated_cost_micro` 및 `topup_url`을 포함하는 HTTP **402**가 반환되므로, 에이전트는 문구를 읽지 않고도 이에 대응할 수 있습니다.

**Enrich Arena**는 대시보드 외부의 `/enrich-arena`에서 사용할 수 있습니다. 각 공급업체의 비용과 속도에 맞춰 보강 답변을 비교하고, 클릭 한 번으로 최고의 답변에 투표하거나 순차적인 폭포수(waterfall)를 관찰할 수 있습니다. 기능 호환 비동기(async) 공급업체도 참여하며, Arena가 제출 및 폴링(polling)을 내부적으로 처리합니다. 브라우징은 공개되어 있으며, 제출에는 로그인이 필요하고 과금 대상 시도는 팀의 크레딧을 사용합니다. [Arena 가이드](docs/context/interface/enrich-arena.md)를 참조하세요.

**Web Arena**는 `/web-arena`에서 웹 검색(Web Search), 웹 가져오기(Web Fetch), 사이트맵(Sitemap) 공급업체를 비교합니다. 선택된 공급업체들을 동일한 입력에 대해 배틀 호출(battle calls)하고, 폭포수 방식으로는 순서대로 시도합니다. 실시간 리더보드는 직접적인 공급업체 호출의 히트율과 응답 시간을 누적 30일 기간 동안 확인된 Web Arena 품질 결과와 결합하여 보여줍니다. 해당 기능이 활성화되면 페이지가 열립니다. [Web Arena 가이드](docs/context/interface/web-arena.md)를 참조하세요.

## 자체 도구 공유 및 사용하기

'제로-사고(zero-thought)' 경로는 프로젝트에 treg를 지정하면, 무엇이 공유 가능한지 알아냅니다:

```bash
treg scan     # 읽기 전용 미리보기: 업로드할 키, 스킬 및 CLI 목록을 등록합니다.
treg upload   # 이를 등록합니다 (암호화된 서버 측);멱등성(idempotent)이며, --replace로 업데이트할 수 있습니다.

treg upload는 .env(약 80개의 알려진 공급업체와 키를 일치시킴), 모든 스킬 하위 디렉터리 및 설치된 카탈로그 CLI를 스캔합니다. 레지스트리에는 세 가지 종류의 항목이 포함되는데, 각각을 공유하고 사용하는 방법은 다음과 같습니다:

1. 엔드포인트 (HTTP API)

공유(Share) — 저장된 키로 호출 가능한 하나의 업스트림 URL 또는 .env에서 일괄적으로 공유합니다:

treg secret add STRIPE_KEY --value sk_live_123
treg add stripe --base-url https://api.stripe.com --secret STRIPE_KEY

...

사용(Use) — 에이전트 네이티브 방식: 실제 업스트림 요청을 구성하고 프록시로 접두사(prefix)를 붙입니다. treg는 호스트별로 도구를 확인하고, 자격 증명(credential)을 주입하며, 나머지 모든 것을 충실하게 중계합니다 (업스트림이 볼 때 당신의 X-Treg-Token은 제거됩니다):

실제 요청(Real request): GET https://api.intercom.io/conversations?per_page=5
이를 treg를 통해 호출: GET https://treg.to/call/https://api.intercom.io/conversations?per_page=5
헤더: X-Treg-Token: <your token>

또는 CLI 단축 명령어 — 감사 로그(audit log)를 위한 treg calls:

treg call intercom conversations --query per_page=5
treg call stripe v1/balance

2. CLIs

공유(Share) — 자동 방식: treg upload는 설치된 카탈로그 CLI(stripe, gh, vercel, …)를 감지하고 등록하며, 레시피 전용 카탈로그 CLI 스킬(예: stripe-cli)도 자동으로 실행 가능해집니다.

사용(Use) — treg run은 조직의 자격 증명(credential)이 주입된 상태로 벤더 CLI를 실행하므로, 사용자가 키를 보유하거나 로그인할 필요가 없습니다:

treg run stripe -- get /v1/balance
treg run gh -- pr list
treg run --server agentmail-cli inboxes list   # 레지스트리 서버에서 실행됨: 키가 사용자에게 전달되지 않음

--local(기본값)은 사용자의 기기에서 실행되며, --server는 레지스트리에서 실행되어 출력을 스트리밍합니다. 전체 세션 동안 treg shell start를 실행하면 모든 등록된 CLI가 자동으로 주입되는 서브쉘이 열립니다 — 그냥 평소처럼 stripe, gh, …을 사용하기만 하면 됩니다; exit으로 되돌릴 수 있습니다. treg runs는 감사 로그입니다.

3. Skills

공유(Share) — 스킬은 전체 기능(capability)(SKILL.md 레시피 + 비밀 정보 + 도구(tool))이며, 팀 전체가 동일한 스킬을 실행하고 한 곳에서 관리할 수 있도록 함께 등록됩니다:

treg upload skills --dir ~/.claude/skills --all   # 폴더의 스킬들을 한 번에 등록합니다

사용(Use) — 공유된 스킬을 에이전트에 가져와 사용할 수 있습니다; 이 스킬의 API 호출은 사용자의 토큰과 함께 treg를 통해 전송되므로, 키는 서버에 남아 있고 스킬에는 절대 포함되지 않습니다:

treg skill install seo-blog-writer      # ./.claude/skills/ 에 작성됨  (--all은 라이브러리용)

Treg (도구를 위한 OpenRouter)

요약

핵심 포인트