核心功能
FRED Navigator 是一款面向经济数据检索的专业工作流工具，深度集成美联储圣路易斯分行FRED官方API，提供三级数据探索能力：
1. 层级化目录浏览
支持通过category_id直接定位，或利用fred_categories_tree.json进行树形结构浏览，实现从宏观经济领域到具体指标的多级钻取。目录数据涵盖FRED完整分类体系，包括货币银行、劳动力市场、价格水平等12大经济部门。
2. 精确序列检索
- 序列发现：
search_by_category返回序列关键元数据（ID、标题、频率、单位、季节性调整状态、最后更新） - 数据提取：
get_series获取完整时间序列，自动提供数据首尾预览、缺失值统计、最新观测值 - 元数据查询：
get_series_info获取详细定义、来源说明、发布机构等权威信息
3. 自然语言智能查询（特色功能）
采用意图识别+双重验证架构：
- Top-K意图识别：由Codex IDE代理解析自然语言查询，匹配最优目录候选
- 结构验证：候选目录必须存在于官方树形结构中，且具备有效子节点或可检索序列
- 语义验证：代理比对查询文本与目录名称/路径的相关性，输出通过/失败判定
- 置信度阈值：低置信度时强制用户确认，杜绝自动化错误传播
显著优势
- 数据源权威性：直接调用FRED官方API，数据与美联储同步，无中间商偏差
- 防错机制完善：双重验证拦截语义漂移，Top-5候选兜底策略避免检索失败
- 环境安全设计：API密钥强制环境变量读取，禁止硬编码，符合企业安全规范
- 可扩展架构：同义词表(
synonyms.json)、预计算路径(category_paths.json)支持持续优化匹配质量
潜在局限
- 中文支持有限：FRED原生为英文数据库，中文自然语言查询需依赖同义词表扩展
- 实时性边界：依赖本地缓存的目录树文件，非实时同步FRED官方分类变更
- 代理依赖风险：意图识别环节依赖Codex能力，复杂经济术语可能存在解析偏差
适用人群
- 宏观经济研究人员与政策分析师
- 金融量化策略开发者
- 经济数据 journalists 与智库研究员
- 需要批量获取美联储官方时间序列的Python/R用户
常规风险提示
- API配额：FRED API存在调用频率限制，大规模批量检索需规划请求节奏
- 数据修订：经济数据常经历回溯修正，建议关注
last_updated字段并建立版本管理 - 序列停用：部分历史序列可能被归档或合并，需定期验证序列活跃度
- 季节性调整选择：原始数据与季节调整数据差异显著，需根据分析目的明确指定