Daily Watchlist

📊 30 秒看懂 / In 30 seconds：你列一份股票池，说一句 /dw-today，Claude Code 自动抓价、搜新闻、查财报、写结构化日报。

Maintain a watchlist; Claude Code fetches prices, scans news, tracks earnings, and writes a structured daily report.

🔗 零代码 AI 投研三件套 ｜ Zero-code AI investment research toolkit

🎙️ pod2wiki 输入 · 🧠 karpathy-claude-wiki 底座 · 📊 daily-watchlist 日常 + 内置假设追踪

flowchart LR
    P[🎙️ pod2wiki] -->|sources| W[🧠 karpathy-claude-wiki]
    W -.->|read| D[📊 daily-watchlist]
    D -->|hypotheses & trades| DHT[🎯 built-in HT]
    DHT -.->|evidence| W
    style D fill:#fde68a,stroke:#92400e

Latest Release | All Releases | Changelog 中文 | English

中文

AI 驱动的每日股票池监控系统，也是一个给 Claude Code 用的投资研究工作流。维护一个股票池，每天说一句 /dw-today，Claude Code 自动拉取行情、检测异动、搜索新闻，生成结构化日报。

状态：MVP。你负责维护股票池和关注方向；Claude 负责拉数据、搜新闻、写日报。

版本：最新 Release | 更新日志

关键词：AI 股票池、股票监控、投资研究工作流、每日复盘、异动监控、财报日历、portfolio monitoring、stock watchlist、earnings tracker、Claude Code

适合谁？

• 想做一个 AI stock watchlist / 股票池监控 系统，但不想自己写完整后端
• 想把 每日看盘、异动跟踪、财报检查、行业新闻整理 串成一个固定流程
• 想在 Claude Code 里直接运行一个面向投资研究的日报工具
• 已经在用 karpathy-claude-wiki，想把监控结果继续归档进知识库

| 你是谁 | 走哪条路 | |---|---| | 🤖 让 AI agent 帮你装（推荐） | 让 Claude Code / AI agent 帮你装 | | 🧑‍💻 会用命令行想自己装 | 进阶：本地脚本安装 | | 🛠️ 想完全手动一步步来 | 进阶：手动安装 |

最近更新

• Unreleased：内置 Hypothesis Tracker，新增 /ht-new、/ht-status、/ht-trade，日报可扫描 hypothesis/H*.md 并把本地可确认信号回写为证据；交易记录写入 portfolio/trades.csv，并维护本地 portfolio/holdings.csv
• 2026-04-17：README 结构重排（AI agent 安装升为首推），install 脚本现在会给根 CLAUDE.md 追加路由段，--profile 模式下 A 股/港股强制走 Tushare（FMP 对 .SH/.SZ 覆盖不全），smoke 报告去重
• v1.0.2（2026-04-16）：新增 Stooq / Finnhub / EOD / yfinance 行情兜底链，README 增加数据源说明，env.example 增加可选配置
• v1.0.1（2026-04-11）：简化安装后 CLAUDE.md 注入、修复 Windows 安装器退出码、新增跨平台 CI 和离线 smoke 测试
• v1.0.0（2026-04-10）：首次发布——/dw-today 日报 + /dw-import 股票池导入 + 模板驱动 + 双平台安装器
• 完整历史见 CHANGELOG.md

这是什么？

一个在 Claude Code 中运行的 daily stock watchlist monitor / 每日股票池监控工具，现在也内置了 Hypothesis Tracker 作为假设与证据层。你维护一个股票池，每天说一句 /dw-today，它就会：

• 拉取你股票池里所有股票的最新行情
• 检测异动（大盘股 ±3%，小盘股 ±7%，阈值可配）
• 对异动股搜索新闻，分析原因
• 检查本周财报日历
• 按你关注的投资方向搜索行业新闻
• 生成一份结构化的 markdown 日报
• 扫描本地 hypothesis/H*.md，把日报信号和投资假设关联起来
• （可选）自动归档到 karpathy-claude-wiki

• /dw-today：生成今日监控日报
• /dw-import：导入或整理股票池
• /ht-new：新建投资假设
• /ht-status：查看假设状态、证据新鲜度和回顾提醒
• /ht-trade：记录交易、更新本地 portfolio/holdings.csv，并回写到相关假设

watchlist.md ──→ fetchmarketdata.py ──→ JSON ──┐
                                                  │
