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 分