huntflow-mcp

Huntflow 的 MCP 服务——通过 AI 处理职位、候选人和简历 ATS

如果你想知道如何将 Huntflow 接入神经网络、查找候选人并阅读其简历，而无需在 ATS 中逐个浏览卡片，这就是你要找的工具。14 个工具和 2 个技能：职位、候选人、简历、招聘阶段、参考目录、账号。询问“谁卡在技术面试阶段了”，即可获得名单，而不是 CSV 导出文件。

属于 WWmcp 系列（46 个服务）。

安装

Claude Desktop（stdio）

{
  "mcpServers": {
    "huntflow": {
      "command": "npx",
      "args": ["-y", "@theyahia/huntflow-mcp"],
      "env": {
        "HUNTFLOW_TOKEN": "ваш-access-token",
        "HUNTFLOW_REFRESH_TOKEN": "ваш-refresh-token"
      }
    }
  }
}

Streamable HTTP

HUNTFLOW_TOKEN=ваш-токен npx @theyahia/huntflow-mcp --http
# POST /mcp, GET /health на 127.0.0.1:3000 (PORT=...)

Smithery

npx @smithery/cli install @theyahia/huntflow-mcp

获取令牌

HuntFlow 设置 → “API-токены”（API Tokens） 标签页 → 创建令牌。生成的令牌对包含 access 令牌（有效期约 7 天）和 refresh 令牌（约 14 天）。令牌过期时，服务会通过 POST /token/refresh 自动刷新 access 令牌，并将轮换后的令牌对保存到状态文件（HUNTFLOW_TOKEN_FILE），因此重启后仍可使用。如果只设置 HUNTFLOW_TOKEN，而不设置 refresh 令牌，服务将运行至 access 令牌过期（约 7 天），之后需要获取新令牌。

环境变量

变量	必填	描述
HUNTFLOW_TOKEN	是	Access 令牌（设置 → API-токены）
HUNTFLOW_REFRESH_TOKEN	否	Refresh 令牌——启用遇到 401 时自动刷新
HUNTFLOW_TOKEN_FILE	否	用于存储轮换后的令牌对的文件（默认 ~/.huntflow-mcp/token.json）
HUNTFLOW_BASE_URL	否	默认 https://api.huntflow.ru/v2
HUNTFLOW_USER_AGENT	否	User-Agent（API 必需；有默认值）
HUNTFLOW_TIMEOUT_MS	否	请求超时时间，毫秒（默认 10000）
HUNTFLOW_DISABLE_RATELIMIT	否	1——禁用客户端限流（10 req/s）
PORT	否	HTTP 服务端口（默认 3000）
HUNTFLOW_HTTP_HOST	否	HTTP 绑定主机（默认 127.0.0.1）
HUNTFLOW_HTTP_SECRET	否	设置后，访问 /mcp 时必须提供 Authorization: Bearer <secret>
HUNTFLOW_ALLOWED_HOSTS	否	用于防范 DNS 重绑定的 host:port 列表

工具（14 个）

工具	描述
list_accounts	可用账号列表
list_vacancies	职位列表（筛选条件 opened/state/mine，支持分页）
get_vacancy	职位完整信息
search_applicants	搜索候选人（q + vacancy/status/tag 筛选条件）
list_vacancy_applicants	附属于指定职位的候选人
get_applicant	候选人完整信息
get_applicant_resumes	候选人简历（external）列表
get_resume	指定简历（external）的完整内容
list_stages	招聘流程阶段（职位状态）
list_coworkers	账号员工/招聘人员
list_sources	候选人来源参考目录
list_rejection_reasons	拒绝原因参考目录
list_divisions	部门参考目录
list_tags	标签参考目录

列表工具会返回经过筛选的字段集（节省令牌）以及 structuredContent；传入 raw: true 可获取完整原始响应。分页参数为 page/count。

技能（Prompts）

技能	描述
skill-applicants	职位候选人——包含阶段和摘要的表格
skill-vacancy-stats	职位统计——招聘漏斗、时长、转化率

开发

npm install
npm test           # vitest
npm run typecheck  # tsc --noEmit
npm run lint       # eslint
npm run format     # prettier --write
npm run dev        # tsx src/index.ts
npm run build      # tsc

许可证

MIT

---

属于 WWmcp · Telegram： @vhodvai