SuperAPI AI 工具集

clay-sdk-patterns

编程与开发

查看项目

更新于 10-15 22:42

技能介绍

用途:Clay 没有官方 SDK,本技能把 Clay 的三类交互方式——入站 webhook、Clay 内部的 HTTP API 富化列、Enterprise API 的程序化查询——封装为可靠可复用的生产级代码模式,适合构建 Clay 集成、实现 webhook 处理器与批量数据传入。

主要能力:提供 TypeScript 与 Python 两种客户端封装,包含 sendToTable(向 Clay 表发送单条记录)、sendBatch(带延迟的批量发送与限流)、enrichPerson 与 enrichCompany(按邮箱或域名补充人员/公司信息);内置指数退避重试、429 时按 Retry-After 等待、超时控制(AbortController/httpx timeout)、Enterprise API key 缺失时提前报错、单例复用、Webhook 回调处理器(立即返回 200 再异步处理),以及人员/公司富化结果的类型定义与 ClayWebhookError 错误类型。

使用方式:先完成 clay-install-auth,再按示例创建客户端并以环境变量传入 CLAY_WEBHOOK_URL 与 CLAY_API_KEY,通过 getClayClient() 复用实例。

限制:Enterprise API 需要 Enterprise 套餐与 API key;webhook 仅入站,HTTP API 用于 Clay 端出站富化;HTTP 200 确认不代表下游富化已完成;日志需脱敏 webhook URL、凭证及不必要线索属性。