iflow-mcp_gmen1057-headhunter-mcp-server 0.1.0__py3-none-any.whl

.env.example

@@ -0,0 +1,12 @@
+# HeadHunter API Credentials
+# Get your credentials at: https://dev.hh.ru/admin
+
+HH_CLIENT_ID=your_client_id_here
+HH_CLIENT_SECRET=your_client_secret_here
+HH_APP_TOKEN=your_app_token_here
+HH_REDIRECT_URI=https://your-domain.com/oauth/callback
+
+# OAuth tokens (obtained after authorization)
+# Run: python examples/oauth_flow.py
+HH_ACCESS_TOKEN=
+HH_REFRESH_TOKEN=

.gitignore

@@ -0,0 +1,30 @@
+# Environment variables
+.env
+
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+venv/
+env/
+ENV/
+build/
+dist/
+*.egg-info/
+
+# IDE
+.vscode/
+.idea/
+*.swp
+*.swo
+*~
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Project specific
+vacancy-reports/
+*.csv

3090_process.log

@@ -0,0 +1,4 @@
+[2026-02-05 03:36:59] [SUCCESS] 获取项目: Fork并克隆项目成功
+[2026-02-05 03:37:06] [SUCCESS] 阅读代码: 项目类型判定为Python MCP服务端项目，支持stdio协议
+[2026-02-05 03:38:09] [SUCCESS] 本地测试: 本地测试通过，获取到10个工具
+[2026-02-05 03:38:20] [SUCCESS] 推送iflow分支: 分支已成功推送到远程仓库

CONTRIBUTING.md

@@ -0,0 +1,86 @@
+# Contributing to HeadHunter MCP Server
+
+Thank you for your interest in contributing! 🎉
+
+## How to Contribute
+
+### Reporting Issues
+
+- Check existing issues first to avoid duplicates
+- Use a clear and descriptive title
+- Include steps to reproduce (if applicable)
+- Mention your environment (OS, Python version, etc.)
+
+### Submitting Pull Requests
+
+1. **Fork the repository**
+
+2. **Create a feature branch**
+   ```bash
+   git checkout -b feature/your-feature-name
+   ```
+
+3. **Make your changes**
+   - Follow existing code style
+   - Add tests if applicable
+   - Update documentation
+
+4. **Test your changes**
+   ```bash
+   python -m pytest  # if tests exist
+   ```
+
+5. **Commit your changes**
+   ```bash
+   git commit -m "Add: brief description of changes"
+   ```
+
+6. **Push to your fork**
+   ```bash
+   git push origin feature/your-feature-name
+   ```
+
+7. **Open a Pull Request**
+   - Describe what changed and why
+   - Reference any related issues
+
+## Code Style
+
+- Follow PEP 8 for Python code
+- Use type hints where possible
+- Add docstrings for public functions
+- Keep functions focused and small
+
+## Development Setup
+
+```bash
+# Clone your fork
+git clone https://github.com/your-username/headhunter-mcp-server.git
+cd headhunter-mcp-server
+
+# Create virtual environment
+python -m venv venv
+source venv/bin/activate  # On Windows: venv\Scripts\activate
+
+# Install dependencies
+pip install -r requirements.txt
+
+# Install development dependencies (if any)
+pip install -r requirements-dev.txt  # if exists
+```
+
+## Testing
+
+Before submitting, ensure:
+- [ ] Code runs without errors
+- [ ] All existing functionality still works
+- [ ] New features are documented
+- [ ] No credentials are committed
+
+## Questions?
+
+Feel free to open an issue for discussion before starting work on major changes.
+
+---
+
+Thank you for contributing! 🚀

LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 HeadHunter MCP Server Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

PKG-INFO

