内容
<div align="center">
# 大维多利亚地区企业数据集
### 精神圣州最完整的活跃企业开放数据集 - 适用于市场勘探、研究和分析
**34.4 万活跃企业**，来自 **7 个城市**，交叉登记数据，**合伙人**，法律，处罚，活跃债务和环境违规 - 全部来自 **官方公共来源**。包含 **仪表盘**，**REST API**，**MCP** （ Claude ）和 **潜在客户分类**。
<br>
[](#)
[](#)
[](#)
[](#-consumir-o-dataset)
[](#-consumir-o-dataset)
[](#-projeto-em-construção)
<br>
<a href="https://github.com/sponsors/brunokobi">
<img src="https://img.shields.io/badge/%E2%9D%A4%EF%B8%8F%20支持该项目-GitHub%20Sponsors-ea4aaa?style=for-the-badge&logo=githubsponsors&logoColor=white" alt="在 GitHub Sponsors 上支持" height="42">
</a>
<sub>开放且无盈利的项目 - 您的支持有助于每月更新数据库。</sub>
<br><br>
### ⭐ 如果这个项目对您有帮助，请 **点亮一颗星星** - 这只需一秒钟，是免费的，并且有助于提高该项目的可见性！
</div>
---
## ⚡ 1 条命令即可开始
数据集作为 **GitHub Release** 分发（不会在存储库中版本化 - 使所有内容保持轻量）。设置脚本使用 [uv](https://docs.astral.sh/uv/) 创建隔离的 Python 3.12 环境（如果需要，安装 uv 本身），安装依赖项并 **下载数据集** - **无需预先安装 Python**，也不依赖于操作系统已经提供的版本。
**Linux，macOS 或 WSL：**
```bash
git clone https://github.com/brunokobi/projeto_grande_vitoria_empresas.git
cd projeto_grande_vitoria_empresas
bash setup.sh
source .venv/bin/activate
uvicorn api:app # http://localhost:8000
```
**Windows（原生 PowerShell，无需 WSL）：**
```powershell
git clone https://github.com/brunokobi/projeto_grande_vitoria_empresas.git
cd projeto_grande_vitoria_empresas
powershell -ExecutionPolicy Bypass -File setup.ps1
.venv\Scripts\Activate.ps1
uvicorn api:app # http://localhost:8000
```
准备就绪：`http://localhost:8000` 上的 **仪表盘**，`/docs` 上的 **API**，以及被 Claude Code 检测到的 **MCP** （`.mcp.json`）。
> **注意（LGPD）。** 数据来自官方公共来源，但数据集整合了个人数据（合伙人姓名，屏蔽的 CPF，地址）。请负责任地使用，并遵守 LGPD。
---
## 📸 界面截图
<div align="center">
**仪表盘 - 列表，过滤器和潜在客户分类**
<img src="docs/dashboard.png" alt="仪表盘" width="100%">
**企业 360 度视图** - 登记，合伙人 + 网络，详细待办事项和地图
<img src="docs/empresa-360.png" alt="企业 360 度视图" width="70%">
</div>
---
## 🚧 项目进行中
积极开发中。当前状态：
| 组件 | 状态 |
|---|---|
| 登记（Receita）· **合伙人** · JUCEES | ✅ 完成（34.4 万企业 · 23.1 万合伙人） |
| 活跃债务 **PGFN** （详细） | ✅ 完成 |
| 联邦 **CEIS/CNEP** + 州 **TCEES** 制裁 | ✅ 完成 |
| **IBAMA** 环境违规（详细） | ✅ 完成 |
| 地理编码（地图，OpenStreetMap） | 🚧 处理中 - **预计 ~30/07/2026** |
| 司法程序（DataJud/CNJ，TJES） | 🚧 处理中 - **预计 ~20/09/2026** |
| 联系方式和社交媒体（WhatsApp，网站，Instagram…） | 🧪 已实施 |
| 仪表盘 · API · MCP · Excel/PDF 导出 · **潜在客户分类** | ✅ 功能齐全 |
> ⏳ 上述预测是基于当前节奏的**估计** - 这两个阶段依赖于具有请求限制的公共 API（OpenStreetMap ~1/s；CNJ 有节流），因此需要几天/几周。数据集的其余部分已经完成并可用；地理和过程正在纳入其中。
---
## 💼 您将获得
| | |
|---|---|
| 🏢 **登记** | CNPJ，社会名称，CNAE（按名称），规模，制度，资本，地址，情况 |
| 👥 **合伙人 + 网络** | 公司章程（姓名，资格，年龄段）和 **同一合伙人出现在哪些其他企业中** |
| ⚖️ **详细法律和税务情况** | 活跃债务（税种，诉讼，风险），联邦/州制裁（理由），IBAMA 违规（罚款金额，严重程度），程序 |
| 🧭 **丰富** | 地理位置（地图）和联系方式/社交媒体 |
| 🎯 **潜在客户分类** | 按商业目标分类的问卷 → 评分 0–100（🔥 热门 / 🙂 一般 / ❄️ 冷淡） |
| 🔌 **访问** | 仪表盘，REST API，MCP 服务器（Claude），Excel 和 PDF 导出 |
---
## 🔗 交叉数据源
所有内容均通过 **CNPJ** 交叉引用，**官方公共来源**：
| 来源 | 汇总内容 | 状态 |
|---|---|:--:|
| **Receita Federal** （CNPJ） | 登记，**合伙人**，CNAE，规模，资本，地址 | ✅ |
| **JUCEES** （dados.es.gov.br） | NIRE，成立，法律性质 | ✅ |
| **PGFN** | 活跃债务（税种，金额，诉讼） | ✅ |
| **CGU** - 透明度门户 | 联邦制裁 **CEIS/CNEP** （法律依据） | ✅ |
| **TCEES** | 州制裁（程序/决定） | ✅ |
| **IBAMA** | 环境违规（罚款金额，严重程度，情况） | ✅ |
| **OpenStreetMap** | 地理位置（纬度/经度） | 🚧 |
| **DataJud / CNJ** | 司法程序（TJES） | 🚧 |
| IEMA-ES · RAIS/CAGED | 州环境 · 员工人数 | 🔭 计划中 |
> 数据集的构建/更新由单独的存储库中维护的提取管道完成。这是 **消费产品**。
---
## 🖥️ 使用数据集
在仪表盘、API 和 MCP 之间共享查询逻辑（`src/dataset_queries.py`）- 所有人都在 **只读** 中读取 SQLite。
### 仪表盘
`uvicorn api:app` → **http://localhost:8000**。过滤器（CNAE 分段，市，规模，制度，待办事项类型，资本，联系方式/社交媒体，搜索），企业 **360 度视图**，带有 **可扩展卡片**（债务，制裁，违规和详细合伙人）+ 地图，**潜在客户分类**（问卷）和 **Excel/PDF 导出**。
### REST API（FastAPI）- `/docs` 中的文档
- `GET /estatisticas` · `GET /segmentos`
- `GET /empresas` - 带有过滤器（市，`cnae_prefix`，规模，制度，`socio`（名称），`tem_pendencia`，`com_processos`/`com_sancoes`/`com_ambiental`/`com_divida`，`com_telefone`/`com_email`/`com_whatsapp`/`com_rede_social`，资本，排序，分页）
- `GET /empresas/{cnpj}` - 360 度视图（登记，合伙人 + 网络，详细待办事项，地理）
- `GET /classificar` - 按商业目标对潜在客户进行评分和排名
- `GET /export/empresas.xlsx` · `GET /export/empresas.pdf`
### MCP 服务器
用于 Claude 和其他 MCP 客户端的 `estatisticas`，`buscar_empresas`，`obter_empresa`，`classificar_empresas` 工具。`.mcp.json` 在执行 `setup.sh` 后自动检测。
📘 **完整连接教程**（Claude Desktop，Claude Code，Cursor，Windsurf，VS Code/Copilot，Cline）： **[MCP.md](MCP.md)**。
---
## 💛 支持该项目
[](https://github.com/sponsors/brunokobi) · 等级见 [](SPONSORS.md)
## 💬 联系方式，意见和贡献
| 我想... | 如何 |
|---|---|
| 🔗 建议新的数据源 | [](https://github.com/brunokobi/projeto_grande_vitoria_empresas/issues/new?template=nova-fonte.yml) |
| 💡 建议，改进或请求 | [](https://github.com/brunokobi/projeto_grande_vitoria_empresas/issues/new?template=sugestao.yml) |
| 🐞 问题或投诉 | [](https://github.com/brunokobi/projeto_grande_vitoria_empresas/issues/new?template=problema.yml) |
| 📧 直接联系 | [](mailto:brunokobi2@hotmail.com) |
| 🌐 网站/作品集 | [](https://brunokobi.netlify.app) |
---
<div align="center">
<sub>在圣埃斯皮里图州使用 💛 制作 · 来自官方公共来源的数据 · 请根据 LGPD 使用</sub>
</div>
