用途:帮助经济学研究者从主要经济数据 API 获取数据,覆盖 FRED、世界银行、BLS、OECD、Yahoo Finance 等来源,并生成干净、带文档与错误处理的 Python 代码。适用场景包括下载宏观经济指标、从多来源构建自定义数据集、为持续项目自动化数据更新、获取跨国面板数据。
主要能力:按数据类型选择来源与包,例如美国宏观用 FRED(fredapi)、全球发展用世界银行(wbdata)、劳动统计用 BLS(requests,BLS API v2)、跨国 OECD 用 requests(OECD SDMX API)、跨国宏观金融用 IMF(imf-reader)、金融资产价格用 Yahoo Finance(yfinance)。生成代码包含 API 密钥处理(环境变量)、API 失败错误处理、数据清洗与格式化、序列定义文档。
使用方式:先做 API 密钥检查,读取 [plugin_root]/.env,检查 FRED_API_KEY 与 BLS_API_KEY;FRED 密钥缺失时提示用户到 https://fred.stlouisfed.org/docs/api/api_key.html 获取并保存;BLS 密钥可选,可提升速率限制,获取地址 https://www.bls.gov/developers/。代码通过 python-dotenv 的 load_dotenv() 从环境变量读取密钥,不硬编码。随后确认数据需求(指标、时间范围与频率、国家/地区、输出格式),再选择 API 并生成代码。
限制:BLS API v2 每次请求限制 20 年窗口,需自动分块;FRED 密钥必需,BLS 密钥可选;.env 仅本地存储、不提交版本控制;资料未提供 OECD 与 Yahoo Finance 的具体代码示例及更多细节。