config.yaml ───→ fetchmacrodata.py ───→ JSON ──┤
                                                  ├──→ generatedailyreport.py
                 FMP earnings calendar ──→ JSON ──┤        │
                                                  │        ├──→ 日报骨架 .md
report-template.md ───────────────────────────────┘        │
                                                           ↓
focus_areas ───→ Claude WebSearch ──────────────→ Claude 补充新闻
                                                           │
                                                  wiki/ ←──┘ (归档)

开始之前

你需要准备一个 FMP API Key（免费）：

• 前往 financialmodelingprep.com 注册
• 在 Dashboard 复制你的 API Key
• 免费层每天 250 次请求，个人使用完全够

• 前往 tushare.pro 注册，获取 token

💡 FMP 250/天不够用、或某只股票 FMP 没数据？ 脚本内置了自动兜底链：Stooq（零配置，美/日/德）、Finnhub（填 key 即启用，美股）、EOD（填 key 即启用，港/韩/芬兰）、yfinance（可选开关，国内慎用）。每个源的覆盖范围、免费额度、踩过的坑见下面 数据源 章节。

🤖 推荐：让 Claude Code / AI agent 帮你装

为什么推荐这条路：对真小白来说，"打开终端 + 翻文档找命令 + 复制粘贴 + 改路径参数"的门槛比"给 Claude Code 发一句话"高得多。AI agent 路径几乎零操作。

前置（各 1-3 分钟）：

• 装好 Claude Code（Cursor / Cline / Windsurf 也行，只要支持 Agent 模式）
• 拿到 FMP API Key（免费，注册 1 分钟）
• 关心 A 股/港股的话，顺手拿个 Tushare token

• 在 Claude Code 里打开你想安装的项目目录（或一个全新空文件夹）
• 给 agent 发：

• agent 会按 INSTALL-FOR-AI.md 协议问你 7 个问题 → 自动 clone → 跑安装器 → 填 key → 生成配置 → 跑验证，全程你只需要回答问题

• 装到哪个目录？（推荐：当前项目下的 ./daily-watchlist/）
• 主要关注哪个市场？（US / CN / HK / Mixed）
• 你的 FMPAPIKEY 是什么？
• 是否需要 TUSHARE_TOKEN？（A 股/港股必需）
• 需要写入哪些 focus areas？（投资主题标签，比如 AI全栈、能源、航运，3-8 个）
• 你已经有 watchlist 吗？（没有的话用默认模板起）
• 后续主要用哪类模型？（国际模型 default / 国产模型 domestic，后者会自动开新闻二次验证）

• 没装 Claude Code？ Cursor / Cline / Windsurf 这些支持 Agent 模式的 IDE 同样能跑 INSTALL-FOR-AI.md 协议。
• 不想污染现有项目？ 告诉 agent 装到一个全新的空文件夹。
• 免费够用吗？ FMP 免费层 250 次/天，监控 100 只股票 + 宏观数据绰绰有余。
• A 股也能监控？ 能。Tushare token 走 .SH/.SZ/.HK 后缀，FMP 走美股/欧股/日股。
• 日报在哪？ daily-watchlist-reports/YYYY-MM/YYYY-MM-DD.md，agent 装完会直接告诉你。
• 怎么改关注方向？ 装完后编辑 config/daily-watchlist.yaml 里的 focus_areas。

# 如果 PowerShell 阻止脚本，先执行一次（只需一次）：
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
git clone https://github.com/Benboerba620/daily-watchlist.git .daily-watchlist-tmp .\.daily-watchlist-tmp\scripts\install.ps1 -TargetDir .\daily-watchlist

git clone https://github.com/Benboerba620/daily-watchlist.git .daily-watchlist-tmp
bash ./.daily-watchlist-tmp/scripts/install.sh --target-dir ./daily-watchlist

git clone https://github.com/Benboerba620/daily-watchlist.git
cd daily-watchlist
pip install -r requirements.txt

my-investment/
   ├── config/
   │   ├── daily-watchlist.env            # 从 config/daily-watchlist.env.example 复制，填 FMPAPIKEY
   │   ├── daily-watchlist.yaml           # 从 config/daily-watchlist.example.yaml 复制，改 market/focus_areas
   │   └── daily-watchlist-watchlist.md   # 从 config/daily-watchlist.watchlist.example.md 复制，加你的股票
   ├── scripts/
   │   ├── fetchmarketdata.py
   │   ├── fetchmacrodata.py
   │   ├── check_setup.py
   │   ├── generatedailyreport.py
   │   └── workspace_paths.py
   ├── templates/
   │   └── daily-watchlist-report-template.md
   └── .claude/
       └── skills/
           ├── dw-today.md
           └── dw-import.md

