@theyahia/huntflow-mcp 1.0.1 → 1.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -1,31 +1,73 @@
1
- # @theyahia/huntflow-mcp
2
-
3
- MCP-сервер для HuntFlow ATS API — вакансии и кандидаты для рекрутинга. **4 инструмента.**
4
-
5
- [![npm](https://img.shields.io/npm/v/@theyahia/huntflow-mcp)](https://www.npmjs.com/package/@theyahia/huntflow-mcp)
6
- [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
7
-
8
- Часть серии [Russian API MCP](https://github.com/theYahia/russian-mcp) (50 серверов).
9
-
10
- ## Установка
11
-
12
- ### Claude Desktop
13
- ```json
14
- { "mcpServers": { "huntflow": { "command": "npx", "args": ["-y", "@theyahia/huntflow-mcp"], "env": { "HUNTFLOW_TOKEN": "ваш-токен" } } } }
15
- ```
16
-
17
- | Переменная | Описание |
18
- |------------|----------|
19
- | `HUNTFLOW_TOKEN` | API токен (Настройки → API) |
20
-
21
- ## Инструменты (4)
22
-
23
- | Инструмент | Описание |
24
- |------------|----------|
25
- | `list_vacancies` | Список вакансий (открытые/все) |
26
- | `get_vacancy` | Полная информация о вакансии |
27
- | `search_applicants` | Поиск кандидатов |
28
- | `get_applicant` | Полная информация о кандидате |
29
-
30
- ## Лицензия
31
- MIT
1
+ # @theyahia/huntflow-mcp
2
+
3
+ MCP-сервер для HuntFlow ATS API — вакансии, кандидаты, резюме, этапы, аккаунты. **7 инструментов, 2 скилла.**
4
+
5
+ [![npm](https://img.shields.io/npm/v/@theyahia/huntflow-mcp)](https://www.npmjs.com/package/@theyahia/huntflow-mcp)
6
+ [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
7
+
8
+ Часть серии [Russian API MCP](https://github.com/theYahia/russian-mcp) (50 серверов).
9
+
10
+ ## Установка
11
+
12
+ ### Claude Desktop (stdio)
13
+ ```json
14
+ {
15
+ "mcpServers": {
16
+ "huntflow": {
17
+ "command": "npx",
18
+ "args": ["-y", "@theyahia/huntflow-mcp"],
19
+ "env": { "HUNTFLOW_TOKEN": "ваш-токен" }
20
+ }
21
+ }
22
+ }
23
+ ```
24
+
25
+ ### Streamable HTTP
26
+ ```bash
27
+ HUNTFLOW_TOKEN=ваш-токен npx @theyahia/huntflow-mcp --http
28
+ # POST /mcp, GET /health на порту 3000 (PORT=...)
29
+ ```
30
+
31
+ ### Smithery
32
+ ```bash
33
+ npx @smithery/cli install @theyahia/huntflow-mcp
34
+ ```
35
+
36
+ ## Переменные окружения
37
+
38
+ | Переменная | Обязательная | Описание |
39
+ |------------|:---:|----------|
40
+ | `HUNTFLOW_TOKEN` | да | API токен (Настройки → API) |
41
+ | `HUNTFLOW_BASE_URL` | нет | По умолчанию `https://api.huntflow.ru/v2` |
42
+ | `PORT` | нет | Порт HTTP-сервера (по умолчанию 3000) |
43
+
44
+ ## Инструменты (7)
45
+
46
+ | Инструмент | Описание |
47
+ |------------|----------|
48
+ | `list_accounts` | Список доступных аккаунтов |
49
+ | `list_vacancies` | Список вакансий (открытые/все) |
50
+ | `get_vacancy` | Полная информация о вакансии |
51
+ | `search_applicants` | Поиск кандидатов по имени/email |
52
+ | `get_applicant` | Полная информация о кандидате |
53
+ | `get_applicant_resumes` | Резюме кандидата (все прикреплённые) |
54
+ | `list_stages` | Этапы воронки подбора |
55
+
56
+ ## Скиллы (Prompts)
57
+
58
+ | Скилл | Описание |
59
+ |-------|----------|
60
+ | `skill-applicants` | Кандидаты на вакансию — таблица с этапами и сводкой |
61
+ | `skill-vacancy-stats` | Статистика по вакансии — воронка, сроки, конверсия |
62
+
63
+ ## Разработка
64
+
65
+ ```bash
66
+ npm install
67
+ npm test # vitest
68
+ npm run dev # tsx src/index.ts
69
+ npm run build # tsc
70
+ ```
71
+
72
+ ## Лицензия
73
+ MIT
package/dist/client.js CHANGED
@@ -1,11 +1,15 @@
1
- const BASE_URL = "https://api.huntflow.ai/v2";
1
+ const BASE_URL = (process.env.HUNTFLOW_BASE_URL || "https://api.huntflow.ru/v2").replace(/\/+$/, "");
2
2
  const TIMEOUT = 10_000;
3
3
  const MAX_RETRIES = 3;
4
- export async function hfGet(path) {
4
+ function getToken() {
5
5
  const token = process.env.HUNTFLOW_TOKEN;
6
6
  if (!token) {
7
7
  throw new Error("HUNTFLOW_TOKEN обязателен. Получите в настройках HuntFlow: Настройки → API.");
8
8
  }
9
+ return token;
10
+ }
11
+ export async function hfGet(path) {
12
+ const token = getToken();
9
13
  for (let attempt = 1; attempt <= MAX_RETRIES; attempt++) {
10
14
  const controller = new AbortController();
11
15
  const timer = setTimeout(() => controller.abort(), TIMEOUT);
@@ -1 +1 @@
1
- {"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,MAAM,QAAQ,GAAG,4BAA4B,CAAC;AAC9C,MAAM,OAAO,GAAG,MAAM,CAAC;AACvB,MAAM,WAAW,GAAG,CAAC,CAAC;AAEtB,MAAM,CAAC,KAAK,UAAU,KAAK,CAAC,IAAY;IACtC,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC;IACzC,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,IAAI,KAAK,CAAC,6EAA6E,CAAC,CAAC;IACjG,CAAC;IAED,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,IAAI,WAAW,EAAE,OAAO,EAAE,EAAE,CAAC;QACxD,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;QACzC,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,EAAE,OAAO,CAAC,CAAC;QAE5D,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,QAAQ,GAAG,IAAI,EAAE,EAAE;gBACjD,OAAO,EAAE;oBACP,eAAe,EAAE,UAAU,KAAK,EAAE;oBAClC,QAAQ,EAAE,kBAAkB;iBAC7B;gBACD,MAAM,EAAE,UAAU,CAAC,MAAM;aAC1B,CAAC,CAAC;YACH,YAAY,CAAC,KAAK,CAAC,CAAC;YAEpB,IAAI,QAAQ,CAAC,EAAE;gBAAE,OAAO,QAAQ,CAAC,IAAI,EAAE,CAAC;YAExC,IAAI,CAAC,QAAQ,CAAC,MAAM,KAAK,GAAG,IAAI,QAAQ,CAAC,MAAM,IAAI,GAAG,CAAC,IAAI,OAAO,GAAG,WAAW,EAAE,CAAC;gBACjF,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC,IAAI,CAAC,OAAO,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;gBACxD,MAAM,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,UAAU,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC;gBAC7C,SAAS;YACX,CAAC;YAED,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;gBAC5B,MAAM,IAAI,KAAK,CAAC,qDAAqD,CAAC,CAAC;YACzE,CAAC;YAED,MAAM,IAAI,KAAK,CAAC,iBAAiB,QAAQ,CAAC,MAAM,KAAK,QAAQ,CAAC,UAAU,EAAE,CAAC,CAAC;QAC9E,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,YAAY,CAAC,KAAK,CAAC,CAAC;YACpB,IAAI,KAAK,YAAY,YAAY,IAAI,KAAK,CAAC,IAAI,KAAK,YAAY,IAAI,OAAO,GAAG,WAAW;gBAAE,SAAS;YACpG,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;IACD,MAAM,IAAI,KAAK,CAAC,iCAAiC,CAAC,CAAC;AACrD,CAAC"}
1
+ {"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,MAAM,QAAQ,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,iBAAiB,IAAI,4BAA4B,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;AACrG,MAAM,OAAO,GAAG,MAAM,CAAC;AACvB,MAAM,WAAW,GAAG,CAAC,CAAC;AAEtB,SAAS,QAAQ;IACf,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC;IACzC,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,IAAI,KAAK,CAAC,6EAA6E,CAAC,CAAC;IACjG,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,KAAK,CAAC,IAAY;IACtC,MAAM,KAAK,GAAG,QAAQ,EAAE,CAAC;IAEzB,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,IAAI,WAAW,EAAE,OAAO,EAAE,EAAE,CAAC;QACxD,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;QACzC,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,EAAE,OAAO,CAAC,CAAC;QAE5D,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,QAAQ,GAAG,IAAI,EAAE,EAAE;gBACjD,OAAO,EAAE;oBACP,eAAe,EAAE,UAAU,KAAK,EAAE;oBAClC,QAAQ,EAAE,kBAAkB;iBAC7B;gBACD,MAAM,EAAE,UAAU,CAAC,MAAM;aAC1B,CAAC,CAAC;YACH,YAAY,CAAC,KAAK,CAAC,CAAC;YAEpB,IAAI,QAAQ,CAAC,EAAE;gBAAE,OAAO,QAAQ,CAAC,IAAI,EAAE,CAAC;YAExC,IAAI,CAAC,QAAQ,CAAC,MAAM,KAAK,GAAG,IAAI,QAAQ,CAAC,MAAM,IAAI,GAAG,CAAC,IAAI,OAAO,GAAG,WAAW,EAAE,CAAC;gBACjF,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC,IAAI,CAAC,OAAO,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;gBACxD,MAAM,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,UAAU,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC;gBAC7C,SAAS;YACX,CAAC;YAED,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;gBAC5B,MAAM,IAAI,KAAK,CAAC,qDAAqD,CAAC,CAAC;YACzE,CAAC;YAED,MAAM,IAAI,KAAK,CAAC,iBAAiB,QAAQ,CAAC,MAAM,KAAK,QAAQ,CAAC,UAAU,EAAE,CAAC,CAAC;QAC9E,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,YAAY,CAAC,KAAK,CAAC,CAAC;YACpB,IAAI,KAAK,YAAY,YAAY,IAAI,KAAK,CAAC,IAAI,KAAK,YAAY,IAAI,OAAO,GAAG,WAAW;gBAAE,SAAS;YACpG,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;IACD,MAAM,IAAI,KAAK,CAAC,iCAAiC,CAAC,CAAC;AACrD,CAAC"}
package/dist/index.d.ts CHANGED
@@ -1,2 +1,3 @@
1
1
  #!/usr/bin/env node
2
- export {};
2
+ import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
3
+ export declare function createServer(): McpServer;
package/dist/index.js CHANGED
@@ -1,17 +1,85 @@
1
1
  #!/usr/bin/env node
2
+ import { z } from "zod";
2
3
  import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
3
4
  import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
4
5
  import { listVacanciesSchema, handleListVacancies, getVacancySchema, handleGetVacancy } from "./tools/vacancies.js";
5
6
  import { searchApplicantsSchema, handleSearchApplicants, getApplicantSchema, handleGetApplicant } from "./tools/applicants.js";
6
- const server = new McpServer({ name: "huntflow-mcp", version: "1.0.0" });
7
- server.tool("list_vacancies", "Список вакансий в HuntFlow.", listVacanciesSchema.shape, async (params) => ({ content: [{ type: "text", text: await handleListVacancies(params) }] }));
8
- server.tool("get_vacancy", "Полная информация о вакансии.", getVacancySchema.shape, async (params) => ({ content: [{ type: "text", text: await handleGetVacancy(params) }] }));
9
- server.tool("search_applicants", "Поиск кандидатов по имени или email.", searchApplicantsSchema.shape, async (params) => ({ content: [{ type: "text", text: await handleSearchApplicants(params) }] }));
10
- server.tool("get_applicant", "Полная информация о кандидате.", getApplicantSchema.shape, async (params) => ({ content: [{ type: "text", text: await handleGetApplicant(params) }] }));
7
+ import { getApplicantResumesSchema, handleGetApplicantResumes } from "./tools/resumes.js";
8
+ import { listStagesSchema, handleListStages } from "./tools/stages.js";
9
+ import { listAccountsSchema, handleListAccounts } from "./tools/accounts.js";
10
+ export function createServer() {
11
+ const server = new McpServer({ name: "huntflow-mcp", version: "1.1.0" });
12
+ // --- Tools (7) ---
13
+ server.tool("list_vacancies", "Список вакансий в HuntFlow.", listVacanciesSchema.shape, async (params) => ({ content: [{ type: "text", text: await handleListVacancies(params) }] }));
14
+ server.tool("get_vacancy", "Полная информация о вакансии.", getVacancySchema.shape, async (params) => ({ content: [{ type: "text", text: await handleGetVacancy(params) }] }));
15
+ server.tool("search_applicants", "Поиск кандидатов по имени или email.", searchApplicantsSchema.shape, async (params) => ({ content: [{ type: "text", text: await handleSearchApplicants(params) }] }));
16
+ server.tool("get_applicant", "Полная информация о кандидате.", getApplicantSchema.shape, async (params) => ({ content: [{ type: "text", text: await handleGetApplicant(params) }] }));
17
+ server.tool("get_applicant_resumes", "Резюме кандидата (все прикреплённые).", getApplicantResumesSchema.shape, async (params) => ({ content: [{ type: "text", text: await handleGetApplicantResumes(params) }] }));
18
+ server.tool("list_stages", "Этапы воронки подбора (статусы вакансии).", listStagesSchema.shape, async (params) => ({ content: [{ type: "text", text: await handleListStages(params) }] }));
19
+ server.tool("list_accounts", "Список доступных аккаунтов HuntFlow.", listAccountsSchema.shape, async () => ({ content: [{ type: "text", text: await handleListAccounts() }] }));
20
+ // --- Skills / Prompts (2) ---
21
+ server.prompt("skill-applicants", "Кандидаты на вакансию — показать всех кандидатов, прикреплённых к указанной вакансии.", { account_id: z.string().describe("ID аккаунта"), vacancy_id: z.string().describe("ID вакансии") }, (args) => ({
22
+ messages: [{
23
+ role: "user",
24
+ content: {
25
+ type: "text",
26
+ text: [
27
+ `Покажи всех кандидатов на вакансию ${args.vacancy_id} в аккаунте ${args.account_id}.`,
28
+ `Используй инструменты: get_vacancy (account_id=${args.account_id}, vacancy_id=${args.vacancy_id}), затем search_applicants (account_id=${args.account_id}).`,
29
+ `Для каждого кандидата покажи: имя, email, телефон, текущий этап.`,
30
+ `Формат: таблица. В конце — сводка: сколько всего, сколько на каждом этапе.`,
31
+ ].join("\n"),
32
+ },
33
+ }],
34
+ }));
35
+ server.prompt("skill-vacancy-stats", "Статистика по вакансии — воронка, сроки, конверсия.", { account_id: z.string().describe("ID аккаунта"), vacancy_id: z.string().describe("ID вакансии") }, (args) => ({
36
+ messages: [{
37
+ role: "user",
38
+ content: {
39
+ type: "text",
40
+ text: [
41
+ `Покажи статистику по вакансии ${args.vacancy_id} в аккаунте ${args.account_id}.`,
42
+ `Используй инструменты: get_vacancy, list_stages, search_applicants.`,
43
+ `Собери: название вакансии, дата создания, сколько дней открыта,`,
44
+ `количество кандидатов на каждом этапе воронки, общая конверсия.`,
45
+ `Формат: сначала карточка вакансии, потом воронка (этап -> кол-во), потом выводы.`,
46
+ ].join("\n"),
47
+ },
48
+ }],
49
+ }));
50
+ return server;
51
+ }
11
52
  async function main() {
12
- const transport = new StdioServerTransport();
13
- await server.connect(transport);
14
- console.error("[huntflow-mcp] Сервер запущен. 4 инструмента.");
53
+ const args = process.argv.slice(2);
54
+ const server = createServer();
55
+ if (args.includes("--http")) {
56
+ const { StreamableHTTPServerTransport } = await import("@modelcontextprotocol/sdk/server/streamableHttp.js");
57
+ const http = await import("node:http");
58
+ const PORT = parseInt(process.env.PORT || "3000", 10);
59
+ const transport = new StreamableHTTPServerTransport({ sessionIdGenerator: undefined });
60
+ await server.connect(transport);
61
+ const httpServer = http.createServer(async (req, res) => {
62
+ if (req.url === "/mcp") {
63
+ await transport.handleRequest(req, res);
64
+ }
65
+ else if (req.method === "GET" && req.url === "/health") {
66
+ res.writeHead(200, { "Content-Type": "application/json" });
67
+ res.end(JSON.stringify({ status: "ok", tools: 7, prompts: 2 }));
68
+ }
69
+ else {
70
+ res.writeHead(404);
71
+ res.end("Not Found");
72
+ }
73
+ });
74
+ httpServer.listen(PORT, () => {
75
+ console.error(`[huntflow-mcp] HTTP сервер на порту ${PORT}. POST /mcp, GET /health`);
76
+ });
77
+ }
78
+ else {
79
+ const transport = new StdioServerTransport();
80
+ await server.connect(transport);
81
+ console.error("[huntflow-mcp] Сервер запущен (stdio). 7 инструментов, 2 скилла.");
82
+ }
15
83
  }
16
84
  main().catch((error) => { console.error("[huntflow-mcp] Ошибка:", error); process.exit(1); });
17
85
  //# sourceMappingURL=index.js.map
package/dist/index.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACpH,OAAO,EAAE,sBAAsB,EAAE,sBAAsB,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAE/H,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC,EAAE,IAAI,EAAE,cAAc,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC;AAEzE,MAAM,CAAC,IAAI,CAAC,gBAAgB,EAAE,6BAA6B,EAAE,mBAAmB,CAAC,KAAK,EACpF,KAAK,EAAE,MAAM,EAAE,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;AAEhG,MAAM,CAAC,IAAI,CAAC,aAAa,EAAE,+BAA+B,EAAE,gBAAgB,CAAC,KAAK,EAChF,KAAK,EAAE,MAAM,EAAE,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;AAE7F,MAAM,CAAC,IAAI,CAAC,mBAAmB,EAAE,sCAAsC,EAAE,sBAAsB,CAAC,KAAK,EACnG,KAAK,EAAE,MAAM,EAAE,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,sBAAsB,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;AAEnG,MAAM,CAAC,IAAI,CAAC,eAAe,EAAE,gCAAgC,EAAE,kBAAkB,CAAC,KAAK,EACrF,KAAK,EAAE,MAAM,EAAE,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;AAE/F,KAAK,UAAU,IAAI;IACjB,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAChC,OAAO,CAAC,KAAK,CAAC,+CAA+C,CAAC,CAAC;AACjE,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE,GAAG,OAAO,CAAC,KAAK,CAAC,wBAAwB,EAAE,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC"}
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,3 @@
1
+ import { z } from "zod";
2
+ export declare const listAccountsSchema: z.ZodObject<{}, "strip", z.ZodTypeAny, {}, {}>;
3
+ export declare function handleListAccounts(): Promise<string>;
@@ -0,0 +1,8 @@
1
+ import { z } from "zod";
2
+ import { hfGet } from "../client.js";
3
+ export const listAccountsSchema = z.object({});
4
+ export async function handleListAccounts() {
5
+ const result = await hfGet(`/accounts`);
6
+ return JSON.stringify(result, null, 2);
7
+ }
8
+ //# sourceMappingURL=accounts.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"accounts.js","sourceRoot":"","sources":["../../src/tools/accounts.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,KAAK,EAAE,MAAM,cAAc,CAAC;AAErC,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;AAE/C,MAAM,CAAC,KAAK,UAAU,kBAAkB;IACtC,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,WAAW,CAAC,CAAC;IACxC,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;AACzC,CAAC"}
@@ -0,0 +1,12 @@
1
+ import { z } from "zod";
2
+ export declare const getApplicantResumesSchema: z.ZodObject<{
3
+ account_id: z.ZodNumber;
4
+ applicant_id: z.ZodNumber;
5
+ }, "strip", z.ZodTypeAny, {
6
+ account_id: number;
7
+ applicant_id: number;
8
+ }, {
9
+ account_id: number;
10
+ applicant_id: number;
11
+ }>;
12
+ export declare function handleGetApplicantResumes(params: z.infer<typeof getApplicantResumesSchema>): Promise<string>;
@@ -0,0 +1,11 @@
1
+ import { z } from "zod";
2
+ import { hfGet } from "../client.js";
3
+ export const getApplicantResumesSchema = z.object({
4
+ account_id: z.number().describe("ID аккаунта HuntFlow"),
5
+ applicant_id: z.number().describe("ID кандидата"),
6
+ });
7
+ export async function handleGetApplicantResumes(params) {
8
+ const result = await hfGet(`/accounts/${params.account_id}/applicants/${params.applicant_id}/externals`);
9
+ return JSON.stringify(result, null, 2);
10
+ }
11
+ //# sourceMappingURL=resumes.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"resumes.js","sourceRoot":"","sources":["../../src/tools/resumes.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,KAAK,EAAE,MAAM,cAAc,CAAC;AAErC,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,CAAC,MAAM,CAAC;IAChD,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,sBAAsB,CAAC;IACvD,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,cAAc,CAAC;CAClD,CAAC,CAAC;AAEH,MAAM,CAAC,KAAK,UAAU,yBAAyB,CAAC,MAAiD;IAC/F,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,aAAa,MAAM,CAAC,UAAU,eAAe,MAAM,CAAC,YAAY,YAAY,CAAC,CAAC;IACzG,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;AACzC,CAAC"}
@@ -0,0 +1,9 @@
1
+ import { z } from "zod";
2
+ export declare const listStagesSchema: z.ZodObject<{
3
+ account_id: z.ZodNumber;
4
+ }, "strip", z.ZodTypeAny, {
5
+ account_id: number;
6
+ }, {
7
+ account_id: number;
8
+ }>;
9
+ export declare function handleListStages(params: z.infer<typeof listStagesSchema>): Promise<string>;
@@ -0,0 +1,10 @@
1
+ import { z } from "zod";
2
+ import { hfGet } from "../client.js";
3
+ export const listStagesSchema = z.object({
4
+ account_id: z.number().describe("ID аккаунта HuntFlow"),
5
+ });
6
+ export async function handleListStages(params) {
7
+ const result = await hfGet(`/accounts/${params.account_id}/vacancy/statuses`);
8
+ return JSON.stringify(result, null, 2);
9
+ }
10
+ //# sourceMappingURL=stages.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"stages.js","sourceRoot":"","sources":["../../src/tools/stages.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,KAAK,EAAE,MAAM,cAAc,CAAC;AAErC,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC;IACvC,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,sBAAsB,CAAC;CACxD,CAAC,CAAC;AAEH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,MAAwC;IAC7E,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,aAAa,MAAM,CAAC,UAAU,mBAAmB,CAAC,CAAC;IAC9E,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;AACzC,CAAC"}
package/dist/types.d.ts CHANGED
@@ -17,3 +17,21 @@ export interface HFApplicant {
17
17
  position?: string;
18
18
  created: string;
19
19
  }
20
+ export interface HFResume {
21
+ id: number;
22
+ auth_type: string;
23
+ account_source?: number;
24
+ created: string;
25
+ updated: string;
26
+ }
27
+ export interface HFStage {
28
+ id: number;
29
+ name: string;
30
+ order: number;
31
+ removed?: boolean;
32
+ }
33
+ export interface HFAccount {
34
+ id: number;
35
+ name: string;
36
+ nick: string;
37
+ }
package/package.json CHANGED
@@ -1,53 +1,56 @@
1
- {
2
- "name": "@theyahia/huntflow-mcp",
3
- "version": "1.0.1",
4
- "description": "MCP server for HuntFlow ATS API — vacancies, candidates, applicants for recruiting.",
5
- "type": "module",
6
- "main": "dist/index.js",
7
- "bin": {
8
- "huntflow-mcp": "dist/index.js"
9
- },
10
- "files": [
11
- "dist"
12
- ],
13
- "engines": {
14
- "node": ">=18.0.0"
15
- },
16
- "scripts": {
17
- "build": "tsc",
18
- "dev": "tsx src/index.ts",
19
- "start": "node dist/index.js",
20
- "prepublishOnly": "npm run build"
21
- },
22
- "dependencies": {
23
- "@modelcontextprotocol/sdk": "^1.12.0",
24
- "zod": "^3.24.0"
25
- },
26
- "devDependencies": {
27
- "@types/node": "^22.0.0",
28
- "tsx": "^4.19.0",
29
- "typescript": "^5.7.0"
30
- },
31
- "publishConfig": {
32
- "access": "public"
33
- },
34
- "mcpName": "io.github.theYahia/huntflow-mcp",
35
- "keywords": [
36
- "mcp",
37
- "mcp-server",
38
- "model-context-protocol",
39
- "claude",
40
- "ai",
41
- "russian-api",
42
- "huntflow",
43
- "recruiting",
44
- "ats",
45
- "hr"
46
- ],
47
- "license": "MIT",
48
- "repository": {
49
- "type": "git",
50
- "url": "https://github.com/theYahia/huntflow-mcp.git"
51
- },
52
- "author": "theYahia (https://github.com/theYahia)"
53
- }
1
+ {
2
+ "name": "@theyahia/huntflow-mcp",
3
+ "version": "1.1.0",
4
+ "description": "MCP server for HuntFlow ATS API — vacancies, applicants, resumes, stages, accounts for recruiting.",
5
+ "type": "module",
6
+ "main": "dist/index.js",
7
+ "bin": {
8
+ "huntflow-mcp": "dist/index.js"
9
+ },
10
+ "files": [
11
+ "dist"
12
+ ],
13
+ "engines": {
14
+ "node": ">=18.0.0"
15
+ },
16
+ "scripts": {
17
+ "build": "tsc",
18
+ "dev": "tsx src/index.ts",
19
+ "start": "node dist/index.js",
20
+ "test": "vitest run",
21
+ "test:watch": "vitest",
22
+ "prepublishOnly": "npm run build"
23
+ },
24
+ "dependencies": {
25
+ "@modelcontextprotocol/sdk": "^1.12.0",
26
+ "zod": "^3.24.0"
27
+ },
28
+ "devDependencies": {
29
+ "@types/node": "^22.0.0",
30
+ "tsx": "^4.19.0",
31
+ "typescript": "^5.7.0",
32
+ "vitest": "^3.1.1"
33
+ },
34
+ "publishConfig": {
35
+ "access": "public"
36
+ },
37
+ "mcpName": "io.github.theYahia/huntflow-mcp",
38
+ "keywords": [
39
+ "mcp",
40
+ "mcp-server",
41
+ "model-context-protocol",
42
+ "claude",
43
+ "ai",
44
+ "russian-api",
45
+ "huntflow",
46
+ "recruiting",
47
+ "ats",
48
+ "hr"
49
+ ],
50
+ "license": "MIT",
51
+ "repository": {
52
+ "type": "git",
53
+ "url": "https://github.com/theYahia/huntflow-mcp.git"
54
+ },
55
+ "author": "theYahia (https://github.com/theYahia)"
56
+ }