用途：访问 FRED（Federal Reserve Economic Data）经济数据库，查询 GDP、失业率、通胀、利率等 80 万+ 时间序列，数据来自 100+ 来源。
主要能力：按序列 ID 获取观测值（如 GDPC1、UNRATE、CPIAUCSL、DGS10）；按关键词、标签、分类搜索序列；获取发布日历与发布日期；通过 ALFRED 获取历史修订（vintage）数据以避免前视偏差；用 GeoFRED 获取州/县级区域数据与 GeoJSON；服务端数据变换（pc1、pch、log 等）与频率聚合；API v2 可批量下载某次发布中的全部序列。
使用方式：需 API Key，在 https://fredaccount.stlouisfed.org 注册申请后设置环境变量 export FRED_API_KEY="your_32_character_key_here"。可用 scripts/fred_query.py 的 FREDQuery 类，例如 fred.get_observations("GDP", limit=1, sort_order="desc") 取最新值，fred.get_series("GDP") 返回元数据（标题、单位、频率），fred.search_series("consumer price index") 搜索序列。也可直接请求 https://api.stlouisfed.org/fred 端点。示例脚本 scripts/fred_examples.py 可用 uv run python scripts/fred_examples.py 运行。
限制：所有请求需 API Key；限速约每分钟 120 次，超限返回 HTTP 429，可能被临时封禁，建议缓存并优先用 v2 批量下载。不适用于股票/ETF 行情、Treasury 债务数据、SEC 财报、非 FRED 全球指标或计量建模。论文引用需注明序列 ID、来源机构与检索日期。