Hassann

Posted on Nov 3 Originally published at apidog.com

How to Use Treg People Search API?

如何使用 Treg 人脉搜索 API？

Treg 人脉搜索 API 为你的编码智能体（coding agent）提供了一个统一的 token，用于查找人脉、他们的工作邮箱，以及判断这些邮箱是否真实有效的结论。你只需安装 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）和一个 token 即可访问 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 的人脉搜索基准测试（119 个任务）：在其 B2B 潜客挖掘任务中，仅使用 Claude Code 的正确率为 43%，而使用 Claude Code + Treg 的正确率为 78.2%。这是供应商自己提供的数据，因此应将其视为值得在你自己的数据上进行测试的结论。

路由、计费和错误处理机制

你可以向 https://treg.to/call/<tool-id> 发送请求并携带 X-Treg-Token 请求头。Treg 会查找服务商，在服务器端添加服务商凭证，并中转服务商的响应。

文档中有一点看似矛盾，以下是各部分的实际运作方式：

直接服务商工具（例如 apollo.people.search）不会进行故障转移（fail over）。API 参考文档指出 Treg“不会在服务商之间自动路由，也不会进行故障转移”。需要你自己选择服务商。
路由工具（treg.<capability>）支持故障转移。根据 CLI 参考文档，服务商发生错误时会回退到下一个候选服务商，未命中结果时也会尝试下一个服务商（优先尝试价格更低的）。设置 X-Treg-Route-Waterfall: 0 可以在首次未命中时停止尝试。

来自 llms.txt 和人脉搜索页面的计费规则：

每次调用都按照服务商自身的费率从预付余额中计费，且无任何加价。
你团队自己的服务商密钥会被优先使用，且永不计费。
新验证的账户将一次性获得 1.00 美元的免费额度。
对于按成功计费的服务商，未命中不产生任何费用；但有些服务商是按调用次数计费的，因此未命中也可能会产生少量费用。
费用信息将通过 X-Treg-Cost-Micro（整数微美分，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     # 浏览器登录：GitHub、Google 或邮箱验证码
treg           # 打印账户、团队、余额、你自己的工具、后续命令

偏好使用邮箱？运行 treg login --email you@company.com。获取了队友分享的 token？运行 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 并给仓库加星（star），因此在批准之前，请仔细阅读你的智能体提出的建议。

使用 claude.ai 或 ChatGPT？无需安装任何东西。将 https://treg.to/mcp/ 添加为自定义连接器（custom connector），完成 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 就在其中。以下四个规则可以让你的脚本避免陷入困境：

千万不要把 token 放在 `[REDACTED CREDENTIAL] 中。API 参考文档指出 REST 接口会忽略它，并且 /call/ 会将该请求头转发给服务商。只有 MCP 端点会读取 Bearer [REDACTED]。
个人 token 需要指定团队。登录 token 还需要 X-Treg-Org: <team-slug>。团队和智能体 token 已自带其团队信息。
目录路由是公开的。GET https://treg.to/catalog/search?q=verify%20email 无需 token 即可访问，这便于在 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.

智能体会读取负载（Payload）模式（Schema），验证其 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 的示例。针对特定智能体的设置，请参阅 Claude Code 中的 Apidog CLI 或 Codex 中的 Apidog CLI。免费版计划最多支持 4 个用户。

总结

Treg 人脉搜索 API 将潜客信息补全简化为了三个路由调用：搜索、邮箱查找、校验。使用 treg catalog get 检查价格，使用 X-Treg-Route-Max-Cost 限制调用成本，校验每一个邮箱地址，并通过 Apidog CLI 回归测试来保护这些调用。关于更多智能体工具，Claude Code 的前 10 个 MCP 服务器以及这篇智能体驱动的 API 测试实战是不错的后续阅读材料。

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

常见问题

Treg 人脉搜索 API 是免费的吗？并非完全免费。新验证的账户将一次性获得 1.00 美元的额度，对于按成功计费的服务商，未命中不产生任何费用；此外，有些路由属于免费的公共路由（在 2026 年 11 月 3 日，邮箱校验方案首先列出了一个 0 美元的服务商）。其他所有调用都会按照服务商的费率从预付余额中按次计费。

使用 Treg 需要有 Apollo 或 Hunter 账户吗？不需要。Treg 使用其自己的账户调用服务商，并按次向你收费。如果你的团队已经付费购买了某家服务商的服务，向 Treg 注册该密钥后，这些调用将使用该密钥且不会计费。

Treg 是否支持在服务商之间进行故障转移？仅在路由 treg.* 工具上支持。在发生错误或未命中时，它们会在 X-Treg-Route-Max-Cost 限制内，优先尝试价格更低的服务商。直接服务商工具从不会为你切换服务商。

我如何知道一次调用的费用？读取 X-Treg-Cost-Micro 响应头（微美元，micro-USD），或者通过 MCP 读取 cost_usd。treg balance 会显示你的余额和近期支出。

我可以在不使用 Claude Code 或 Codex 的情况下使用 Treg 吗？可以。你可以在任何 Shell 中使用 CLI，通过 HTTP 携带 X-Treg-Token 调用 https://treg.to/call/<tool-id>，或者将 https://treg.to/mcp/ 作为自定义连接器连接到 claude.ai 或 ChatGPT。

DEV Community