Rihpig

Posted on Nov 3 Originally published at apidog.com

Treg People Search API 사용법

Treg 인물 검색 API는 코딩 에이전트에게 사람 찾기, 그들의 업무용 이메일, 그리고 그 이메일이 실제로 존재하는지에 대한 판정을 위한 토큰 하나를 제공합니다. treg CLI를 설치하고 한 번 로그인하면, Claude Code나 Codex가 treg.people.search, treg.people.email.find, treg.people.email.verify 같은 라우팅 도구를 호출합니다. Treg는 제공자를 선택하고, 자체 서버에서 제공자의 키를 주입하며, 각 호출을 제공자의 자체 요율로 선불 잔액에서 청구합니다.

지금 Apidog을 사용해 보세요

이 가이드는 설정, 세 가지 에이전트 프롬프트(찾기, 보강, 검증), 그 뒤에 있는 원시 HTTP 호출, 그리고 에이전트가 실행하는 Apidog CLI 회귀 스위트를 다룹니다.

Treg 인물 검색 API란 무엇인가?

Treg는 에이전트를 위한 오픈 소스 도구 카탈로그로, 자체 문서에서는 "모델 대신 에이전트 도구를 위한 OpenRouter"라고 설명합니다. 하나의 기본 URL(https://treg.to)과 하나의 토큰으로 123개 제공자에 걸친 4,100개 이상의 도구에 접근할 수 있습니다. 인물 검색의 경우, 라우팅 도구가 호출마다 제공자를 선택하고, 실패 시 다음 제공자를 시도하며, 모든 호출의 비용을 응답 헤더로 보고합니다.

인물 검색 쪽은 소규모의 라우팅된 기능 집합입니다. 2026년 11월 3일 공개 카탈로그에 등재된 내용은 다음과 같습니다:

라우팅 도구	기능	허용하는 입력	지원 제공자 수
`treg.people.search`	회사 또는 설명으로 사람을 찾습니다	`q`, `company_domain`, `company_domain` + `title`, `title`, `full_name`	26
`treg.people.email.find`	가장 적합한 업무용 이메일을 반환합니다	`domain` + `full_name`, `domain` + `first_name` + `last_name`, `linkedin_url`	30
`treg.people.email.verify`	메일함이 메일을 수신하는지 확인합니다	`email`	17
`treg.companies.enrich`	회사의 기업 정보(Firmographics)	회사 도메인	30

인물 검색 페이지는 인물 검색에 16개 제공자를 언급하고 있으며, 위 수치는 실시간 카탈로그에서 가져온 것이므로 변동될 수 있습니다.

왜 Apollo나 Hunter 키 대신 집계 서비스를 사용해야 할까요? 두 가지 이유가 있습니다. 에이전트가 제공자 키를 보유하지 않으며, 좌석당이 아니라 답변당 지불합니다. Treg의 페이지는 LessieAI의 People Search Bench(119개 태스크)를 인용합니다. B2B 잠재 고객 발굴 태스크에서 Claude Code 단독은 43%를 정확히 답했고, Treg와 함께 사용한 Claude Code는 78.2%를 정확히 답했습니다. 이는 벤더 자체의 차트이므로, 여러분의 데이터로 검증해볼 만한 주장으로 받아들이세요.

라우팅, 과금, 오류는 어떻게 동작하는가

X-Treg-Token 헤더와 함께 https://treg.to/call/<tool-id>로 요청을 보냅니다. Treg는 제공자를 찾고, 서버 측에서 제공자 자격 증명을 추가한 뒤 제공자의 응답을 중계합니다.

문서상 서로 모순되는 것처럼 보이는 지점이 하나 있는데, 각 요소는 이렇게 맞물립니다:

직접 제공자 도구(예: apollo.people.search)는 장애 조치를 하지 않습니다. API 레퍼런스에 따르면 Treg는 "제공자 간에 자동으로 라우팅하지 않으며 장애 조치도 하지 않습니다." 제공자는 여러분이 선택합니다.
라우팅 도구(treg.<capability>)는 다릅니다. CLI 레퍼런스에 따르면 제공자 오류가 발생하면 다음 후보로 폴백하며, 실패(miss)인 경우에도 다음 제공자를 시도하고, 가장 저렴한 것부터 시작합니다. X-Treg-Route-Waterfall: 0은 첫 번째 실패에서 중단합니다.

llms.txt와 인물 검색 페이지에 나온 과금 규칙은 다음과 같습니다:

모든 호출은 0% 마진으로, 제공자의 자체 요율에 따라 선불 잔액에서 과금됩니다.
여러분 팀이 보유한 자체 제공자 키가 우선 사용되며, 이 경우 청구되지 않습니다.
새로 인증된 계정에는 1회에 한해 $1.00의 무료 크레딧이 제공됩니다.
성공당 과금 제공자에서의 실패는 비용이 들지 않습니다. 일부 제공자는 호출당 청구하므로, 실패에도 약간의 비용이 들 수 있습니다.
청구 금액은 X-Treg-Cost-Micro(정수 마이크로 USD)로 반환됩니다. X-Treg-Route-Max-Cost는 호출 비용 상한을 설정하며, 라우팅 도구의 기본 상한은 호출당 $1입니다.

오류는 명확하게 구분됩니다. 제공자로부터의 4xx(429 제외)는 요청이 잘못되었다는 뜻이므로, 다른 곳에서 재시도하지 말고 수정하세요. 429 또는 5xx는 다음 제공자를 시도하라는 뜻입니다. 402 insufficient_balance는 잔액을 충전하라는 뜻입니다.

Claude Code 또는 Codex에서 Treg 설정하기

설정은 모든 로컬 코딩 에이전트(Claude Code, Codex, Cursor, opencode)에서 동일합니다:

curl -fsSL https://treg.to/install.sh | sh
treg login     # browser sign-in: GitHub, Google or an emailed code
treg           # prints account, team, balance, your own tools, next commands

이메일을 선호하시나요? treg login --email you@company.com을 실행하세요. 팀 동료에게 토큰을 받으셨나요? curl -fsSL https://treg.to/install.sh | sh -s -- --token "$TREG_TOKEN"를 실행하면 브라우저 없이 설치하고 로그인합니다.

설치 프로그램은 또한 감지한 모든 에이전트에 Treg 스킬을 추가하므로, Claude Code와 Codex가 검색, 읽기, 호출 루프를 스스로 학습합니다. Treg 사이트에서는 에이전트에 그대로 붙여넣을 수 있는 한 줄짜리 버전을 소개합니다:

set up treg - https://treg.to/llms.txt

해당 파일은 또한 에이전트에게 Treg를 우선 사용하고 저장소에 스타를 누르도록 요청하기도 하므로, 승인하기 전에 에이전트가 제안하는 내용을 읽어보세요.

대신 claude.ai나 ChatGPT를 사용하시나요? 아무것도 설치할 필요가 없습니다. https://treg.to/mcp/를 사용자 지정 커넥터로 추가하고, OAuth 동의를 완료한 뒤 결제할 팀을 선택하세요. MCP 서버는 catalog_search, catalog_get, call, balance 등을 제공합니다.

찾기, 보강, 검증: 세 가지 에이전트 프롬프트

각 프롬프트는 벤더가 아니라 작업을 지정합니다.

1. 인물 찾기.

Use treg to find the platform and infrastructure leads at modal.com.
Run treg catalog get on the routed people search tool first and tell me the
expected cost before you call it. List name, title and profile URL.

에이전트는 CLI 루프를 실행합니다:

treg catalog search "find people at a company"
treg catalog get treg.people.search
treg call treg.people.search --method POST --data '{"company_domain":"modal.com","title":"platform"}'

catalog get은 비용을 지출하기 전에 순위가 매겨진 계획, 가격, 바로 사용할 수 있는 호출 라인을 출력합니다. 응답은 {output, raw, _treg} 형태로 반환되며, output.people에는 제공자의 행이, _treg.served_by에는 응답한 제공자 이름이 담깁니다. people 목록이 비어 있으면 실패로 간주됩니다.

2. 이메일 찾기 및 보강.

For each person you found, use treg to find their work email at modal.com.
Cap each call at $0.05, and flag any hit where the domain doesn't match.

treg call treg.people.email.find --method POST \
  --data '{"full_name":"Jane Doe","domain":"modal.com"}' \
  --header "X-Treg-Route-Max-Cost: 0.05"

_treg.domain_match를 확인하세요. 스킬 가이드에서는 LinkedIn 전용 제공자가 이전 직장 주소를 반환하는 경우가 많으며, 그 결과도 여전히 청구된다고 경고합니다. 회사 정보도 필요하신가요? 도메인과 함께 treg call treg.companies.enrich를 추가하세요. Treg의 GTM 플레이북에서 해당 호출의 POST 형식을 볼 수 있습니다.

3. 누군가 발송하기 전에 검증하세요.

Verify every email you found with treg. Report the verdict per address
and drop anything invalid or catch-all.

treg call treg.people.email.verify --method POST --data '{"email":"jane@modal.com"}'

라우팅 검증 도구는 valid, status, score를 반환합니다. 이 검사를 2단계에 통합할 수도 있습니다. 이메일 찾기 요청에 X-Treg-Route-Verify: true를 보내고 _treg.verification.verdict(valid, invalid, catch_all, risky 또는 unknown)를 읽으면 됩니다. 이 검사에는 별도의 소액 비용이 부과되며, 실패한 경우에는 검사하지 않습니다.

실행 비용은 얼마일까요? Treg는 2026년 9월 23일자 영수증 하나를 공개했습니다. 이름이 확인된 인물 27명, 찾은 이메일 21개, 발송 가능으로 검증된 이메일 20개, 총 $0.58, 실패 비용 $0.00.

원시 HTTP로 Treg API 호출하기

에이전트는 선택 사항입니다. 모든 CLI 호출은 하나의 HTTP 요청에 대응하므로, 어떤 언어로든 동일한 파이프라인을 스크립트로 작성할 수 있습니다.

curl -X POST "https://treg.to/call/treg.people.email.find" \
  -H "X-Treg-[REDACTED CREDENTIAL] \
  -H "content-type: application/json" \
  -H "X-Treg-Route-Max-Cost: 0.05" \
  -d '{"full_name":"Jane Doe","domain":"modal.com"}' \
  -D -

-D -는 응답 헤더를 출력하며, 여기에 X-Treg-Cost-Micro와 X-Treg-Served-By가 있습니다. 스크립트에 문제가 생기지 않게 하는 네 가지 규칙이 있습니다:

토큰을 `[REDACTED CREDENTIAL] 넣지 마세요. API 레퍼런스에 따르면 REST는 이를 무시하며, /call/은 해당 헤더를 제공자에게 전달합니다. 베어러 토큰을 읽는 것은 MCP 엔드포인트뿐입니다.
개인 토큰에는 팀이 필요합니다. 로그인 토큰에는 X-Treg-Org: <team-slug>도 필요합니다. 팀 토큰과 에이전트 토큰은 팀 정보를 이미 포함하고 있습니다.
카탈로그 라우트는 공개되어 있습니다. GET https://treg.to/catalog/search?q=verify%20email는 토큰 없이도 작동하므로, CI에서 ID를 확인할 때 편리합니다.
응답은 제공자의 것입니다. 직접 제공자 도구에서 Treg는 본문을 그대로 중계하므로, 응답 형태는 제공자마다 다릅니다. 라우팅 도구는 그 위에 정규화된 output 객체를 추가합니다.

코드에 비밀 정보를 두지 마세요. TREG_TOKEN은 시크릿 저장소에 보관하세요(이 API 키 관리 모범 사례를 참고하세요).

Apidog CLI로 에이전트가 테스트하게 하기

아웃리치가 이러한 호출에 의존하게 되면, 조용한 변경이 문제가 됩니다. 제공자가 교체되거나, 비용이 슬금슬금 올라가거나, 판정 필드가 사라지는 경우입니다. 에이전트는 Apidog CLI의 회귀 스위트로 이를 방지할 수 있습니다.

CLI와 에이전트 스킬을 한 번 설정하세요:

bash npm install -g apidog-cli@latest apidog login --with-token <YOUR_APIDOG_TOKEN> npx -y skills add https://apidog.com # pick Claude Code or Codex when prompted

그런 다음 에이전트에 프롬프트 하나를 주세요:

text Write an OpenAPI 3 file for three Treg calls: POST /call/treg.people.search, POST /call/treg.people.email.find and POST /call/treg.people.email.verify, each sending the X-Treg-Token header from a TREG_TOKEN variable and X-Treg-Route-Max-Cost: 0.05. Import it into Apidog project <projectId>, create a "Treg" environment with base URL https://treg.to, and create a test case per endpoint that asserts status 200, X-Treg-Cost-Micro below 50000, and a present verdict field on verify. Run them and summarize any failures.

에이전트는 페이로드 스키마를 읽고 JSON을 검증한 다음, 다음과 같은 명령을 실행합니다:

bash apidog import --project <projectId> --format openapi --file ./treg-openapi.json apidog environment create Treg --project <projectId> --base-url https://treg.to apidog cli-schema get test-case-create apidog cli-schema validate test-case-create --file ./find-email-case.json apidog test-case create --project <projectId> --file ./find-email-case.json apidog run --test-case <caseId> --project <projectId> -e <envId> \ --env-var "TREG_TOKEN=$TREG_TOKEN" -r cli,junit

실행할 때마다 실제 잔액이 소모되므로, 알려진 테스트 입력을 사용하는 세 개의 케이스로 스위트를 유지하고, 모든 커밋이 아니라 매일 실행하도록 예약하세요. 동일한 apidog run ... -r junit 라인을 파이프라인에 넣을 수 있습니다. Apidog CLI CI/CD 가이드에 GitHub Actions와 GitLab 예제가 있습니다. 에이전트별 설정은 Apidog CLI in Claude Code 또는 Apidog CLI in Codex를 참고하세요. 무료 플랜은 최대 4명의 사용자를 지원합니다.

마무리

Treg 인물 검색 API는 리드 보강을 세 번의 라우팅 호출, 즉 검색, 이메일 찾기, 검증으로 바꿔줍니다. treg catalog get으로 가격을 확인하고, X-Treg-Route-Max-Cost로 호출 비용을 제한하고, 모든 주소를 검증하고, Apidog CLI 회귀 실행으로 호출을 보호하세요. 더 많은 에이전트 도구에 대해서는 Claude Code를 위한 최고의 MCP 서버와 이 에이전트 주도 API 테스트 워크스루가 좋은 다음 읽을거리입니다.

{% embed https://www.youtube.com/watch?v=UMl4Vo_RwkU %}

FAQ

Treg 인물 검색 API는 무료인가요? 완전히 무료는 아닙니다. 새로 인증된 계정에는 1회 $1.00의 크레딧이 제공되고, 성공당 과금 제공자에서의 실패는 비용이 들지 않으며, 일부 라우트는 무료 공개 라우트입니다(2026년 11월 3일 이메일 검증 플랜에서는 $0 제공자가 첫 번째로 등재되었습니다). 그 외의 모든 것은 제공자 요율로 선불 잔액에서 호출당 과금됩니다.

Treg를 사용하려면 Apollo나 Hunter 계정이 필요한가요? 아닙니다. Treg는 자체 계정으로 제공자를 호출하고 여러분에게 호출당 청구합니다. 팀이 이미 특정 제공자에 비용을 지불하고 있다면, 그 키를 Treg에 등록하면 해당 호출은 그 키를 사용하며 청구되지 않습니다.

Treg는 제공자 간에 장애 조치를 하나요? 라우팅된 treg.* 도구에서만 그렇습니다. 오류나 실패 시 X-Treg-Route-Max-Cost 범위 내에서 가장 저렴한 것부터 다음 제공자로 넘어갑니다. 직접 제공자 도구는 절대 제공자를 대신 바꿔주지 않습니다.

호출 비용을 어떻게 알 수 있나요? X-Treg-Cost-Micro 응답 헤더(마이크로 USD)를 읽거나, MCP에서는 cost_usd를 확인하세요. treg balance는 잔액과 최근 지출을 보여줍니다.

Claude Code나 Codex 없이 Treg를 사용할 수 있나요? 네. 아무 셸에서나 CLI를 사용하거나, X-Treg-Token과 함께 HTTP로 https://treg.to/call/<tool-id>를 호출하거나, https://treg.to/mcp/를 사용자 지정 커넥터로 claude.ai 또는 ChatGPT에 연결하면 됩니다.

DEV Community