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）タブ → トークンを作成します。発行されるペアには、アクセストークン（有効期間は約 7 日）とリフレッシュトークン（約 14 日）が含まれます。サーバーは期限切れ時に POST /token/refresh を使ってアクセストークンを自動更新し、ローテーション後のペアを状態ファイル（HUNTFLOW_TOKEN_FILE）に保存して、再起動後も利用できるようにします。リフレッシュトークンを設定せず、HUNTFLOW_TOKEN のみを指定した場合、サーバーはアクセストークンの期限が切れるまで（約 7 日）動作し、その後は新しいトークンが必要になります。

環境変数

変数	必須	説明
HUNTFLOW_TOKEN	はい	アクセストークン（設定 → API-токены）
HUNTFLOW_REFRESH_TOKEN	いいえ	リフレッシュトークン — 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