Huntflow Mcp

io.github.theYahia由 GitHub 账号 theYahia 发布v1.0.0更新于 Oct 24, 2026

MCP server for HuntFlow ATS API — vacancies, candidates, applicants for recruiting.

已验证STDIO仅桌面效率与工作流商业与电商

概览

AI 生成的概览

面向 HuntFlow 招聘 ATS 的本地 MCP 服务器，让助手浏览职位、搜索候选人、读取简历并查看招聘流程阶段。

可以做什么
列出账户、职位及职位详情，支持按开放状态、归属和分页筛选。搜索候选人，列出某职位下的应聘者，并读取候选人资料与其简历。查询招聘漏斗阶段、同事以及来源、拒绝原因、部门和标签等参考数据。提供两个内置提示，用于生成某职位的候选人表格和职位漏斗统计。列表类工具默认返回精简字段，可要求原始完整输出。
适用场景
当招聘工作使用 HuntFlow，并希望用自然语言提问时适用，例如查询谁卡在某个阶段，或无需在 ATS 中逐张打开卡片即可阅读候选人简历。偏向查询读取，而非修改记录。
运行要求
通过 npx 在本地运行，需要 Node.js；也可作为本地 HTTP 服务运行在 127.0.0.1:3000。需要 HuntFlow API 访问令牌，放在 HUNTFLOW_TOKEN 中；可选的刷新令牌放在 HUNTFLOW_REFRESH_TOKEN 中以启用自动续期。其他可选设置包括令牌状态文件、基础地址、User-Agent、超时、速率限制、端口、绑定主机、HTTP Bearer 密钥和允许的主机。需要访问 HuntFlow API 的网络连接。
安装前请注意
需要 HuntFlow API 令牌，这是可访问招聘数据的凭据。配置刷新令牌后，服务器会把轮换后的令牌对写入磁盘状态文件，默认位于用户主目录下。简历和候选人数据属于个人招聘信息，会发送给模型提供方。可选的 HTTP 模式可用 HUNTFLOW_HTTP_SECRET 保护；未设置时，能访问该端口的人都可以使用该令牌。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Huntflow Mcp，将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only，通过 STDIO。 STDIO 服务会启动本地进程，因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

README

MCP-сервер для Huntflow — вакансии, кандидаты и резюме ATS через ИИ

Если вы искали, как подключить Huntflow к нейросети, найти кандидата и прочитать его резюме не листая карточки в ATS — это оно. 14 инструментов и 2 скилла: вакансии, кандидаты, резюме, этапы подбора, справочники, аккаунты. Спрашиваете «кто застрял на этапе техинтервью» — получаете список, а не выгрузку в CSV.

[npm] [CI] [License: MIT]

Часть серии WWmcp (46 серверов).

Установка

Claude Desktop (stdio)

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

Streamable HTTP

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

Smithery

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

Получение токена

Настройки HuntFlow → вкладка «API-токены» (API Tokens) → создать токен. Выданная пара включает access-токен (живёт ~7 дней) и refresh-токен (~14 дней). Сервер автоматически обновляет access-токен через POST /token/refresh при истечении и сохраняет ротированную пару в файл состояния (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нетЕсли задан — требует Authorization: Bearer <secret> на /mcp
HUNTFLOW_ALLOWED_HOSTSнетСписок host:port для защиты от DNS-rebinding

Инструменты (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Статистика по вакансии — воронка, сроки, конверсия

Разработка

bash
npm installnpm test           # vitestnpm run typecheck  # tsc --noEmitnpm run lint       # eslintnpm run format     # prettier --writenpm run dev        # tsx src/index.tsnpm run build      # tsc

Лицензия

MIT

Часть WWmcp · Telegram: @vhodvai

来源：README.md，提交 11b3f3e

工具

0
SourceWeft 尚未在沙箱中启动过该软件包，因此其工具未知。

版本历史

1
  1. v1.0.0最新Sep 16, 2026

评分

已满足适用检查项的 50%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通25 分

    请保持端点能够响应 MCP 握手；SourceWeft 每 30 天探测一次。

  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头，或保持端点能够响应探测，以便判定其认证方式。

  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list，或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分