@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 +73 -31
- package/dist/client.js +6 -2
- package/dist/client.js.map +1 -1
- package/dist/index.d.ts +2 -1
- package/dist/index.js +76 -8
- package/dist/index.js.map +1 -1
- package/dist/tools/accounts.d.ts +3 -0
- package/dist/tools/accounts.js +8 -0
- package/dist/tools/accounts.js.map +1 -0
- package/dist/tools/resumes.d.ts +12 -0
- package/dist/tools/resumes.js +11 -0
- package/dist/tools/resumes.js.map +1 -0
- package/dist/tools/stages.d.ts +9 -0
- package/dist/tools/stages.js +10 -0
- package/dist/tools/stages.js.map +1 -0
- package/dist/types.d.ts +18 -0
- package/package.json +56 -53
package/README.md
CHANGED
|
@@ -1,31 +1,73 @@
|
|
|
1
|
-
# @theyahia/huntflow-mcp
|
|
2
|
-
|
|
3
|
-
MCP-сервер для HuntFlow ATS API —
|
|
4
|
-
|
|
5
|
-
[](https://www.npmjs.com/package/@theyahia/huntflow-mcp)
|
|
6
|
-
[](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
|
-
{
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
|
|
1
|
+
# @theyahia/huntflow-mcp
|
|
2
|
+
|
|
3
|
+
MCP-сервер для HuntFlow ATS API — вакансии, кандидаты, резюме, этапы, аккаунты. **7 инструментов, 2 скилла.**
|
|
4
|
+
|
|
5
|
+
[](https://www.npmjs.com/package/@theyahia/huntflow-mcp)
|
|
6
|
+
[](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.
|
|
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
|
-
|
|
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);
|
package/dist/client.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,MAAM,QAAQ,GAAG,4BAA4B,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
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
|
-
|
|
7
|
-
|
|
8
|
-
|
|
9
|
-
|
|
10
|
-
server
|
|
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
|
|
13
|
-
|
|
14
|
-
|
|
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;
|
|
1
|
+
{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
|
|
@@ -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
|
|
4
|
-
"description": "MCP server for HuntFlow ATS API — vacancies,
|
|
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
|
-
"
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
"
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
"
|
|
33
|
-
},
|
|
34
|
-
"
|
|
35
|
-
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
"
|
|
40
|
-
"
|
|
41
|
-
"
|
|
42
|
-
"
|
|
43
|
-
"
|
|
44
|
-
"
|
|
45
|
-
"
|
|
46
|
-
|
|
47
|
-
|
|
48
|
-
|
|
49
|
-
|
|
50
|
-
|
|
51
|
-
|
|
52
|
-
|
|
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
|
+
}
|