Автоматический фильтр резюме через Yandex Mail и GigaChat

Мини-проект на Python, автоматизирующий первичный отбор кандидатов:
сканирует входящие письма с резюме, извлекает файлы и фильтрует их с помощью GigaChat по заданным критериям.

📌 Описание

Проект состоит из двух скриптов:

1. mail_parser.py
   
   Подключается к почтовому ящику Yandex, находит непрочитанные письма с вложениями резюме (поддерживаются
   .pdf
   ,
   .docx
   ,
   .doc
   ), сохраняет файлы в папку
   resumes/
   .

2. resume_filter.py
   
   Обрабатывает сохранённые резюме с помощью GigaChat:
   • извлекает имя и фамилию кандидата,
   • оценивает соответствие заданным пользователем критериям (например, опыт в IT, знание Python, образование и т.д.),
   • сохраняет подходящие резюме в папку
     selected/
     с именем файла в формате
     Имя_Фамилия.pdf
     .

👥 Для кого это полезно?

Этот инструмент особенно полезен HR-специалистам, рекрутерам и владельцам малого бизнеса, получающим большое количество резюме по email и желающим:

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

🛠 Требования

• Python 3.8+
• Библиотеки:
  imaplib
  ,
  email
  ,
  os
  ,
  requests
  (для GigaChat API) и, при необходимости,
  python-docx
  ,
  PyPDF2
  или аналоги для извлечения текста.
• Доступ к почтовому ящику Yandex с включённым IMAP.
• API-ключ GigaChat (см. документацию GigaChat).

▶️ Как использовать

1. Укажите в
   mail_parser.py
   данные для входа в почту (логин, пароль приложения).
2. В
   resume_filter.py
   задайте критерии отбора (например, «опыт в backend-разработке от 3 лет»).
3. Запустите сначала
   yandex_parser.py
   , затем
   resume_filter.py
   :

4. Подходящие резюме появятся в папке
   resume_path/
   .

🔒 Конфиденциальность

Проект работает локально:

• письма и файлы не передаются третьим лицам,
• запросы к GigaChat содержат только текст резюме (без метаданных),
• вы полностью контролируете, какие данные обрабатываются.

📄 Лицензия

MIT License — используйте и модифицируйте по своему усмотрению.