用途：Clado 提供人物搜索与联系人信息补全 API，适合需要按自然语言条件查找人选、扩展线索或补全邮箱电话的场景。基础地址为 https://search.clado.ai，使用 Bearer Token 认证（环境变量 CLADO_TOKEN）。完整参考见 https://docs.clado.ai/api-reference/introduction。
主要能力：
- 自然语言搜索（同步）：调用 /api/search，传入 query 与 limit，快速返回顶部结果，可解析如“VP of Engineering at series B SaaS companies in the Bay Area”这类描述。
- 深度研究搜索（异步）：POST /api/search/deep_research 启动任务，再轮询 /api/search/deep_research/$JOB_ID 获取状态或结果；可用 POST .../$JOB_ID/more 并传 additional_limit 继续获取更多结果。
- 联系人补全：/api/enrich/contacts 根据已知 linkedin_url 解析邮箱与电话；/api/enrich/scrape 为实时抓取（更新但消耗更多额度）；/api/enrich/linkedin 为缓存档案（更便宜但可能过期）。
- 查询剩余额度：GET /api/credits。
必要用法：所有请求均需在请求头加 Authorization: Bearer $CLADO_TOKEN。同步搜索适合快速获取结果，深度研究适合更深挖掘但为异步。补全时可先用 Clado 得到姓名与 LinkedIn URL，再配合 Hunter 等方式解析邮箱电话。
限制与注意：额度按调用计费，建议缓存结果，按 (linkedin_url, snapshot_date) 组合避免重复查询；数据涉及公开档案信息，批量外联前需确认所在地合规要求（如 GDPR、CASL）。若请求失败，可运行 zero doctor check-connector --env-name CLADO_TOKEN 或 zero doctor check-connector --url https://search.clado.ai/api/credits --method GET 排查。具体价格与更多细节资料暂未提供。