用途:Clay是网页版数据增强平台,无SDK可装,集成依赖Webhook地址、HTTP API增强列与Enterprise API。本技能用于完成账户接入、密钥管理与供应商连接配置。
主要能力:获取并验证Enterprise API密钥;为Clay表配置Webhook入站地址并发送测试记录;连接150+数据供应商的自身API密钥以节省Clay积分;生成管理本地.env变量;为Webhook端点添加共享密钥校验。
必要用法:Enterprise密钥在Settings > API中获取,需Enterprise订阅,仅支持人员与公司数据查询,非通用表格API。验证命令:curl -s -X POST "https://api.clay.com/v1/people/enrich" -H "Authorization: Bearer $CLAY_API_KEY" -H "Content-Type: application/json" -d '{"email": "test@example.com"}' | jq .。Webhook在表中通过+ Add > Webhooks > Monitor webhook生成,发送命令:curl -X POST "$CLAY_WEBHOOK_URL" -H "Content-Type: application/json" -d '{...}'。供应商密钥在Settings > Connections添加;使用自有密钥不消耗Clay积分。
限制与错误处理:401表示密钥无效需重新生成;403表示功能不在当前套餐;422为Webhook载荷格式错误;429为Explorer套餐限每小时400条,需节流或升级;Webhook删除表或超5万次提交后失效;供应商连接失败需在第三方后台核对密钥。
安全要求:API密钥、Webhook地址、供应商凭据与.env内容不得进入仓库、工单、shell历史或通用文档,应使用密钥管理器并记录轮换责任人。
后续步骤:认证完成后可进入clay-hello-world发送首次增强。