# freehire

Ищет вакансии по каталогу компаний и ведёт отклики прямо из чата с агентом. Пригодится, когда не хочется открывать браузер ради очередной вакансии.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 12
- Автор: strelov1
- Лицензия: MIT · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/strelov1/freehire-mcp
- Обновлён: 2026-10-24
- HTML: https://affpapa.org/nevibecode/mcp/freehire

## Что делает

Сервер стоит поверх API freehire.me и отдаёт агенту инструменты для поиска работы. Вакансии собираются с карьерных сайтов компаний: 3.3M+ позиций у 294K компаний, приведённых к одной схеме с тегами по стеку, грейду, региону и формату работы.

Есть доступ только на чтение без ключа и локальный запуск через `npx`. С `fhk_…` ключом из аккаунта открываются трекинг откликов, заметки и стадии, а ещё подгонка CV под вакансию. Ключ берётся из `FREEHIRE_TOKEN`, иначе сервер читает `~/.freehire/creds.json` — тот же файл, что использует CLI. Файл только читается: логин остаётся за CLI.

Фильтры `region`, `country`, `city` работают как одно условие «либо»: `region: ["eu"]` вместе с `country: ["IT"]` вернёт и Европу, и Италию. Опечатку в имени фильтра запрос не ломает, а расширяет; такие ключи приходят в поле `ignored`. Без токена инструменты просто отвечают ошибкой аутентификации, сервер при этом стартует. Каждое утверждение в CV должно ссылаться на `evidence_id` из `experience_list`, иначе `cv_edit` правку отклонит.

## Требования
- Нужно: Node.js (команды через npx)
- Удалённый сервер: `https://freehire.me/api/v1/mcp`
- Переменные окружения: `FREEHIRE_TOKEN`, `FREEHIRE_API_URL` — это ключи и токены: значения спроси у человека, в репозиторий и общие файлы не записывай.

## Установка

### Claude Code (родная платформа)

1. **Командой платформы: удалённый сервер**
```bash
claude mcp add --transport http freehire https://freehire.me/api/v1/mcp
```

2. **Командой платформы**
```bash
claude mcp add --env FREEHIRE_TOKEN=<FREEHIRE_TOKEN> --env FREEHIRE_API_URL=<FREEHIRE_API_URL> --transport stdio freehire -- npx -y freehire-mcp
```
Вместо <…> подставьте свои значения

### Codex

1. **Командой платформы: удалённый сервер**
```bash
codex mcp add freehire --url https://freehire.me/api/v1/mcp
```

2. **Командой платформы**
```bash
codex mcp add freehire --env FREEHIRE_TOKEN=<FREEHIRE_TOKEN> --env FREEHIRE_API_URL=<FREEHIRE_API_URL> -- npx -y freehire-mcp
```
Вместо <…> подставьте свои значения

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "freehire": {
            "url": "https://freehire.me/api/v1/mcp"
        }
    }
}
```
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "freehire": {
            "command": "npx",
            "args": [
                "-y",
                "freehire-mcp"
            ],
            "env": {
                "FREEHIRE_TOKEN": "<FREEHIRE_TOKEN>",
                "FREEHIRE_API_URL": "<FREEHIRE_API_URL>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "freehire": {
            "type": "http",
            "url": "https://freehire.me/api/v1/mcp"
        }
    }
}
```
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "freehire": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "freehire-mcp"
            ],
            "env": {
                "FREEHIRE_TOKEN": "<FREEHIRE_TOKEN>",
                "FREEHIRE_API_URL": "<FREEHIRE_API_URL>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения

### Gemini CLI

1. **Командой платформы: удалённый сервер**
```bash
gemini mcp add -t http freehire https://freehire.me/api/v1/mcp
```

2. **Командой платформы**
```bash
gemini mcp add -e FREEHIRE_TOKEN=<FREEHIRE_TOKEN> -e FREEHIRE_API_URL=<FREEHIRE_API_URL> freehire npx -y freehire-mcp
```
Вместо <…> подставьте свои значения

## Когда брать
- найти вакансии по стеку, грейду и формату работы
- сверить свой набор скиллов с реальным спросом на рынке
- подогнать CV под конкретную вакансию
- вести стадии откликов и заметки по ним
- собрать PDF из готового CV

## Примеры запросов агенту
- Покажи фасеты по скиллам, потом найди вакансии Python-разработчика в Европе.
- Оцени мой стек: Python, PostgreSQL, Kubernetes — что закрыто, чего не хватает.
- Начни подгонку CV под вакансию и покажи, какие пробелы нужно закрыть.

## Похожие
- [REA](https://affpapa.org/nevibecode/mcp/rea.md) — MCP-сервер · ★ 386989
- [GitHub](https://affpapa.org/nevibecode/mcp/github.md) — MCP-сервер · ★ 33918
- [Netdata](https://affpapa.org/nevibecode/mcp/netdata.md) — MCP-сервер · ★ 81115
- [browser-use](https://affpapa.org/nevibecode/mcp/browser-use.md) — MCP-сервер · ★ 119160
- [Codebase Memory](https://affpapa.org/nevibecode/mcp/codebase-memory.md) — MCP-сервер · ★ 47392
- [mcp-server](https://affpapa.org/nevibecode/mcp/mcp-server.md) — MCP-сервер · ★ 43872

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md