AI 직원한테 인터넷 검색 공짜로 시키기 (treg 웹 액세스)

1. treg가 뭐예요

한 줄로: AI 에이전트(알아서 일하는 AI 직원)가 여러 업체의 도구를 키 하나로 부르게 해 주는 공개 저장소예요. README 첫 문장이 "OpenRouter, but for agent tools instead of models"예요.

왜 필요한가: 에이전트가 인터넷을 보려면 Exa·Tavily·Serper 같은 검색 API(검색 서비스)를 따로 붙여야 하고, 보통 부를 때마다(호출당) 요금이 나가요. 업체마다 가입하고 키를 받는 대신, treg 키 하나로 "검색해 줘"만 부르면 treg가 업체를 골라 줘요. 마트 계산대에 비유하면, 여러 가게 물건을 계산대 하나에서 계산하는 셈이에요.

• 저장소: https://github.com/superdesigndev/treg (별 약 6.4천, 2026-10-28)
• 사이트: https://treg.to

2. 설치하기

따라 하기

1. 터미널(맥: 터미널, 윈도우: WSL 또는 Git Bash)을 열어요.
2. 설치 명령을 붙여넣어요.
3. 로그인해요. 기본은 GitHub 계정이고, 이메일 코드(--email)나 토큰(--token)도 돼요.
4. 잔액을 확인해요.

curl -fsSL https://treg.to/install.sh | sh
treg login
treg balance

처음이라 막막하면 안내형 설치가 있어요: treg onboard

클로드 코드에서 쓰는 경우 — 클로드 코드 입력칸에 두 줄을 차례로 넣고, /mcp 에서 treg를 골라 로그인해요.

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

다른 AI 코딩 도구 — skills 도구로 넣어요.

npx skills add superdesigndev/treg -s treg

웹 액세스 스킬만 넣고 싶으면 README의 --skill 형식대로 npx skills add superdesigndev/treg --skill web-access 를 써요. 설정 방법 전체는 https://treg.to/llms.txt 에 있어요.

확인하는 법 (web-access SKILL.md 'Check the setup')

treg --version && treg balance
treg call treg.web.search --data '{"q":"treg web access"}' --header 'X-Treg-Route-Prefer: tinyfish'

결과에 _treg.served_by 가 있고 요금이 안 붙었으면 무료 검색이 되는 거예요.

막히면

• treg: command not found → 설치 뒤 터미널을 새로 열어요.
• 이름이 비슷한 다른 패키지를 받지 않게, 저장소 이름 superdesigndev/treg 를 꼭 확인해요.

3. 무료로만 쓰는 설정

한 줄로: 검색·페이지 읽기를 부를 때 헤더 X-Treg-Route-Prefer: tinyfish 를 붙이면 무료 업체 TinyFish부터 써요.

무료 검색

treg call treg.web.search --data '{"q":"[찾을 말]"}' --header 'X-Treg-Route-Prefer: tinyfish'

무료 페이지 읽기 (페이지를 마크다운으로)

treg call treg.web.extract --data '{"url":"[읽을 주소]"}' --header 'X-Treg-Route-Prefer: tinyfish'

여러 페이지를 한 번에 무료로 — 주소 최대 10개. 이 방법은 다음 업체로 넘어가지 않아서 요금이 안 붙어요.

treg call tinyfish.web.fetch --data '{"urls":["[주소1]","[주소2]"]}'

왜 '무료부터'인데 돈이 나갈 수 있나요? treg.web.search·treg.web.extract 는 "다음 업체로 알아서 넘기는"(routed) 창구예요. TinyFish가 비어 있거나 막히면 Crawl4AI, AnyAPI … 순서로 넘어가고, 답을 준 업체 + 그 앞에서 빗나가도 요금을 받는 업체의 요금을 내요. 그래서 다음 장의 상한이 필요해요.

무료가 아닌 것: SNS·쇼핑몰·리뷰·지도 같은 플랫폼 데이터 — 건당 센트 또는 센트 미만이에요.

4. 금액 상한 거는 법

한 줄로: 호출마다 X-Treg-Route-Max-Cost: <달러> 헤더를 붙이면 그 금액을 넘는 업체로는 넘어가지 않아요.

왜: 상한이 없으면 한 번 빗나갈 때 업체를 거치며 최대 1달러까지 갈 수 있다고 공식 문서에 적혀 있어요. 여러 번 돌리는 배치는 "항상 Max-Cost를 보내라"고 해요.

treg call treg.web.search --data '{"q":"[찾을 말]"}' \
  --header 'X-Treg-Route-Prefer: tinyfish' \
  --header 'X-Treg-Route-Max-Cost: [0.01]'

[0.01] 은 예시 값이에요. 내 예산에 맞게 바꾸세요.

잔액·요금 확인

treg balance

잔액이 0이면 HTTP 402 insufficient_balance 오류와 충전 주소(topup_url)가 와요. 새 인증 계정은 조건을 갖춘 팀을 만들 때 1달러를 한 번 받아요 (README).

5. 가격표 읽는 법 (Web Arena)

https://treg.to/web-arena 아래쪽 Provider leaderboard → Price 가 검색 업체 가격표예요. 로그인 없이 보여요.

• 'cheapest first' — 싼 순서로 정렬돼 있어요. 단위가 다른 줄(/result)은 바로 비교할 수 없어요.
• 표에는 검색 업체 18곳이 있어요. 값은 바뀔 수 있으니 쓰기 전에 다시 보세요.

6. 알고 쓰기

• 라이선스: Apache 2.0 + 추가 조건. 내 조직 안에서 쓰고 고치는 건 되지만, 남에게 호스팅·관리형 서비스로 파는 건 사전 서면 허락이 필요해요.
• 직접 깔아 쓰기: README에 "anyone can self-host"라고 돼 있어요. 다만 직접 깔았을 때 무료 경로가 그대로 되는지는 확인하지 못했어요.
• 무료 경로의 사용량 한도: 공식 문서에서 확인하지 못했어요.
• 사용 통계: CLI는 익명 사용 통계를 보낸다고 저장소 기록에 적혀 있어요.
• 아끼는 습관 (SKILL.md): 페이지는 마크다운으로 읽고, 검색한 뒤 필요한 결과만 읽고, 플랫폼 데이터는 HTML 긁기 대신 플랫폼 전용 작업을 쓰고, 사실마다 출처 주소를 남겨요.

체크리스트

• treg --version && treg balance 가 나온다
• 검색·페이지 읽기에 X-Treg-Route-Prefer: tinyfish 를 붙였다
• 모든 호출(특히 배치)에 X-Treg-Route-Max-Cost 를 걸었다
• SNS·쇼핑몰·지도 데이터는 유료라는 걸 안다
• 쓴 뒤 treg balance 로 나간 돈을 봤다

출처 (모두 2026-10-28 확인)

• treg 저장소 README·LICENSE: https://github.com/superdesigndev/treg
• web-access SKILL.md: https://github.com/superdesigndev/treg/blob/main/skills/web-access/SKILL.md
• Web Arena 가격표: https://treg.to/web-arena
• 설정 안내: https://treg.to/llms.txt