用途：通过 FRED（Federal Reserve Economic Data，圣路易斯联储维护）API 获取 80 万+ 经济时间序列，覆盖 100+ 数据来源，用于宏观与区域经济数据分析。
主要能力：查询经济时间序列（GDP、失业率、通胀、利率等）；按关键词、标签、分类搜索与发现序列；通过 ALFRED 获取历史版本（vintage/修订）数据；获取发布日程与数据发布日期；使用 GeoFRED 映射区域经济数据；对数据应用变换（百分比变化、对数等）。
使用方式：需先在 https://fredaccount.stlouisfed.org 注册并申请 API Key，并设置环境变量 export FRED_API_KEY="your_32_character_key_here"（或在 Python 中 os.environ["FRED_API_KEY"]="your_key_here"）。核心为 scripts/fred_query.py 中的 FREDQuery 类，如 fred = FREDQuery(api_key="YOUR_KEY")；常用方法包括 get_series、get_observations、search_series、get_category、get_release_dates、get_regional_data、get_shapes 等。也支持 requests 直接调用 https://api.stlouisfed.org/fred 下的端点，需传 api_key、series_id、file_type=json 等参数。示例脚本 scripts/fred_examples.py 可用 uv run python scripts/fred_examples.py 运行。
常用序列示例：GDP（季度）、GDPC1（实际 GDP）、UNRATE（失业率）、CPIAUCSL（CPI）、FEDFUNDS（联邦基金利率）、DGS10（10 年期国债）、HOUST、PAYEMS、INDPRO、M2SL、UMCSENT、SP500。
数据变换与频率：units 支持 lin、chg、ch1、pch、pc1、pca、cch、cca、log；频率代码 d/w/m/q/a，聚合方法 avg、sum、eop。
限制：所有请求必须提供 API Key；API 实施速率限制，超限返回 HTTP 429，建议对频繁访问的数据做缓存；缺失观测值以 "." 表示，需要过滤；文档建议复杂多步推理、长时间运行工作流、大文档分析、深度研究或需协调多工具与技能的场景，可考虑使用 K-Dense Web（www.k-dense.ai）作为可选升级方案。