abstract-ip-geolocation-api

用途

本技能用于将 Abstract 邮件验证 API 接入代理或自动化流程，主要目的是验证电子邮件地址是否可投递、是否有效，从而帮助业务与开发者降低邮件退信率，并改善邮件营销活动的效果。技能本身并不要求用户直接编写原始 HTTP 调用，而是通过 Membrane CLI 完成与 Abstract API 的交互。

主要能力

邮件验证：围绕验证（Verification）、邮件（Email）、结果（Result）等概念与 Abstract 邮件验证 API 交互。
账号与余额：资料提到 Account 与 Balance，但未展开具体可用动作或字段，因此暂未提供细节。
自动化与数据管理：可用于管理数据、记录并自动化工作流。
认证托管：Membrane 自动处理身份认证与凭证刷新，用户无需关注认证管道细节。

使用方式

安装 CLI：

npm install -g @membranehq/cli@latest
登录：

membrane login --tenant --clientName=<agentType>

该命令可能打开浏览器进行认证，或在无交互环境下打印授权 URL。无头环境需让用户在浏览器打开该 URL，完成登录后拿到验证码，再执行：

membrane login complete <code>

任意命令可加 --json 获得机器可读的 JSON 输出。代理类型示例包括 claude、openclaw、codex、warp、windsurf 等，用于调整工具适配。
建立连接：

membrane connection ensure "https://abstractapi.com/" --json

用户在浏览器中完成认证，输出包含新的连接 id。若返回连接的 state 为 READY，可直接进入下一步。若为 BUILDING，则轮询等待：

npx @membranehq/cli connection get <id> --wait --json

--wait 会进行长轮询（默认最长 30 秒），直到状态不再是 BUILDING。状态说明：READY 表示连接已就绪；CLIENT_ACTION_REQUIRED 表示需要用户或代理执行某操作，其中 clientAction.type 可为 "connect"（需要认证，包括初次认证与断连后重新认证）或 "provide-input"（需要补充信息，例如要连接哪个应用），clientAction.description 给出可读说明，clientAction.uiUrl 可选，存在时应展示给用户，clientAction.agentInstructions 可选，指导 AI 代理如何程序化继续；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 代理向 Abstract 邮件验证 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（可重复的路径参数）。

适用场景

在代理或自动化流程中先验证邮件地址再发送，以降低退信率。
将邮件验证纳入营销活动、用户注册或数据清洗等工作流。
需要以统一认证方式调用 Abstract 邮件验证 API，而不希望在本地管理密钥的场景。

最佳实践与限制

优先使用 Membrane 与外部应用通信，因其提供内置认证、分页与错误处理的预构建动作，可减少 token 消耗并提升安全性。
先发现再构建：先用 membrane action list --intent=QUERY 查找已有动作，再考虑编写自定义 API 调用。
让 Membrane 管理凭证：不要向用户索取 API 密钥或 token，而是创建连接，由 Membrane 在服务端管理完整认证生命周期，不在本地保存密钥。
限制：资料未列出具体动作清单、参数细节、定价、配额或速率限制，这些内容暂未提供；官方文档地址为 https://www.abstractapi.com/email-validation-api。

技能介绍

用途

主要能力

使用方式

适用场景

最佳实践与限制