Parser2GIS

🍴 Это форк

Проект является форком parser-2gis (© Andy Trofimov, лицензия LGPLv3). Оригинальная разработка принадлежит автору; здесь добавлены модификации — см. раздел «Изменения форка» и CHANGELOG. Это независимый форк, не одобрен и не поддерживается оригинальным автором.

Parser2GIS - парсер сайта 2GIS с помощью браузера Google Chrome.

Скриншот веб-дашборда Parser2GIS

ℹ️ Описание

Парсер для автоматического сбора базы адресов и контактов предприятий, которые работают на территории России , Казахстана , Беларуси , Азербайджана , Киргизии , Узбекистана , Чехии , Египта , Италии , Саудовской Аравии , Кипра , Объединенных Арабских Эмиратов , Чили , Катара , Омана , Бахрейна , Кувейта .

✨ Особенности

  • 💰 Абсолютно бесплатный
  • 🤖 Успешно обходит анти-бот блокировки на территории РФ
  • 🖥️ Работает под Windows, Linux и MacOS
  • 📄 Четыре выходных формата: CSV таблица, XLSX таблица, JSON список и HTML-страница
  • 🌐 Современный веб-интерфейс в браузере — единственный UI (запуск без аргументов)
  • 🔗 Генератор ссылок прямо в вебе: город + рубрика → готовый URL 2GIS
  • 🧹 Фильтры результатов: без франшиз (1 филиал на организацию), только с телефоном / WhatsApp / соцсетями / e-mail / сайтом, по рейтингу и отзывам
  • 💬 HTML-страница с кнопками WhatsApp и 2GIS — открыл и сразу пише��ь клиентам
  • ✨ Чистый вид вывода — только нужные колонки, без мусора
  • ⚙️ Расширенные настройки (лимит RAM, задержка кликов, кодировка, CSV-опции) в той же панели

🚀 Установка

Для работы парсера необходимо установить браузер Google Chrome.

Установка этого форка из исходников

Дистрибутив форка называется parser-2gis-new (import-пакет остался parser_2gis).

git clone <этот-репозиторий>
cd parser-2gis-new
python -m venv .venv
pip install -e .

Запуск (доступны обе команды — parser-2gis-new и parser-2gis):

  • parser-2gis-new — веб-интерфейс в браузере (по умолчанию);
  • parser-2gis-new -i <URL> -o out.csv -f csv — CLI без браузера.

Десктоп-GUI (tkinter/PySimpleGUI) в этом форке удалён — весь интерфейс перенесён в браузер.

Оригинальный проект (PyPI)

pip install parser-2gis        # CLI оригинального parser-2gis
pip install parser-2gis[gui]   # с десктоп-GUI

📖 Документация

Описание работы доступно на вики.

🔧 Изменения форка

Форк сохраняет всю функциональность оригинала и добавляет:

  • Модернизация: переход на pydantic v2, поддержка Python 3.12/3.13, обновлённые сборочные зависимости.
  • Фикс парсинга: в headless-режиме карта 2GIS (WebGL) не инициализировалась, из-за чего страница отправляла вырождённый viewport и API отвечал 400 «Bound is incorrect». Исправлено через новый headless-режим Chrome и принудительный размер вьюпорта.
  • Веб-интерфейс — единственный UI. Десктоп-GUI (tkinter/PySimpleGUI) удалён, все его функции перенесены в браузер. Запуск без аргументов открывает дашборд. Flask стал основной зависимостью.
  • Генератор ссылок в вебе: выбор страны, города (мультивыбор) и рубрики (поиск по 1785 рубрикам) → готовые URL 2GIS добавляются в список направлений.
  • Расширенные настройки в вебе: лимит RAM браузера, задержка кликов, «точные совпадения», кодировка, CSV-опции (рубрики, комментарии, пустые колонки, дубликаты, колонок на поле).
  • Фильтры результатов: дедуп франшиз (1 филиал на организацию), только с телефоном/WhatsApp/соцсетями/e-mail/сайтом, по рейтингу и количеству отзывов. Работают для всех форматов; доступны в CLI (--filters.*) и в вебе.
  • Чистый вид CSV/XLSX (--writer.csv.clean) — только основные читаемые колонки.
  • Новый формат HTML (-f html) — самодостаточная страница с карточками и кнопками WhatsApp / звонок / 2GIS / соцсети и поиском.
  • Улучшенный XLSX — кликабельные ссылки, авто-ширина колонок, заморозка шапки, автофильтр.

Полный список — в CHANGELOG.md.

📜 Лицензия и авторство

  • Оригинальный проект: parser-2gis — © Andy Trofimov ([email protected]), https://github.com/interlark/parser-2gis
  • Лицензия: GNU LGPLv3 (см. LICENSE) — сохранена без изменений.
  • Модификации в этом форке распространяются на тех же условиях LGPLv3.