fin-monitor（鳍监视器）

Finance Monitor

定期抓取金融指标数据，写入本地 SQLite 数据库。

⚠️ 安全声明

API Key 是敏感信息，请勿将真实 API Key 直接写入 skill 或任何公开可访问的文件。

获取 Finnhub API Key（免费注册）：https://finnhub.io/register

Key 安全传递方式

数据源

注意：Finnhub 免费版不支持 SPX、NDX、黄金、VIX、国债收益率。如需这些指标，推荐使用 Finnhub Pro 或其他数据源。

参数

安装依赖

Python 3

python3 --version

使用方式

用户说以下内容时触发：

• "抓取金融数据"
• "更新指标数据"
• "刷新 finance 数据库"

推荐方式

export FINNHUB_API_KEY=你的key
python3 scripts/fetch_data.py --db-path ~/finance/finance.db

备用方式（仅测试用）

python3 scripts/fetch_data.py \
  --db-path ~/finance/finance.db \
  --finnhub-key 你的key

数据库表结构

CREATE TABLE indicators (
    id INTEGER PRIMARY KEY AUTOINCREMENT,
    fetch_date TEXT NOT NULL,
    fetch_time TEXT NOT NULL,
    name_cn TEXT NOT NULL,
    code TEXT NOT NULL,
    prev_close REAL,
    current_price REAL,
    after_hours REAL,
    change_pct REAL,
    week52_high REAL,
    dist_from_high_pct REAL,
    week52_low REAL,
    dist_from_low_pct REAL,
    source TEXT DEFAULT 'nasdaq',
    created_at TEXT DEFAULT (datetime('now', 'localtime'))
);

CREATE TABLE fetch_log (
    id INTEGER PRIMARY KEY AUTOINCREMENT,
    fetch_date TEXT NOT NULL,
    fetch_time TEXT NOT NULL,
    source TEXT NOT NULL,
    indicators_count INTEGER,
    created_at TEXT DEFAULT (datetime('now', 'localtime'))
);

返回格式

✅ Data fetched | 2026-03-23 18:00
📂 DB: ~/finance/finance.db

Indicator          Code   Price        Change
------------------------------------------------
标普500 ETF          SPY      648.57      -1.70%
纳斯达克100 ETF        QQQ      582.06      -1.85%
WTI 原油            CL        85.12       +0.81%
美元指数            DX        12.39        -0.23%

定时任务

macOS / Linux

# 编辑 crontab
crontab -e

# 添加（每小时整点执行）
0 * * * * cd ~/finance && FINNHUB_API_KEY=你的key /usr/bin/python3 fetch_data.py --db-path ~/finance/finance.db >> ~/finance/fetch.log 2>&1

Windows 任务计划程序

1. 创建基本任务，触发器：每小时
2. 操作：启动程序 → py
3. 参数：fetch_data.py --db-path C:\Users\你\finance\finance.db
4. 在用户环境变量中设置 FINNHUB_API_KEY=你的key

OpenClaw cron

{
  "cron": "0 * * * *",
  "command": "python3",
  "args": ["fetch_data.py", "--db-path", "~/finance/finance.db"],
  "env": { "FINNHUB_API_KEY": "你的key" },
  "workdir": "~/finance"
}