# Workspace Instructions
## Daily Watchlist
For Daily Watchlist requests, prefer /dw-today and /dw-import.
Read these first:    - ./.claude/skills/dw-today.md    - ./.claude/skills/dw-import.md    - ./config/daily-watchlist.yaml    - ./config/daily-watchlist-watchlist.md

功能详情

如果你在搜这些词，这个项目就是对应的实现：

• AI stock watchlist
• stock watchlist for Claude Code
• portfolio monitoring workflow
• daily stock report generator
• earnings tracker with AI
• investment research workflow

股票池管理

说 /dw-import，粘贴 ticker 列表（支持 200+），Claude 自动：

• 查询公司名、市值、行业（A 股/港股自动走 Tushare，美/欧/日股走 FMP）
• 按行业分类
• 让你确认后保存到 config/daily-watchlist-watchlist.md

每日简报

说 /dw-today，Claude 自动：

• 拉取全部股票行情 + 宏观指标（VIX / SPY / QQQ / 黄金 / 原油 / BTC）
• 检测异动，搜索新闻分析原因
• 检查本周财报日历
• 按关注方向搜索行业新闻
• 基于报告模板生成结构化日报到 daily-watchlist-reports/YYYY-MM/

关注方向（Focus Areas）

在 config/daily-watchlist.yaml 中定义你关注的投资主题：

focus_areas:
  - name: "AI & Data Center"
    keywords: ["AI", "data center", "GPU", "inference"]
    required_any: ["data center", "GPU", "inference"]
    exclude: ["airline", "ceasefire"]

Claude 每天按关键词搜索行业新闻，并用 required_any 过滤无关结果、用 exclude 剔除噪音。

自定义日报模板

日报的结构由 templates/daily-watchlist-report-template.md 控制。脚本会读取这个模板，用实时数据填充变量后生成骨架，Claude 再补充新闻和分析。

你可以直接编辑模板来调整日报的段落顺序、标题措辞、表格列，改完下次 /dw-today 就生效。

Wiki 归档

如果你的项目已经安装了 karpathy-claude-wiki，Daily Watchlist 会自动检测 wiki/entities/，将重大异动和财报事件归档到对应 entity 的 news.md。

国产模型二次验证

如果你使用国产模型（如 DeepSeek、Kimi 等），建议在 config/daily-watchlist.yaml 中开启：

reporting:
  model_profile: domestic
  secondary_verify: true

开启后，Claude 在写入日报前会对每条新闻做二次验证：核对来源可信度、发布时间、正文事实一致性。未通过验证的条目标记为"待人工确认"而不是直接写入。

配置参考

| 文件 | 用途 | |------|------| | config/daily-watchlist.env | API keys | | config/daily-watchlist.yaml | 模块开关、阈值、关注方向 | | config/daily-watchlist-watchlist.md | 你的股票池 | | templates/daily-watchlist-report-template.md | 日报模板（可自行编辑） |

触发词

| 推荐 | 兼容别名 | |------|----------| | /dw-today | /watchlist-today（仅兼容） | | /dw-import | /watchlist-import（仅兼容） |

优先使用 /dw-today 和 /dw-import。在共享工作区里，不要默认依赖 /today 和 /import 这类高冲突短别名。

只有在当前工作区没有冲突时，才建议使用短别名。

数据源

内置数据源

| 服务 | 用途 | 状态 | 费用 | |------|------|------|------| | FMP | 美/欧/日股行情 + 财报日历 | 🟢 默认启用（必需） | 免费 250 次/天 | | Tushare | A 股（.SH/.SZ）+ 港股（.HK） | 🟡 填 token 即启用（A 股/港股必需） | 免费 |

2026-04-17 起：--profile 模式下，.SH/.SZ/.HK 后缀的 ticker 强制走 Tushare 而不是 FMP。FMP 对 A 股覆盖不完整（比如 601857.SH 中国石油拿不到），Tushare 是 A 股/港股的权威源。

备选兜底数据源

下面几个都是我自己踩过坑用过的，各有优劣。脚本会在 FMP 没返回某个 ticker 时，按下表顺序自动兜底（只要对应 key 填好或包装好）：

