{
  "markdown": "# MCP-сервер для Huntflow — вакансии, кандидаты и резюме ATS через ИИ\n\nЕсли вы искали, как подключить Huntflow к нейросети, найти кандидата и прочитать его резюме не листая карточки в ATS — это оно. 14 инструментов и 2 скилла: вакансии, кандидаты, резюме, этапы подбора, справочники, аккаунты. Спрашиваете «кто застрял на этапе техинтервью» — получаете список, а не выгрузку в CSV.\n\n[![npm](https://img.shields.io/npm/v/@theyahia/huntflow-mcp)](https://www.npmjs.com/package/@theyahia/huntflow-mcp)\n[![CI](https://github.com/theYahia/huntflow-mcp/actions/workflows/ci.yml/badge.svg)](https://github.com/theYahia/huntflow-mcp/actions/workflows/ci.yml)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n\nЧасть серии [WWmcp](https://github.com/theYahia/WWmcp) (46 серверов).\n\n## Установка\n\n### Claude Desktop (stdio)\n```json\n{\n  \"mcpServers\": {\n    \"huntflow\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@theyahia/huntflow-mcp\"],\n      \"env\": {\n        \"HUNTFLOW_TOKEN\": \"ваш-access-token\",\n        \"HUNTFLOW_REFRESH_TOKEN\": \"ваш-refresh-token\"\n      }\n    }\n  }\n}\n```\n\n### Streamable HTTP\n```bash\nHUNTFLOW_TOKEN=ваш-токен npx @theyahia/huntflow-mcp --http\n# POST /mcp, GET /health на 127.0.0.1:3000 (PORT=...)\n```\n\n### Smithery\n```bash\nnpx @smithery/cli install @theyahia/huntflow-mcp\n```\n\n## Получение токена\n\nНастройки HuntFlow → вкладка **«API-токены» (API Tokens)** → создать токен. Выданная пара включает **access-токен** (живёт ~7 дней) и **refresh-токен** (~14 дней). Сервер автоматически обновляет access-токен через `POST /token/refresh` при истечении и **сохраняет ротированную пару** в файл состояния (`HUNTFLOW_TOKEN_FILE`), переживая рестарты. Если задать только `HUNTFLOW_TOKEN` без refresh — сервер проработает до истечения access-токена (~7 дней), затем потребуется новый токен.\n\n## Переменные окружения\n\n| Переменная | Обяз. | Описание |\n|------------|:---:|----------|\n| `HUNTFLOW_TOKEN` | да | Access-токен (Настройки → API-токены) |\n| `HUNTFLOW_REFRESH_TOKEN` | нет | Refresh-токен — включает авто-обновление при 401 |\n| `HUNTFLOW_TOKEN_FILE` | нет | Файл для хранения ротированной пары (по умолчанию `~/.huntflow-mcp/token.json`) |\n| `HUNTFLOW_BASE_URL` | нет | По умолчанию `https://api.huntflow.ru/v2` |\n| `HUNTFLOW_USER_AGENT` | нет | User-Agent (обязателен для API; есть дефолт) |\n| `HUNTFLOW_TIMEOUT_MS` | нет | Таймаут запроса, мс (по умолчанию 10000) |\n| `HUNTFLOW_DISABLE_RATELIMIT` | нет | `1` — отключить клиентский лимит 10 req/s |\n| `PORT` | нет | Порт HTTP-сервера (по умолчанию 3000) |\n| `HUNTFLOW_HTTP_HOST` | нет | Хост привязки HTTP (по умолчанию `127.0.0.1`) |\n| `HUNTFLOW_HTTP_SECRET` | нет | Если задан — требует `Authorization: Bearer <secret>` на `/mcp` |\n| `HUNTFLOW_ALLOWED_HOSTS` | нет | Список host:port для защиты от DNS-rebinding |\n\n## Инструменты (14)\n\n| Инструмент | Описание |\n|------------|----------|\n| `list_accounts` | Список доступных аккаунтов |\n| `list_vacancies` | Список вакансий (фильтры `opened`/`state`/`mine`, пагинация) |\n| `get_vacancy` | Полная информация о вакансии |\n| `search_applicants` | Поиск кандидатов (`q` + фильтры vacancy/status/tag) |\n| `list_vacancy_applicants` | Кандидаты, прикреплённые к конкретной вакансии |\n| `get_applicant` | Полная информация о кандидате |\n| `get_applicant_resumes` | Список резюме (external) кандидата |\n| `get_resume` | Полное тело конкретного резюме (external) |\n| `list_stages` | Этапы воронки подбора (статусы вакансий) |\n| `list_coworkers` | Сотрудники/рекрутеры аккаунта |\n| `list_sources` | Справочник источников кандидатов |\n| `list_rejection_reasons` | Справочник причин отказа |\n| `list_divisions` | Справочник подразделений |\n| `list_tags` | Справочник тегов |\n\nСписочные инструменты возвращают курированный набор полей (экономия токенов) + `structuredContent`; передайте `raw: true` для полного сырого ответа. Пагинация — параметры `page`/`count`.\n\n## Скиллы (Prompts)\n\n| Скилл | Описание |\n|-------|----------|\n| `skill-applicants` | Кандидаты на вакансию — таблица с этапами и сводкой |\n| `skill-vacancy-stats` | Статистика по вакансии — воронка, сроки, конверсия |\n\n## Разработка\n\n```bash\nnpm install\nnpm test           # vitest\nnpm run typecheck  # tsc --noEmit\nnpm run lint       # eslint\nnpm run format     # prettier --write\nnpm run dev        # tsx src/index.ts\nnpm run build      # tsc\n```\n\n## Лицензия\nMIT\n\n---\n\nЧасть [WWmcp](https://github.com/theYahia/WWmcp) · Telegram: [@vhodvai](https://t.me/vhodvai)\n",
  "bytes": 4496,
  "sha": "ed13c4025586df73fb24083afb821e825c96d9dc3084406693c00cc74cf289cb",
  "repo_slug": "theyahia/huntflow-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_theyahia_huntflow_mcp_fd1cfb0c/readme"
}