stocks-query/QUICKSTART.md

快速開始

1. 設定環境變數

在專案根目錄建立 .env：

BROWSERLESS_ENDPOINT=http://192.168.42.124:13000
BROWSERLESS_TOKEN=your_token_here

TWSE 腳本（twse-*.py）與 Yahoo 直接 API 腳本不需要此設定，可直接執行。

2. 確認 Python 版本

python3 --version   # 需要 3.10+

不需要安裝任何第三方套件，全部使用 Python 標準函式庫。

3. 測試連線

先測試不需要 Browserless 的腳本：

# TWSE 融資融券（不需 Browserless）
python3 scripts/twse-margin-trading.py 2330

# Yahoo 均線（不需 Browserless）
python3 scripts/yahoo-ma-signal.py 2330

再測試 Browserless 腳本：

# 個股報價（需 Browserless）
python3 scripts/yahoo-quote-browserless.py 2330

4. 常用查詢組合

個股速查（三大核心）

python3 scripts/yahoo-quote-browserless.py 2330
python3 scripts/yahoo-institutional-browserless.py 2330
python3 scripts/yahoo-technical-browserless.py 2330

個股深度分析（全套）

python3 scripts/yahoo-quote-browserless.py 2330
python3 scripts/yahoo-institutional-browserless.py 2330
python3 scripts/yahoo-technical-browserless.py 2330
python3 scripts/yahoo-dividend-browserless.py 2330
python3 scripts/yahoo-broker-trading-browserless.py 2330
python3 scripts/yahoo-ma-signal.py 2330
python3 scripts/yahoo-macd-signal.py 2330
python3 scripts/twse-margin-trading.py 2330
python3 scripts/twse-day-trading.py 2330
python3 scripts/twse-foreign-holdings.py 2330

ETF 查詢

python3 scripts/yahoo-quote-browserless.py 0050
python3 scripts/yahoo-etf-holdings.py 0050
python3 scripts/yahoo-technical-browserless.py 0050

大盤

python3 scripts/yahoo-market-browserless.py

5. 透過 Claude Code 使用

安裝為 skill 後，直接在 Claude Code 中輸入：

• 2330 → 自動執行個股全套分析
• 0050 → 自動執行 ETF 分析（含持股）
• 大盤 → 自動執行大盤查詢

常見問題

問題	解法
缺少必要環境變數	確認 .env 檔存在且格式正確
Browserless 導航逾時	檢查 Browserless 服務是否正常運作
找不到 XXXX 的融資融券資料	TWSE 假日無資料，腳本會自動回溯 10 個工作日
Yahoo API 錯誤	Yahoo 偶有 rate limit，稍後重試