Notarize 简介
Notarize 是一个允许用户在线合法公证文件的平台，主要服务于房地产、法律和金融服务领域需要安全便捷公证的个人与企业。官方开发者文档：https://www.notarize.com/developers
用途
该技能用于与 Notarize 平台进行集成，管理文档、模板、工作流、用户和角色。当用户需要与 Notarize 数据交互时使用。涉及的实体包括：公证、文档、签署人、模板、工作区、集成、用户。
使用方式
该技能通过 Membrane CLI 与 Notarize 交互，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 等。
- 连接 Notarize
使用 membrane connection ensure 通过应用 URL 或域名查找或创建连接：
membrane connection ensure "https://notarize.com" --json
用户在浏览器中完成认证，输出包含新的连接 id。若返回的连接状态为 READY 则跳至下一步；若为 BUILDING 则轮询等待：
npx @membranehq/cli connection get <id> --wait --json
--wait 标志会最多长轮询 --timeout 秒（默认 30）直到状态变化。状态为 READY 表示连接已完全建立；CLIENT_ACTION_REQUIRED 表示需要用户或代理执行操作，clientAction 对象描述所需操作（type 为 connect 表示需要认证，provide-input 表示需要更多信息，uiUrl 为可选的操作界面 URL，agentInstructions 为可选的代理指令）；CONFIGURATION_ERROR 或 SETUP_FAILED 表示出错，需查看 error 字段。
- 搜索操作
membrane action list --connectionId=CONNECTION_ID --intent "QUERY" --limit 10 --json
应在特定连接上下文中搜索操作。每个结果包含 id、name、description、inputSchema 和 outputSchema。也可使用：
npx @membranehq/cli@latest action list --intent=QUERY --connectionId=CONNECTION_ID --json
- 运行操作
membrane action run <actionId> --connectionId=CONNECTION_ID --json
传入 JSON 参数：
membrane action run <actionId> --connectionId=CONNECTION_ID --input '{"key": "value"}' --json
结果位于响应的 output 字段中。
- 代理请求
当可用操作无法覆盖用例时，可通过 Membrane 代理直接向 Notarize API 发送请求。Membrane 会自动追加基础 URL 并注入正确的认证头，包括凭证过期时的透明刷新：
membrane request CONNECTION_ID /path/to/endpoint
常用选项包括 -X/--method（HTTP 方法，默认 GET）、-H/--header（添加请求头，可重复）、-d/--data（请求体字符串）、--json（发送 JSON 体并设置 Content-Type）、--rawData（原样发送）、--query（查询字符串参数，可重复）、--pathParam（路径参数，可重复）。
最佳实践
优先使用 Membrane 与外部应用通信，它提供内置认证、分页和错误处理的预构建操作。在编写自定义 API 调用前先用 membrane action list --intent=QUERY 发现现有操作。让 Membrane 处理凭证，不要向用户索要 API 密钥或令牌，而是创建连接，由 Membrane 在服务端管理完整的认证生命周期。
适用场景
适用于需要通过编程方式管理 Notarize 文档、模板、工作流、用户和角色的场景，例如自动化公证流程或与其他系统集成。
限制
资料未提供 Notarize 的具体功能细节、收费模式、支持平台或效果说明，这些信息暂未提供。