运行时依赖
安装命令
点击复制技能文档
Workable Workable 是一款 applicant tracking system(ATS),帮助企业管控招聘流程。招聘人员和 HR 用它寻找候选人、追踪申请并协作做出录用决策。 官方文档:https://developers.workable.com/
Workable 概览 职位申请 候选人 用人需求
使用 Workable 本技能通过 Membrane CLI 与 Workable 交互。Membrane 自动处理身份验证与凭证刷新——你只需关注集成逻辑,无需操心授权细节。
安装 CLI 安装 Membrane CLI,以便在终端运行 membrane: npm install -g @membranehq/cli@latest
身份验证
membrane login --tenant --clientName=
若支持交互模式,会打开浏览器;否则在控制台打印授权 URL。
无头环境:命令会打印授权 URL,请用户在浏览器中打开;看到验证码后执行:
membrane login complete
任意命令加 --json 可输出机器可读 JSON。
Agent 类型:claude、openclaw、codex、warp、windsurf 等,用于优化工具以适配你的 harness。
连接 Workable
用 membrane connection ensure 通过应用 URL 或域名查找或创建连接:
membrane connection ensure "https://www.workable.com/" --json
用户在浏览器完成授权,输出包含新连接 id。
URL 会被规范化为域名并与已知应用匹配;未找到则自动创建并构建连接器。
若返回状态为 "READY",直接跳到第 2 步。
1b. 等待连接就绪
若状态为 BUILDING,轮询直至就绪:
npx @membranehq/cli connection get --wait --json
--wait 最长轮询 --timeout 秒(默认 30),直到状态变化。
结果状态说明:
READY — 连接完成,跳到第 2 步。
CLIENT_ACTION_REQUIRED — 需用户或 agent 操作,clientAction 对象描述所需动作:
clientAction.type
"connect" — 需用户授权(OAuth、API key 等)。
"provide-input" — 需补充信息。
clientAction.description — 人类可读说明。
clientAction.uiUrl(可选)— 可展示的预构建 UI 地址。
clientAction.agentInstructions(可选)— 给 AI agent 的程序化指引。
用户完成后再次执行 membrane connection get --json 检查是否变为 READY。
CONFIGURATION_ERROR 或 SETUP_FAILED — 出错,查看 error 字段。
搜索动作
用自然语言描述需求并搜索:
membrane action list --connectionId=CONNECTION_ID --intent "QUERY" --limit 10 --json
务必在指定连接上下文中搜索。结果包含 id、name、description、inputSchema、outputSchema。
常用动作
名称 | 键 | 描述
Get Candidate Activities | get-candidate-activities | 返回指定候选人的活动日志。
Revert Candidate Disqualification | revert-candidate-disqualification | 撤销候选人淘汰状态,将其退回招聘流程。
List Members | list-members | 返回账户内所有团队成员列表。
List Departments | list-departments | 返回账户内所有部门列表。
List Stages | list-stages | 返回账户内所有招聘阶段列表。
Tag Candidate | tag-candidate | 更新候选人标签。
Add Comment to Candidate | add-candidate-comment | 给候选人添加备注。
Disqualify Candidate | disqualify-candidate | 淘汰候选人。
Move Candidate to Stage | move-candidate | 将候选人移至另一阶段。
Update Candidate | update-candidate | 更新候选人信息。
Create Candidate | create-candidate | 为指定职位新建候选人。
Get Candidate | get-candidate | 按 ID 获取候选人详情。
List Candidates | list-candidates | 返回候选人集合。
Get Job Stages | get-job-stages | 返回指定职位的招聘阶段。
Get Job | get-job | 按短码返回职位详情。
List Jobs | list-jobs | 返回 Workable 账户内的职位集合。