用途:该技能用于与 Search API 交互,管理 Deals、Persons、Organizations、Leads、Projects、Pipelines 等数据,适合开发者或应用在大型数据集中快速查找信息。官方文档为 https://developers.google.com/custom-search/v1/reference/rest。
主要能力:通过 Membrane CLI(npx @membranehq/cli@latest)调用 Search API,Membrane 自动处理认证与凭证刷新。支持发现并运行预置 action,也可通过代理直接请求 API 端点。
使用方式:首次运行 npx @membranehq/cli@latest login --tenant 登录,凭证存于 ~/.membrane/credentials.json。无头环境可复制打印的 URL 供用户打开,再用 npx @membranehq/cli@latest login complete <code> 完成。创建连接:npx @membranehq/cli@latest search search-api --elementType=connector --json,取 connector ID 后执行 npx @membranehq/cli@latest connect --connectorId=CONNECTOR_ID --json,用户在浏览器完成认证。查看已有连接:npx @membranehq/cli@latest connection list --json。查找 action:npx @membranehq/cli@latest action list --intent=QUERY --connectionId=CONNECTION_ID --json。运行 action:npx @membranehq/cli@latest action run --connectionId=CONNECTION_ID ACTION_ID --json,传参用 --input "{ "key": "value" }"。代理请求:npx @membranehq/cli@latest request CONNECTION_ID /path/to/endpoint,支持 -X/--method、-H/--header、-d/--data、--json、--rawData、--query、--pathParam 等选项,也可传完整 URL。
适用场景:需要以安全、少 token 的方式与 Search API 数据交互,或需要预置 action 处理分页、字段映射与错误处理的集成任务。
限制:资料未提供具体 action 清单、收费、价格、平台支持范围及效果数据;建议优先使用 Membrane 预置 action,避免直接索要 API 密钥,由 Membrane 服务端管理认证生命周期。