| 服务 | 覆盖 | 状态 | 费用 | 踩过的坑 | |------|------|------|------|----------| | Stooq 实时报价（/q/l/ 端点） | 美股、日股、德股 | 🟢 零配置自动兜底 | 完全免费，无需 key | 不支持港/韩/芬兰；/q/d/l/ 历史端点 2026 起要 apikey，这里只用不要 key 的 light 端点 | | Finnhub | 美股实时报价 | 🟡 填 FINNHUBAPI_KEY 自动启用 | 免费 60 req/min | 免费层只覆盖美股；不要用它拉 GLD/USO/COPX 等大宗商品 ETF，报价严重偏离现货（我们踩过这个坑） | | EOD Historical Data | 港股（.HK）、韩国（.KO）、芬兰（.HE）等 Stooq/Tushare 覆盖不到的市场 | 🟡 填 EODAPI_KEY 自动启用 | 免费层 20 req/day | 免费层很紧，适合小仓位兜底；付费档起步 $20/月 | | yfinance（Yahoo Finance 非官方包） | 全球股票 + 历史 | 🔵 pip install yfinance + 设置 ENABLEYFINANCE=1 才启用 | 免费无 key | 国内访问不稳定，实测经常返回 No price data found — 建议有稳定 VPN 或海外 IP 再开 | | AKShare | A 股 + 大宗商品期货（COMEX 黄金、WTI 原油、LME 铜）| 🔵 需要自己改 scripts/fetchmarket_data.py 对接 | 开源免费，无需 key | 返回格式不稳定、列名会变；主要用来补期货/外盘商品，不建议当股票 quote 主路径 |

状态说明：🟢 零配置即用 / 🟡 填一个 key 或装一个包就启用 / 🔵 需要手动改脚本或让 Claude Code 帮你接

如何启用备选兜底

在 config/daily-watchlist.env 里按需加：

# 必需
FMPAPIKEY=yourfmpkey
可选
TUSHARE_TOKEN=            # A 股 / 港股
FINNHUBAPIKEY=          # 美股 FMP 兜底
EODAPIKEY=              # 港/韩/芬兰 兜底
ENABLE_YFINANCE=          # 设为 1 启用（需 pip install yfinance，国内慎用）

填上脚本会自动生效。Stooq 无需任何配置，已默认开启 US/JP/DE 自动兜底。

致谢

• Claude Code — 运行环境
• karpathy-claude-wiki — 知识归档系统

关于作者

更多投资思考、研究方法与系统化协作的文章，欢迎关注微信公众号 奔波儿r。

协议

MIT

English

An AI-powered daily stock monitoring system and investing workflow for Claude Code. Maintain a watchlist, say /dw-today, and Claude Code automatically fetches prices, detects movers, searches for news, and generates a structured daily report.

Status: MVP. You maintain the watchlist and focus areas; Claude handles data, news, and reports.

Release: Latest | Changelog

Keywords: AI stock watchlist, portfolio monitoring, stock mover detection, earnings tracker, daily stock report, investing workflow, Claude Code, watchlist automation

Who Is This For?

• You want an AI stock watchlist without building a full investing dashboard from scratch
• You want one repeatable workflow for price checks, mover detection, earnings tracking, and daily research notes
• You use Claude Code and want a practical investing / market monitoring tool inside it
• You already use karpathy-claude-wiki and want market updates archived into your research system

| Who you are | Where to go | |---|---| | 🤖 Let an AI agent install it (recommended) | Let Claude Code / an AI agent install it | | 🧑‍💻 Comfortable with CLI, want to run the scripts yourself | Advanced: local script install | | 🛠️ Want to do every step by hand | Advanced: manual install |

Recent Updates

• v1.1.0 (2026-04-24): optional Tier / Hypothesis / Notes watchlist columns and read-only hypothesis-linked monitoring; no holdings tracking.

• 2026-04-17: README restructure (AI agent install promoted to primary path), installer now appends a routing pointer to the project-root CLAUDE.md, --profile mode routes A-shares/HK to Tushare (FMP coverage of .SH/.SZ is incomplete), smoke report dedup
• v1.0.2 (2026-04-16): Added Stooq / Finnhub / EOD / yfinance quote fallbacks, documented data-source tradeoffs in README, and added optional env knobs
• v1.0.1 (2026-04-11): Streamlined installed CLAUDE.md hint; fixed Windows installer exit code; added cross-platform CI and offline smoke tests
• v1.0.0 (2026-04-10): First release — /dw-today daily report + /dw-import watchlist import + template-driven generation + dual-platform installers
• Full history: CHANGELOG.md

