技能介绍

追踪宏观经济数据面临两个难题：数据分散在多个门户和接口，格式互不兼容；部分第三方接口不稳定，容易导致采集脚本频繁报错中断。这个技能将精力集中在数据获取与整理，提供三层数据源架构与自动降级策略，按优先级整合后直接写入本地 macro_data.json。

核心能力与工作流

第 1 层（主数据源）：通过东方财富网数据中心 API（datacenter-web.eastmoney.com）获取 9 类中国核心宏观指标（GDP、CPI、PPI、PMI、M2 等），此过程无需任何 API Token。脚本 scripts/scrape_eastmoney.py 负责抓取并自动计算衍生指标（如 CPI-PPI、M1-M2 剪刀差、中美利差）。

第 2 层（补充源）：调用 scripts/scrape_sina.py 尝试抓取新浪宏观细表。该脚本内置接口探测机制，若发现接口失效（如当前已 302 下线），会自动打印提示并跳过，不会阻塞主流程；待接口恢复后，无需改动代码即可自动生效。

第 3 层（回退补全）：对于前两层无法覆盖的全球及市场类指标（如 BDI、国债收益率、美元指数、A股成交额等），scripts/macro_dashboard.py 会调用 Tushare 与 AKShare 进行回退补全。主流程 scripts/merge_data.py 最终将各层数据合并写入 JSON，由 scripts/build_dashboard.py 生成 HTML 看板。

适用边界与避坑

Token 管理：主流程完全依赖东方财富 API，不存储或内嵌任何密钥。仅当执行第 3 层回退脚本时，才需从环境变量 TUSHARE_TOKEN 或本地配置读取凭证。若无 Token，脚本会自动降级为仅使用 AKShare（无需 Token），不会报错退出。
沙箱限制：运行回退脚本前，必须设置 TUSHARE_HOME 环境变量指向可写目录，否则 Tushare 尝试在根目录写入 tk.csv 时会被沙箱拦截导致崩溃。
数据口径差异：需注意部分接口返回的字段含义。例如固投接口返回的可能是绝对额而非同比增速；两融余额接口默认仅返回上交所数据，深市部分需结合 WebSearch 补全。