用途:Homerun 是申请人跟踪系统(ATS),用于管理招聘流程,招聘人员与 HR 可用它发布职位、跟踪候选人并协作招聘决策。本技能用于在用户需要与 Homerun 数据交互时,管理数据、记录并自动化工作流。官方文档:https://homerun.co/api。
主要对象:Job(职位)、Stage(阶段)、Application(申请)、Candidate(候选人)、User(用户)。
使用方式:本技能通过 Membrane CLI 与 Homerun 交互,Membrane 自动处理认证与凭据刷新。安装:npm install -g @membranehq/cli@latest。登录:membrane login --tenant --clientName=<agentType>;无头环境会打印授权 URL,完成后执行 membrane login complete <code>。任意命令加 --json 可获得机器可读输出。
建立连接:membrane connection ensure "https://www.homerun.co/" --json,用户在浏览器完成认证,输出包含连接 id。若状态为 BUILDING,用 npx @membranehq/cli connection get <id> --wait --json 轮询至 READY;若为 CLIENT_ACTION_REQUIRED,按 clientAction 提示操作。
查找与运行动作:membrane action list --connectionId=CONNECTION_ID --intent "QUERY" --limit 10 --json;membrane action run <actionId> --connectionId=CONNECTION_ID --input '{"key": "value"}' --json,结果在 output 字段。
代理请求:当现有动作不覆盖需求时,可用 membrane request CONNECTION_ID /path/to/endpoint 直接调用 Homerun API,Membrane 自动补全基础 URL 并注入认证头。常用选项包括 -X/--method、-H/--header、-d/--data、--json、--rawData、--query、--pathParam。
限制:资料未提供具体动作清单、参数细节、收费与价格信息,需通过 action list 实际发现;不要向用户索取 API 密钥或令牌,应通过连接由 Membrane 服务端管理认证生命周期。