Eroloft/parser-2gis-new
GitHub: Eroloft/parser-2gis-new
Parser2GIS的现代化分支,通过Chrome浏览器抓取2GIS企业名录数据,提供Flask Web仪表板、多格式导出和潜在客户筛选功能。
Stars: 22 | Forks: 3
Parser2GIS
**Parser2GIS** - 借助 [Google Chrome](https://google.com/chrome) 浏览器抓取 [2GIS](https://2gis.ru/) 网站的解析器。

## ℹ️ 简介
用于自动采集在以下地区运营的企业地址与联系方式数据库的解析器:
俄罗斯

、哈萨克斯坦

、白俄罗斯

、
阿塞拜疆

、吉尔吉斯斯坦

、乌兹别克斯坦

、捷克

、埃及

、意大利

、沙特阿拉伯

、塞浦路斯

、阿拉伯联合酋长国

、智利

、卡塔尔

、阿曼

、巴林

、科威特

。
## ✨ 特点
- 💰 完全免费
- 🤖 在俄罗斯联邦境内可成功绕过反机器人封锁
- 🖥️ 支持 Windows、Linux 和 MacOS
- 📄 四种输出格式:CSV 表格、XLSX 表格、JSON 列表和 **HTML 页面**
- 🌐 浏览器中的**现代 Web 界面** —— 唯一的 UI(无参数启动)
- 🔗 Web 端直接内置**链接生成器**:城市 + 分类 → 生成可用的 2GIS URL
- 🧹 **结果过滤器:** 排除加盟连锁(每个企业仅保留 1 个分支机构),仅保留包含电话 / WhatsApp / 社交网络 / e-mail / 网站的结果,按评分和评论过滤
- 💬 **带 WhatsApp 和 2GIS 按钮的 HTML 页面** —— 打开即可立即联系客户
- ✨ **简洁的输出视图** —— 仅显示所需的列,无冗余数据
- ⚙️ 同一面板中提供高级设置(RAM 限制、点击延迟、编码、CSV 选项)
## 🚀 安装说明
### 从源码安装此 Fork 版本
此 Fork 版本的发行版名为 **`parser-2gis-new`**(导入包名保持为 `parser_2gis`)。
```
git clone <этот-репозиторий>
cd parser-2gis-new
python -m venv .venv
pip install -e .
```
运行(两个命令均可使用 —— `parser-2gis-new` 和 `parser-2gis`):
- `parser-2gis-new` —— 浏览器中的 **Web 界面**(默认);
- `parser-2gis-new -i
-o out.csv -f csv` —— 不打开浏览器的 CLI 模式。
### 原始项目 (PyPI)
```
pip install parser-2gis # CLI оригинального parser-2gis
pip install parser-2gis[gui] # с десктоп-GUI
```
## 📖 文档
有关操作的说明可在 [Wiki](https://github.com/interlark/parser-2gis/wiki) 中查看。
## 🔧 Fork 更改内容
此 Fork 保留了原版本的全部功能,并添加了:
- **现代化升级:** 迁移至 `pydantic` v2,支持 Python 3.12/3.13,并更新了构建依赖。
- **解析修复:** 在 headless 模式下,2GIS 地图(WebGL)未能初始化,导致页面发送了异常的 viewport,API 返回 `400 «Bound is incorrect»`。现已通过 Chrome 的新 headless 模式及强制设定 viewport 大小修复。
- **Web 界面作为唯一 UI。** 移除了桌面 GUI(tkinter/PySimpleGUI),所有功能均已转移至浏览器。不带参数启动即可打开仪表板。Flask 成为了核心依赖。
- **Web 端链接生成器:** 选择国家、城市(多选)及分类(支持在 1785 个分类中搜索) → 自动生成 2GIS URL 并添加至目标列表。
- **Web 端高级设置:** 浏览器 RAM 限制、点击延迟、“精确匹配”、编码、CSV 选项(分类、注释、空列、重复项、每个字段的列数)。
- **结果过滤器:** 加盟店去重(每个企业仅保留 1 个分支机构),仅保留包含电话/WhatsApp/社交网络/e-mail/网站的结果,按评分和评论数量过滤。支持所有格式;可在 CLI (`--filters.*`) 和 Web 端使用。
- **简洁的 CSV/XLSX 视图** (`--writer.csv.clean`) —— 仅保留核心且易读的列。
- **全新的 HTML 格式** (`-f html`) —— 一个包含卡片、WhatsApp / 拨打电话 / 2GIS / 社交网络按钮及搜索功能的独立页面。
- **改进的 XLSX:** 可点击的链接、自动调整列宽、冻结表头、自动筛选。
完整列表请见 [CHANGELOG.md](CHANGELOG.md)。
## 📜 许可证与版权
- 原始项目:**parser-2gis** — © **Andy Trofimov** (interlark@gmail.com),
https://github.com/interlark/parser-2gis
- 许可证:**GNU LGPLv3**(详见 [LICENSE](LICENSE))—— 保持不变。
- 此 Fork 中的修改按相同的 LGPLv3 条款分发。标签:Flask, Google Chrome, Homebrew安装, URL抓取, Web爬虫, 企业名录采集, 多模态安全, 数据导出, 数据抓取, 逆向工具