# ana-data/tools

本目录存放 `project-info` 研报案例体系可复用的数据抓取和只读导出脚本。脚本只负责抓取、导出和归档，不负责生成正式结论。

使用前必须先看 `ana-doc/数据抓取脚本说明.md`、`ana-doc/案例分析规范.md` 和对应行业的 `案例分析设计.md`。

当前脚本：

| 脚本 | 用途 |
|---|---|
| `collect_web_sources.py` | 抓取显式 URL，保存网页、PDF、CSV、JSON 或文本快照，并写入行业 manifest |
| `export_mysql_query.py` | 执行本地 MySQL 只读 SQL，导出 CSV，并写入查询 manifest |
| `market_gap_scan_mysql.py` | 基于本地 A 股画像和日线表做市场反向补漏初筛，输出强显影候选 |

通用约束：

1. 不在命令行或文档里写数据库密码、token 或 cookie。
2. MySQL 密码只从 `TIANXIA_MYSQL_PASSWORD` 环境变量读取。
3. 抓取结果必须进入行业 `supplement/`、`evidence/` 或 `manifest/`，不得留在工具目录。
4. 市场反向补漏结果只能作为缺口扫描输入，不能直接作为投资结论。