Skip to content

andreipromarketing-dev/ohotnik-za-klientami

Repository files navigation

Охотник за клиентами

Парсер B2B контрагентов с автоматическим обогащением данных.

Что делает программа

Программа создает Excel/CSV файл с компаниями и для каждой компании:

  1. Ищет сайт — через Google Search (SearchApi.io)
  2. Парсит контакты — телефон, email, соцсети (VK, Telegram, MAX)
  3. Если контактов нет — использует AI (локальный LLM) для поиска ФИО директора/ЛПР на сайте

Как запустить

Windows

Просто запустите файл start.bat — откроется веб-интерфейс в браузере.

Linux/Mac

chmod +x start.sh
./start.sh

Интерфейс доступен по адресу: http://localhost:8501

Требования

  • Python 3.10+
  • (опционально) LM Studio — внешняя программа для локального AI. Скачайте с https://lmstudio.ai/, установите модель и запустите. Программа подключится к ней автоматически.

Установка

pip install -r requirements.txt

Настройка

  1. Скопируйте .env.example в .env
  2. Заполните необходимые ключи:
# Обязательно для поиска сайтов
SEARCHAPI_API_KEY=ваш_ключ

# Опционально для поиска в VK
VK_TOKEN=ваш_токен_vk

# Для Groq AI (опционально, бесплатный)
GROQ_API_KEY=ваш_ключ_groq

Где взять ключи

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

  1. Запустите start.bat
  2. В интерфейсе выберите: нишу, город, количество контрагентов
  3. Нажмите "Запуск" — начнётся первичный поиск, результаты сохранятся в таблицу
  4. Нажмите "Шаг 2" — AI (LM Studio) обогатит данные (ФИО директора/ЛПР/почта/соцсети - если есть на сайте)
  5. Скачайте результат в Excel

Внизу интерфейса — лог операций (можно использовать для отладки/доработки в Claude Code, Cursor, OpenCode)

Структура файлов

├── app.py              # Интерфейс Streamlit
├── config.py           # Настройки
├── enricher.py         # Парсинг и обогащение
├── search_providers.py # Поиск через SearchApi
├── lm_studio_client.py # AI-клиент (LM Studio)
├── groq_client.py      # AI-клиент (Groq)
├── unclose_client.py   # AI-клиент (UncloseAI)
├── start.bat           # Запуск (Windows)
└── requirements.txt    # Зависимости

AI Провайдеры

Программа поддерживает 3 AI провайдера для поиска ЛПР:

Провайдер Модели Требования
LM Studio локальные Установить приложение
Groq Llama 3.1, DeepSeek R1 Бесплатный ключ с console.groq.com
UncloseAI Hermes, Qwen Без ключей (нужен VPN)

⚠️ Важно

Пользуйтесь этими услугами на свой страх и риск.

  • Всё, что вы вводите (подсказки, файлы, личные данные), может быть залогировано
  • Не отправляйте чувствительную информацию
  • Бесплатные сервисы могут исчезнуть или изменить условия без предупреждения
  • Не используйте для production-проектов

Лицензия

MIT

About

Парсер контрагентов B2B с обогащением локальным ИИ (или по API)

Resources

Stars

Watchers

Forks

Packages

 
 
 

Contributors