用途:Gender API 用于根据姓名推断性别,常被企业与研究者用于人口统计分析、营销个性化和数据校正。本技能通过 Membrane CLI 与其交互,由 Membrane 负责认证与凭据刷新,使用者只需关注集成逻辑。
主要能力(动作):get-statistics 查询账户用量统计与剩余请求额度;get-country-of-origin 根据姓名推断可能的来源国与族群背景;get-gender-batch 单次请求批量查询多个姓名的性别;get-gender-by-email 从邮箱地址提取姓名并判断性别;get-gender-by-full-name 自动拆分全名并判断性别;get-gender-by-first-name 根据名字判断性别,支持可选的国家本地化以提升准确度。官方文档见 https://gender-api.com/en/api-docs。
安装与认证:安装 CLI 使用 npm install -g @membranehq/cli@latest;登录使用 membrane login --tenant --clientName=<agentType>,交互模式会打开浏览器,无头环境会打印授权 URL,用户完成登录后运行 membrane login complete <code>。任意命令加 --json 可获得机器可读输出。
连接:membrane connection ensure "https://gender-api.com/" --json 可查找或创建连接,用户在浏览器完成认证后输出连接 id。若状态为 BUILDING,可用 npx @membranehq/cli connection get <id> --wait --json 轮询,直到状态不再为 BUILDING。READY 表示可用;CLIENT_ACTION_REQUIRED 表示需用户或代理执行动作,其 clientAction 说明所需操作;CONFIGURATION_ERROR 或 SETUP_FAILED 则需查看 error 字段。
查找与运行动作:membrane action list --connectionId=CONNECTION_ID --intent "QUERY" --limit 10 --json 按自然语言查找动作,结果含 id、name、description、inputSchema、outputSchema。运行使用 membrane action run <actionId> --connectionId=CONNECTION_ID --json,传参加 --input '{"key": "value"}',结果在返回的 output 字段中。
代理请求:当现有动作不满足需求时,可通过 Membrane 代理直接请求 Gender API:membrane request CONNECTION_ID /path/to/endpoint,常用选项包括 -X/--method、-H/--header、-d/--data、--json、--rawData、--query、--pathParam。
最佳实践与限制:优先使用 Membrane 与外部应用通信,利用预置动作的内置认证、分页与错误处理以节省 token 并提升安全性;先查找再自行编写调用;不要让用户提供 API 密钥或令牌,改用连接方式,由 Membrane 服务端管理完整认证生命周期,不保留本地密钥。