Daily US & Taiwan Stock Briefing

📈 A downloadable, bring-your-own-key (BYOK), locally-run Agent Skill that produces a daily US / Taiwan stock-market news briefing. (Reports are written in Traditional Chinese.)

🧭 What it is

Generates a daily news briefing for your own US / Taiwan holdings and watchlist. After download it runs locally inside a compatible agent — Claude Code, Codex, OpenCode, or any agent that supports Skills, can run Python, and has web search. It runs on demand and includes no built-in scheduler.

🛠️ What it can do

• 📊 Fetches real quotes with bundled Python: 🇺🇸 US via Finnhub; 🇹🇼 Taiwan (listed / OTC) via TWSE & TPEx official endpoints, plus a whole-market institutional (three-investor) summary.

• 📚 Optional FinMind fundamentals for Taiwan: EPS / PER / PBR / dividend yield / monthly-revenue YoY.
• 📰 The agent gathers same-day news and produces a structured Markdown briefing with sources, tables, and watch-points (US: 8 sections; TW: 6 sections).
• 🗂️ Optionally writes latest price / daily change % / (Taiwan) latest EPS back to your own Notion database.

🚀 How to deploy

1. Drop it into your agent's skills directory (Python 3.9+, standard library only — no pip install).
2. Copy config/tickers.example.json to config/tickers.json and fill in your own list.
3. Set FINNHUB_API_KEY for US; Taiwan quotes need no key; FINMIND_TOKEN is optional.
4. To write back to Notion, set NOTION_TOKEN and copy config/notion.example.json.
5. Ask your agent to "generate today's US / Taiwan briefing."

✨ What makes it different

• 🎯 Prices come only from the JSON produced by local Python — the model is never asked to recall prices from memory, cutting wrong or fabricated numbers.
• 🚦 Missing / stale / suspicious data keep an explicit status; unusually large US moves keep the value but are flagged for human review — no estimated fill-ins.
• 🌏 One skill covers both US and Taiwan; Taiwan listed vs. OTC is detected automatically.
• 🔒 Local BYOK: ships no keys; credentials go from your local scripts straight to each API via headers, are never sent to the publisher, and known sensitive values are masked in logs.

⚠️ Disclaimer

Output is news and third-party-data aggregation, NOT investment advice — no buy/sell calls, price targets, or stop-losses. Market data comes from third parties (Finnhub / FinMind / TWSE / TPEx) under a bring-your-own-key model; each user must comply with each provider's terms of service and attribution requirements. The package contains no API keys and no market data. AI summaries can be wrong — treat the cited original sources as authoritative, verify independently, and make your own investment decisions.