twux-sec/corprecon

# CorpRecon    CorpRecon investigates French companies and their directors using public registers (INSEE SIRENE, BODACC, Pappers). Given a person's name or a SIREN number, it maps all corporate mandates and detects shared structures where multiple directors overlap — a common pattern in holding networks and related-party schemes. ## 特性 - **Person lookup** — find all corporate mandates held by a person (active and past) - **Company lookup** — list all directors of a company by SIREN number - **Cross-detection** — identify shared structures where multiple directors of a company also co-appear - **Async & rate-limited** — respects INSEE API limits, uses async HTTP for performance - **Clean data models** — Pydantic v2 models with validation and computed properties ## 安装 ``` git clone https://github.com/twux-sec/corprecon.git cd corprecon pip install -e . ``` For development (includes pytest): ``` pip install -e ".[dev]" ``` ## 配置 Get a free INSEE SIRENE API token at [api.insee.fr](https://api.insee.fr), then: ``` cp .env.example .env # 编辑 .env 并粘贴您的令牌 ``` ## 快速入门 ``` # 搜索某人的所有授权 corprecon person "Jean Dupont" # 通过 SIREN 查找公司 corprecon company 913234567 # 交叉引用：检测董事间的共享结构 corprecon cross 913234567 ``` ## 架构 ``` corprecon/ ├── cli.py # Typer CLI — person, company, cross commands ├── models.py # Pydantic models: Company, Person, Mandate ├── crosser.py # Cross-detection logic (shared structures) └── sources/ ├── insee.py # INSEE SIRENE V3 async wrapper ├── pappers.py # (V1.5) Pappers API wrapper └── bodacc.py # (V2) BODACC announcements ``` ## 路线图 - [x] **V1** — INSEE SIRENE integration, person/company/cross commands, tests - [ ] **V1.5** — Pappers API integration (richer director data) - [ ] **V2** — NetworkX relationship graph + GraphML export for Gephi ## 设计者 Designed by [@twux-sec](https://github.com/twux-sec). Implementation assisted by Claude AI (Anthropic) — code reviewed, tested and integrated by the author. ## 法律与伦理使用 - **GDPR compliant** — CorpRecon only queries publicly available data published in official French registers (RCS, INSEE SIRENE, BODACC). - **Public sources only** — no scraping of social media, no access to private or restricted databases. - **No targeting of private individuals** outside of a legal framework. - **Intended use cases**: research, journalism, financial due diligence, and authorized investigations only. ## 许可证 [MIT](LICENSE) — Twux ## 联系 GitHub: [@twux-sec](https://github.com/twux-sec)

标签：API, BODACC, BSD, CLI, ESC4, INSEE, OSINT, Pappers, Pydantic, Python, SIRENE, Typer, WiFi技术, 二进制发布, 企业情报, 公司控股, 公司网络, 公开登记, 关联企业, 合规调查, 开源工具, 异步, 数据挖掘, 数据验证, 无后门, 法人图谱, 法国企业, 系统分析, 网络分析, 董事交叉, 逆向工具