用途
本工具包为自包含的A股金融数据工具包，用于提供A股市场实时金融数据和定量计算，面向需要实时A股市场数据支撑投资分析的场景。所有数据源免费，无需API密钥。
主要能力
A股数据（scripts/stock_data.py）
通过AKShare获取A股基本面、行情、财务指标，支持以下命令：
python scripts/stock_data.py 600519：基本信息（贵州茅台）python scripts/stock_data.py 600519 --metrics：完整财务指标（估值、盈利、杠杆、增长）python scripts/stock_data.py 600519 --history：历史OHLCV行情python scripts/stock_data.py 600519 --financials：利润表、资产负债表、现金流量表python scripts/stock_data.py 600519 --insider：董监高增减持数据python scripts/stock_data.py --northbound：北向资金流向（沪股通/深股通）python scripts/stock_data.py 600519 000858 --screen：批量筛选
宏观数据（scripts/macro_data.py）
通过AKShare获取中国宏观经济指标，支持以下命令：
python scripts/macro_data.py --dashboard：完整宏观仪表盘python scripts/macro_data.py --rates：利率数据（LPR、Shibor）python scripts/macro_data.py --inflation：CPI/PPI数据python scripts/macro_data.py --pmi：PMI数据（制造业/非制造业）python scripts/macro_data.py --social-financing：社会融资规模 + M2python scripts/macro_data.py --cycle：经济周期阶段判断
使用方式
安装依赖（一次性）：
pip install -r requirements.txt
所有脚本位于 scripts/ 目录，需从技能根目录运行。
输出格式
所有脚本以 JSON 输出到标准输出，便于解析。错误信息输出到标准错误。
配置
可选：编辑 config/data_sources.yaml 自定义速率限制或添加付费数据源API密钥。
数据来源
| 来源 | 数据内容 | API密钥 |
|---|---|---|
| AKShare | A股行情、财务数据、董监高交易、北向资金、宏观指标 | 无需 |
适用场景
适用于需要实时A股市场数据支撑投资分析的场景，包括获取个股基本面与行情、财务指标分析、董监高增减持跟踪、北向资金流向监控、批量筛选，以及宏观经济指标（利率、通胀、PMI、社融、M2）与经济周期阶段判断。
限制
资料未提供关于数据更新频率、数据覆盖市场范围、脚本运行环境版本要求、付费数据源具体支持情况、准确性或延迟等方面的说明，暂未提供。