360 Secure SkillHub
360 安全技能中心

macro-monitor

这是一款Python宏观数据抓取工具,整合Alpha Vantage、Tushare、Stooq多数据源,核心功能包括原子化抓取单类数据、整体数据聚合,支持备用源切换。典型用于开发场景中快速获取宏观市场数据或中国宏观核心指标。通过Python类方法调用,可指定抓取范围或强制用备用源,输出含数据值、时间戳、数据源状态的结构化字典,需配置对应API密钥并安装依赖库。

chinfi-codex
chinfi-codex
热度 22.43
最近更新 2026-03-28 14:16:53
分类:数据依赖:代码执行 / 第三方 API应用场景:数据处理 / 财务

安装技能

复制下面的话术发给你的 Agent,它会通过 secure-skills 检索并安装该技能。

执行命令安装此 skill: npx secure-skills-cli add macro-monitor-data-only
Metadata
name
macro-monitor
version
0.1.1
description
宏观数据抓取工具,整合 Alpha Vantage、Tushare 与 Stooq 备用源,提供原子化抓取接口与原始数据聚合。
trigger_patterns
["宏观数据抓取","macro monitor","获取宏观数据","汇率和美债数据","中国宏观指标"]

宏观数据抓取

macro-monitor 现在只负责数据获取与聚合,不再包含分析、波动率计算或文本报告生成。

数据源

数据源 数据类型 优先级
Alpha Vantage USD/CNY、美债收益率、BTC、WTI、天然气 P0
Tushare 中国 CPI、PPI、社融、PMI P0
Stooq BTC、黄金、WTI、天然气、纳指期货 P1(备用)

使用方式

获取全部数据

from macro_monitor import MacroDataMonitor

monitor = MacroDataMonitor()
data = monitor.get_all_data()
print(data)

调用原子化抓取方法

monitor = MacroDataMonitor()

fx_data = monitor.fetch_fx_data()
us_rates = monitor.fetch_us_rates_data()
crypto_data = monitor.fetch_crypto_data()
energy_data = monitor.fetch_energy_data()
china_cpi = monitor.fetch_china_cpi_data()
china_ppi = monitor.fetch_china_ppi_data()
china_soci = monitor.fetch_china_soci_data()
china_pmi = monitor.fetch_china_pmi_data()
china_macro = monitor.fetch_china_macro_data()
backup_market = monitor.fetch_backup_market_data()

只抓市场数据

market_data = monitor.fetch_market_data()

强制使用备用源

market_data = monitor.fetch_market_data(use_backup=True)

输出格式

get_all_data()

{
    "timestamp": "2026-03-28 12:00:00",
    "sources": {
        "alpha_vantage": "OK",
        "tushare": "OK"
    },
    "data": {
        "USD_CNY": 7.24,
        "US_TREASURY_10Y": 4.25,
        "BTC": 67245.0,
        "WTI": 81.45,
        "NATURAL_GAS": 2.85,
        "CHINA_MACRO": {
            "CPI": {"value": 0.7, "yoy": 0.7, "date": "202502"}
        }
    }
}

sources 状态值

  • OK: 数据源调用成功。
  • MISSING_CONFIG: 缺少对应环境变量,已跳过该数据源。
  • RATE_LIMITED: Alpha Vantage 被限流或暂不可用,已回退到备用源。
  • ERROR: 已配置但调用失败。

环境变量

export ALPHAVANTAGE_API_KEY="your_alphavantage_key"
export TUSHARE_TOKEN="your_tushare_token"

未配置环境变量时,skill 会返回空数据并在 sources 中标记 MISSING_CONFIG,不会使用任何默认密钥。

依赖

pip3 install requests pandas tushare