SpartanAltsoba/civic-intelligence-aggregator
GitHub: SpartanAltsoba/civic-intelligence-aggregator
AI 辅助的公共情报研究平台，将美国政府和金融公开数据聚合为结构化、可审计的 JSON 情报。
Stars: 3 | Forks: 0
# CivicIntelligence Aggregator
**一个 AI 辅助的研究平台，将权威的美国政府和金融数据源汇集为结构化、可审计的情报。**
Civic Intelligence Aggregator 是一个 Flask 应用程序，它查询公开的联邦数据源，并使用大型语言模型来解析、清理结果，并将其结构化为符合 schema 的 JSON —— 具有模块化的蓝图架构、实时的工作流状态以及全面的日志记录和错误处理。
## 数据源
| 模块 | 来源 | 提取内容 |
|--------|--------|---------------|
| `fec` | 联邦选举委员会 | 竞选财务 / 捐款 |
| `edgar` | SEC EDGAR | 企业申报文件 |
| `court_listener` | CourtListener | 联邦和州法院记录 |
| `civic_info` | Google Civic | 代表和公民数据 |
| `lobby_view` | 游说披露 | 联邦游说活动 |
| `search` + `gpt_handler` | IRS Form 990 (PDF/CSV) | 非营利组织财务数据，由 LLM 结构化为 JSON |
## 架构
Flask + blueprints (`search`, `dashboard`, `gpt_handler`, `civic_info`, `fec`, `edgar`, `court_listener`, `lobby_view`)。文档在被摄取后，会进行解析（对于 990 PDF 使用 pdfplumber），并由 LLM 根据定义的 schema 进行结构化。日志记录和错误处理集中在 `common.py` / `logger.py` 中。
## 设置
```
python -m venv venv && source venv/bin/activate
pip install -r requirements.txt
# 以环境变量的形式提供 API 密钥（参见 config.py）：
# OPENAI_API_KEY, FEC_API_KEY, GOOGLE_CIVIC_API_KEY, COURTLISTENER_TOKEN,
# LOBBY_VIEW_API_KEY, GOOGLE_SEARCH_API_KEY, GOOGLE_SEARCH_ENGINE_ID, ...
python app.py
```
## 许可证
Apache License 2.0 — © 2026 Sierra Special Investigations LLC。详见 [`LICENSE`](LICENSE)。
*前身为内部开发的 "StoryWeapon / 17thSCOG"。由 Sierra Special Investigations 开源，作为一项公共标准。*
标签：DLL 劫持, Flask, Petitpotam, 公共数据, 大语言模型, 情报分析, 数据清洗, 数据聚合, 竞选财务, 网络诊断, 逆向工具