@@ -0,0 +1,326 @@
+Metadata-Version: 2.4
+Name: iflow-mcp_gmen1057-headhunter-mcp-server
+Version: 0.1.0
+Summary: HeadHunter MCP Server - Integrate HeadHunter API with Claude Code and other MCP clients
+License-File: LICENSE
+Requires-Python: >=3.10
+Requires-Dist: httpx>=0.27.0
+Requires-Dist: mcp>=1.0.0
+Requires-Dist: pydantic>=2.0.0
+Requires-Dist: python-dotenv>=1.0.0
+Description-Content-Type: text/markdown
+
+# HeadHunter MCP Server
+
+[![Python 3.10+](https://img.shields.io/badge/python-3.10+-blue.svg)](https://www.python.org/downloads/)
+[![MCP](https://img.shields.io/badge/MCP-1.0+-green.svg)](https://modelcontextprotocol.io/)
+[![HeadHunter API](https://img.shields.io/badge/HeadHunter-API%20v3-orange.svg)](https://dev.hh.ru/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+[English](#english) | [Русский](#russian)
+
+---
+
+## English
+
+**MCP (Model Context Protocol) server for integrating HeadHunter API with Claude Code and other MCP clients.**
+
+HeadHunter (hh.ru) is the largest job search platform in Russia and CIS countries. This MCP server provides seamless integration with HeadHunter API, enabling AI assistants to search vacancies, manage resumes, and apply to jobs on your behalf.
+
+### Features
+
+- 🔍 **Advanced Vacancy Search** - Filter by location, salary, experience, employment type
+- 📄 **Resume Management** - View and manage your HeadHunter resumes
+- ✉️ **Job Applications** - Apply to vacancies with custom cover letters
+- 🏢 **Company Information** - Get detailed employer data
+- 📊 **Application Tracking** - Monitor your job application history
+- 🤖 **AI-Powered Agent** - Automated vacancy hunter with intelligent matching
+- 🔐 **OAuth 2.0** - Secure authorization with HeadHunter
+
+### Available Tools (10)
+
+1. **hh_search_vacancies** - Search for job vacancies
+2. **hh_get_vacancy** - Get detailed vacancy information
+3. **hh_get_employer** - Get company/employer details
+4. **hh_get_similar** - Find similar vacancies
+5. **hh_get_areas** - Get list of regions/cities
+6. **hh_get_dictionaries** - Get reference data (experience, employment types, etc.)
+7. **hh_get_resumes** - Get your resumes list
+8. **hh_get_resume** - Get detailed resume information
+9. **hh_apply_to_vacancy** - Apply to a vacancy (requires OAuth)
+10. **hh_get_negotiations** - Get application history (requires OAuth)
+
+### Quick Start
+
+#### 1. Installation
+
+```bash
+git clone https://github.com/yourusername/headhunter-mcp-server.git
+cd headhunter-mcp-server
+python -m venv venv
+source venv/bin/activate  # On Windows: venv\Scripts\activate
+pip install -r requirements.txt
+```
+
+#### 2. Get HeadHunter API Credentials
+
+1. Register your application at [https://dev.hh.ru/admin](https://dev.hh.ru/admin)
+2. Get Client ID, Client Secret, and App Token
+3. Copy `.env.example` to `.env` and fill in your credentials
+
+```bash
+cp .env.example .env
+# Edit .env with your credentials
+```
+
+#### 3. Configure Claude Code
+
+Add to your `~/.claude.json`:
+
+```json
+{
+  "mcpServers": {
+    "headhunter": {
+      "type": "stdio",
+      "command": "/path/to/venv/bin/python",
+      "args": ["/path/to/headhunter-mcp-server/server.py"],
+      "env": {
+        "HH_CLIENT_ID": "your_client_id",
+        "HH_CLIENT_SECRET": "your_client_secret",
+        "HH_APP_TOKEN": "your_app_token",
+        "HH_REDIRECT_URI": "https://your-domain.com/oauth/callback"
+      }
+    }
+  }
+}
+```
+
+#### 4. OAuth Authorization (Optional)
+
+For job applications and resume management:
+
+```bash
+python examples/oauth_flow.py
+```
+
+Follow the instructions to authorize and get access tokens.
+
+### Usage Examples
+
+```bash
+# Search for Python jobs in Moscow
+Find 10 Python developer vacancies in Moscow with salary from 200000
+
+# View your resumes
+Show my resumes
+
+# Get vacancy details
+Show details for vacancy 126209046
+
+# Apply to a job (after OAuth)
+Apply to vacancy 126209046 with resume [resume_id] and cover letter: "Hello..."
+```
+
+### Vacancy Hunter Agent
+
+Automated agent for intelligent vacancy search and analysis. See [docs/vacancy-hunter-agent.md](docs/vacancy-hunter-agent.md) for details.
+
+**Features:**
+- Analyzes multiple resumes simultaneously
+- Scores vacancies by relevance (0-30 points)
+- Generates CSV reports with AI-powered recommendations
+- Focuses on Moscow region only
+
+**Usage:**
+```bash
+Run vacancy-hunter agent
+```
+
+### Project Structure
+
+```
+headhunter-mcp-server/
+├── server.py              # MCP server (10 tools)
+├── hh_client.py           # HeadHunter API client
+├── requirements.txt       # Python dependencies
+├── .env.example           # Environment variables template
+├── examples/
+│   └── oauth_flow.py      # OAuth authorization script
+└── docs/
+    └── vacancy-hunter-agent.md  # Agent documentation
+```
+
+### Requirements
+
+- Python 3.10+
+- Claude Code or any MCP-compatible client
+- HeadHunter API credentials
+
+### Contributing
+
+Contributions are welcome! Please feel free to submit a Pull Request.
+
+### License
+
+MIT License - see [LICENSE](LICENSE) file for details.
+
+### Links
+
+- [HeadHunter API Documentation](https://dev.hh.ru/)
+- [Model Context Protocol](https://modelcontextprotocol.io/)
+- [Claude Code Documentation](https://docs.claude.com/en/docs/claude-code)
+
+---
+
+## Russian
+
+**MCP сервер для интеграции HeadHunter API с Claude Code и другими MCP клиентами.**
+
+HeadHunter (hh.ru) — крупнейшая платформа по поиску работы в России и странах СНГ. Этот MCP сервер обеспечивает бесшовную интеграцию с API HeadHunter, позволяя AI ассистентам искать вакансии, управлять резюме и откликаться на вакансии от вашего имени.
+
+### Возможности
+
+- 🔍 **Расширенный поиск вакансий** - Фильтрация по местоположению, зарплате, опыту, типу занятости
+- 📄 **Управление резюме** - Просмотр и управление вашими резюме на HeadHunter
+- ✉️ **Отклики на вакансии** - Подача заявок с персонализированными сопроводительными письмами
+- 🏢 **Информация о компаниях** - Получение детальных данных о работодателях
+- 📊 **Отслеживание откликов** - Мониторинг истории ваших откликов
+- 🤖 **AI-агент** - Автоматизированный поиск вакансий с умным сопоставлением
+- 🔐 **OAuth 2.0** - Безопасная авторизация через HeadHunter
+
+### Доступные инструменты (10)
+
+1. **hh_search_vacancies** - Поиск вакансий
+2. **hh_get_vacancy** - Детальная информация о вакансии
+3. **hh_get_employer** - Информация о компании/работодателе
+4. **hh_get_similar** - Поиск похожих вакансий
+5. **hh_get_areas** - Список регионов/городов
+6. **hh_get_dictionaries** - Справочные данные (опыт, типы занятости и т.д.)
+7. **hh_get_resumes** - Список ваших резюме
+8. **hh_get_resume** - Детальная информация о резюме
+9. **hh_apply_to_vacancy** - Откликнуться на вакансию (требует OAuth)
+10. **hh_get_negotiations** - История откликов (требует OAuth)
+
+### Быстрый старт
+
+#### 1. Установка
+
+```bash
+git clone https://github.com/yourusername/headhunter-mcp-server.git
+cd headhunter-mcp-server
+python -m venv venv
+source venv/bin/activate  # В Windows: venv\Scripts\activate
+pip install -r requirements.txt
+```
+
+#### 2. Получение credentials HeadHunter API
+
+1. Зарегистрируйте приложение на [https://dev.hh.ru/admin](https://dev.hh.ru/admin)
+2. Получите Client ID, Client Secret и App Token
+3. Скопируйте `.env.example` в `.env` и заполните свои credentials
+
+```bash
+cp .env.example .env
+# Отредактируйте .env своими credentials
+```
+
+#### 3. Настройка Claude Code
+
+Добавьте в `~/.claude.json`:
+
+```json
+{
+  "mcpServers": {
+    "headhunter": {
+      "type": "stdio",
+      "command": "/путь/к/venv/bin/python",
+      "args": ["/путь/к/headhunter-mcp-server/server.py"],
+      "env": {
+        "HH_CLIENT_ID": "ваш_client_id",
+        "HH_CLIENT_SECRET": "ваш_client_secret",
+        "HH_APP_TOKEN": "ваш_app_token",
+        "HH_REDIRECT_URI": "https://ваш-домен.com/oauth/callback"
+      }
+    }
+  }
+}
+```
+
+#### 4. OAuth авторизация (опционально)
+
+Для откликов на вакансии и управления резюме:
+
+```bash
+python examples/oauth_flow.py
+```
+
+Следуйте инструкциям для авторизации и получения токенов доступа.
+
+### Примеры использования
+
+```bash
+# Поиск Python вакансий в Москве
+Найди 10 вакансий Python разработчика в Москве с зарплатой от 200000
+
+# Просмотр резюме
+Покажи мои резюме
+
+# Детали вакансии
+Покажи детали вакансии 126209046
+
+# Отклик на вакансию (после OAuth)
+Откликнись на вакансию 126209046 резюме [resume_id] с письмом: "Здравствуйте..."
+```
+
+### Vacancy Hunter Agent
+
+Автоматизированный агент для умного поиска и анализа вакансий. Подробности в [docs/vacancy-hunter-agent.md](docs/vacancy-hunter-agent.md).
+
+**Возможности:**
+- Анализирует несколько резюме одновременно
+- Оценивает релевантность вакансий (0-30 баллов)
+- Генерирует CSV отчёты с AI рекомендациями
+- Фокусируется только на регионе Москва
+
+**Использование:**
+```bash
+Запусти агента vacancy-hunter
+```
+
+### Структура проекта
+
+```
+headhunter-mcp-server/
+├── server.py              # MCP сервер (10 инструментов)
+├── hh_client.py           # HeadHunter API клиент
+├── requirements.txt       # Python зависимости
+├── .env.example           # Шаблон переменных окружения
+├── examples/
+│   └── oauth_flow.py      # Скрипт OAuth авторизации
+└── docs/
+    └── vacancy-hunter-agent.md  # Документация агента
+```
+
+### Требования
+
+- Python 3.10+
+- Claude Code или любой MCP-совместимый клиент
+- HeadHunter API credentials
+
+### Участие в разработке
+
+Приветствуются любые вклады! Не стесняйтесь отправлять Pull Request.
+
+### Лицензия
+
+MIT License - подробности в файле [LICENSE](LICENSE).
+
+### Ссылки
+
+- [Документация HeadHunter API](https://dev.hh.ru/)
+- [Model Context Protocol](https://modelcontextprotocol.io/)
+- [Документация Claude Code](https://docs.claude.com/en/docs/claude-code)
+
+---
+
+**Made with ❤️ for the HeadHunter and MCP community**