What is this?

A daily stock watchlist monitor that runs inside Claude Code. Maintain a watchlist, say /dw-today, and it will:

• Fetch latest prices for all stocks in your watchlist
• Detect significant movers (large-cap ±3%, small-cap ±7%, configurable)
• Search news for movers and analyze causes
• Check this week's earnings calendar
• Search industry news based on your focus areas
• Generate a structured markdown report
• (Optional) Auto-archive to karpathy-claude-wiki

Before You Start

You need a FMP API Key (free):

• Go to financialmodelingprep.com and register
• Copy your API Key from the Dashboard
• Free tier: 250 requests/day, more than enough for personal use

• Register at tushare.pro

💡 Hit the FMP 250/day cap, or a ticker FMP doesn't cover? The script has a built-in fallback chain: Stooq (zero-config, US/JP/DE), Finnhub (key-to-enable, US), EOD (key-to-enable, HK/KR/FI), yfinance (opt-in, unstable in mainland CN). Coverage, free tiers, and real caveats for each source: see the Data Sources section below.

🤖 Recommended: let Claude Code / an AI agent install it

Why this is the easiest path: if you're new to this kind of tool, "open a terminal + find the right command in docs + copy-paste + adjust paths" is much higher friction than "paste one URL into Claude Code." The AI agent path is nearly zero-op.

Prerequisites (1–3 min each):

• Install Claude Code (Cursor / Cline / Windsurf work too, as long as they support Agent mode)
• Get a free FMP API Key (1-min signup)
• For A-shares / HK coverage, grab a Tushare token too

• Open your project directory (or a fresh empty folder) in Claude Code
• Send the agent:

• The agent follows the INSTALL-FOR-AI.md protocol: asks 7 clarifying questions → clones → runs installer → fills keys → generates config → runs verification. All you do is answer questions.

• Where should the workspace be installed? (default: ./daily-watchlist/)
• Primary market? (US / CN / HK / Mixed)
• Your FMPAPIKEY?
• Need TUSHARE_TOKEN? (required for A-shares / HK)
• Which focus areas? (investment theme tags like AI full-stack, Energy, Shipping — 3–8 tags)
• Do you already have a watchlist? (if not, start from the template)
• Which model will you use day-to-day? (international default / domestic domestic — the latter auto-enables news secondary verification)

• No Claude Code? Cursor / Cline / Windsurf also support Agent mode and can run INSTALL-FOR-AI.md.
• Don't want to mix into an existing project? Tell the agent to install into a fresh empty folder.
• Is the free tier enough? Yes. FMP 250 req/day covers 100+ stocks + macro.
• Can I monitor A-shares? Yes. Tushare handles .SH/.SZ/.HK suffixes; FMP handles US/EU/JP.
• Where are my reports? daily-watchlist-reports/YYYY-MM/YYYY-MM-DD.md — the agent will show you after install.
• How to change focus areas? Edit focus_areas in config/daily-watchlist.yaml after install.

# If PowerShell blocks scripts, run this once:
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
git clone https://github.com/Benboerba620/daily-watchlist.git .daily-watchlist-tmp .\.daily-watchlist-tmp\scripts\install.ps1 -TargetDir .\daily-watchlist

git clone https://github.com/Benboerba620/daily-watchlist.git .daily-watchlist-tmp
bash ./.daily-watchlist-tmp/scripts/install.sh --target-dir ./daily-watchlist

git clone https://github.com/Benboerba620/daily-watchlist.git
cd daily-watchlist
pip install -r requirements.txt

my-investment/
   ├── config/
   │   ├── daily-watchlist.env            # from config/daily-watchlist.env.example, fill FMPAPIKEY
   │   ├── daily-watchlist.yaml           # from config/daily-watchlist.example.yaml, adjust market/focus_areas
   │   └── daily-watchlist-watchlist.md   # from config/daily-watchlist.watchlist.example.md, add your tickers
   ├── scripts/
   │   ├── fetchmarketdata.py
   │   ├── fetchmacrodata.py
   │   ├── check_setup.py
   │   ├── generatedailyreport.py
   │   └── workspace_paths.py
   ├── templates/
   │   └── daily-watchlist-report-template.md
   └── .claude/
       └── skills/
           ├── dw-today.md
           └── dw-import.md

