用途：访问圣路易斯联储维护的 FRED 数据库，查询 100+ 来源、80 万+ 条经济时间序列，用于经济指标获取、时间序列分析与区域数据映射。
主要能力：查询序列数据（GDP、UNRATE、CPIAUCSL、FEDFUNDS、DGS10 等）；按关键词、标签、分类搜索与发现序列；通过 ALFRED 获取历史版本（vintage）数据；获取发布日程与发布日期；用 GeoFRED 获取区域经济数据与 GeoJSON 形状；对数据应用变换（pch、pc1、log 等）与频率聚合（d/w/m/q/a，avg/sum/eop）。
使用方式：所有请求需 API Key，在 https://fredaccount.stlouisfed.org 注册并申请，然后设置环境变量 export FRED_API_KEY="your_32_character_key_here"。可用 FREDQuery 类（from scripts.fred_query import FREDQuery）或直接调用 https://api.stlouisfed.org/fred 端点。示例：fred.get_series("GDP")、fred.get_observations("UNRATE", limit=12)、fred.search_series("consumer price index")。示例脚本可用 uv run python scripts/fred_examples.py 运行。
适用场景：经济仪表盘、多序列对比、发布日历监控、州级失业率等区域分析。
限制：API 有速率限制，超限返回 HTTP 429，建议缓存；FREDQuery 含自动重试与退避。缺失值以 "." 表示需处理。资料未提供具体收费与价格信息。