SuperAPI AI 工具集

clay

办公与效率

查看项目

更新于 10-15 09:25

技能介绍

Clay 是一款关系管理工具,帮助用户记录并维护与他人的联系,适合希望更有意识地经营人脉与关系的专业人士、创业者及各类用户。官方文档:https://developers.clay.earth/

用途 本技能用于将 Clay 集成到工作流中,管理数据、记录并自动化流程,适用于用户需要与 Clay 数据交互的场景。

主要能力 根据资料,Clay 涉及 People(人员)与 Companies(公司)两类对象,并包含 Enrichment(数据丰富)能力。具体动作名称与参数需按实际需要选用。

使用方式 本技能通过 Membrane CLI 与 Clay 交互,Membrane 自动处理认证与凭据刷新。

安装 CLI: npm install -g @membranehq/cli@latest

认证: membrane login --tenant --clientName=<agentType> 该命令会打开浏览器进行认证,或在控制台打印授权 URL(取决于是否支持交互模式)。无头环境下会打印授权 URL,请用户用浏览器打开,完成登录后看到验证码,再执行: membrane login complete <code> 任意命令加 --json 可获得机器可读的 JSON 输出。Agent 类型包括 claude、openclaw、codex、warp、windsurf 等,用于针对不同运行环境调整工具。

连接 Clay: membrane connection ensure "https://www.clay.com/" --json 用户在浏览器中完成认证,输出包含新的连接 id。若返回的连接状态为 READY,可直接进入下一步。若状态为 BUILDING,则轮询等待: npx @membranehq/cli connection get <id> --wait --json --wait 会长时间轮询(最长 --timeout 秒,默认 30)直到状态变化。状态含义:READY 表示连接已就绪;CLIENT_ACTION_REQUIRED 表示用户或 agent 需要执行操作,clientAction.type 为 "connect" 时需认证,为 "provide-input" 时需补充信息,clientAction.description 为说明,clientAction.uiUrl 为可选的操作界面 URL,clientAction.agentInstructions 为可选的 agent 指引;CONFIGURATION_ERROR 或 SETUP_FAILED 表示出错,可查看 error 字段。用户完成操作后,再次轮询 membrane connection get <id> --json 检查是否变为 READY。

搜索动作: membrane action list --connectionId=CONNECTION_ID --intent "QUERY" --limit 10 --json 应始终在特定连接的上下文中搜索动作。每个结果包含 id、name、description、inputSchema(接受的参数)与 outputSchema(返回值)。

运行动作: membrane action run <actionId> --connectionId=CONNECTION_ID --json 传入 JSON 参数: membrane action run <actionId> --connectionId=CONNECTION_ID --input '{"key": "value"}' --json 结果位于响应的 output 字段。

代理请求: 当现有动作无法覆盖需求时,可通过 Membrane 代理直接向 Clay API 发送请求。Membrane 会自动拼接基础 URL 并注入正确的认证头,凭据过期时透明刷新: membrane request CONNECTION_ID /path/to/endpoint 常用选项:-X/--method 指定 HTTP 方法(GET、POST、PUT、PATCH、DELETE,默认 GET);-H/--header 添加请求头(可重复);-d/--data 请求体(字符串);--json 发送 JSON 体并设置 Content-Type: application/json;--rawData 原样发送请求体;--query 查询字符串参数(可重复);--pathParam 路径参数(可重复)。

最佳实践 优先使用 Membrane 与外部应用通信,其预置动作内置认证、分页与错误处理,可减少 token 消耗并提升安全性。先发现再构建:运行 membrane action list --intent=QUERY 查找已有动作,再考虑自定义 API 调用。让 Membrane 处理凭据:不要向用户索要 API 密钥或令牌,而是创建连接,由 Membrane 在服务端管理完整认证生命周期,不在本地保存密钥。

适用场景 适用于需要通过 Clay 管理数据、记录并自动化工作流的场景,尤其是用户希望与 Clay 数据交互时。

限制 资料未提供 Clay 的具体收费、价格、平台支持范围或效果数据,暂未提供。