# Workspace Instructions
## Daily Watchlist
For Daily Watchlist requests, prefer /dw-today and /dw-import.
Read these first:    - ./.claude/skills/dw-today.md    - ./.claude/skills/dw-import.md    - ./config/daily-watchlist.yaml    - ./config/daily-watchlist-watchlist.md

Features

If you found this repo by searching for one of these terms, you're in the right place:

• AI stock watchlist
• daily stock monitoring
• portfolio monitoring with AI
• Claude Code investing workflow
• earnings tracker
• daily market report generator

• Watchlist import: paste 200+ tickers, auto-classified by sector
• Mover detection: configurable thresholds, auto news search
• Macro dashboard: VIX, SPY, QQQ, gold, oil, BTC
• Earnings calendar: auto-track for watched stocks
• Focus areas: custom keywords for daily industry news
• Customizable template: edit the report template to change structure, headers, or columns
• Module toggles: turn off macro/earnings/focus_areas individually — disabled modules skip data fetching entirely
• Wiki archiving: auto-integrates with karpathy-claude-wiki
• Secondary verification: for domestic model users, news verified before inclusion

Data Sources

Built-in

| Service | Purpose | Status | Cost | |---------|---------|--------|------| | FMP | US/EU/JP quotes + earnings calendar | 🟢 Enabled by default (required) | Free, 250 req/day | | Tushare | A-shares (.SH/.SZ) + HK (.HK) | 🟡 Enabled when token is set (required for A-shares / HK) | Free |

As of 2026-04-17: in --profile mode, tickers with .SH/.SZ/.HK suffixes are forced through Tushare regardless of FMP availability. FMP's A-share coverage is incomplete (e.g. 601857.SH China Petroleum isn't returned), and Tushare is the authoritative source for those markets.

Fallback data sources

I've personally used every one of these — they have real quirks. The script auto-falls-back to them (in this order) whenever FMP doesn't return a ticker, as long as the matching key / package is available:

| Service | Coverage | Status | Cost | Caveats from real use | |---------|----------|--------|------|-----------------------| | Stooq real-time endpoint (/q/l/) | US, JP, DE | 🟢 Zero-config auto fallback | Free, no key | No HK/KR/FI support; the /q/d/l/ history endpoint now requires an apikey (2026+), so we only use the key-less light endpoint | | Finnhub | US real-time quotes | 🟡 Auto fallback when FINNHUBAPI_KEY is set | Free, 60 req/min | US-only on the free tier; don't use it for commodity ETFs like GLD/USO/COPX — prices deviate badly from spot (we hit this bug) | | EOD Historical Data | HK (.HK), KR (.KO), FI (.HE), other markets Stooq/Tushare miss | 🟡 Auto fallback when EODAPI_KEY is set | Free tier: 20 req/day | Free tier is tight; paid tier starts at $20/month | | yfinance (unofficial Yahoo Finance) | Global equities + history | 🔵 Enabled only when pip install yfinance + ENABLEYFINANCE=1 | Free, no key | Unstable from mainland China — frequently returns No price data found. Only turn on if you have a stable VPN or overseas IP | | AKShare | A-shares + commodity futures (COMEX gold, WTI oil, LME copper) | 🔵 Requires manual wiring in scripts/fetchmarket_data.py | Open-source, free, no key | Return shape and column names drift between versions; best as a futures/commodities backfill, not a primary quote source |

Legend: 🟢 works out of the box / 🟡 fill one key or install one package to enable / 🔵 manual wiring (or ask Claude Code to do it)

How to enable fallbacks

Add any of these to config/daily-watchlist.env:

# Required
FMPAPIKEY=yourfmpkey
Optional
TUSHARE_TOKEN=            # A-shares / HK
FINNHUBAPIKEY=          # US fallback for FMP
EODAPIKEY=              # HK / KR / FI fallback
ENABLE_YFINANCE=          # set to 1 to enable (needs pip install yfinance; flaky in mainland CN)

The script picks them up automatically. Stooq requires no config and is always on for US/JP/DE fallback.

Triggers

| Recommended | Aliases | |-------------|---------| | /dw-today | /watchlist-today (compatibility only) | | /dw-import | /watchlist-import (compatibility only) |

Prefer /dw-today and /dw-import. Avoid relying on /today and /import in shared workspaces because those short aliases are more likely to conflict with other systems.

Credits

• Claude Code
• karpathy-claude-wiki

License

MIT