---
name: stocks-query
description: 查詢台股個股與大盤（Yahoo 資料）並整理重點摘要。當使用者輸入股票代號（例如 2330、0050、3481）或詢問「大盤」時使用。流程：個股依序執行法人、報價、技術分析三支 Python 腳本；大盤執行大盤腳本；最後輸出精簡中文摘要，並檢查是否有本地持股庫存紀錄。
---

# stocks-query

使用 `scripts/stocks/` 內的腳本查詢台股資料，並回覆精簡摘要。

## 執行流程

### A) 使用者只輸入股票代號（例：2330、0050、3481）

依序執行：

```bash
python3 skills/stocks-query/scripts/yahoo-institutional-browserless.py <代號>
python3 skills/stocks-query/scripts/yahoo-quote-browserless.py <代號>
python3 skills/stocks-query/scripts/yahoo-technical-browserless.py <代號>
```

若標的是 ETF（建議以台股 ETF 常見代號型態判斷，如 `00` 開頭），補充執行：

```bash
python3 skills/stocks-query/scripts/yahoo-etf-holdings.py <代號>
```

若不是 ETF，跳過這一步，不要多跑持股分析。

再檢查本地是否有該代號的持股／庫存紀錄（例如 `stocks/`、`purchases/` 相關檔）。

回覆重點：
- 現價、漲跌、開高低、昨收、成交量、均價、最佳買賣
- 三大法人（外資／投信／自營商／合計）
- 近 5 日 K 線（開高低收）
- RSI14
- ATR14
- KD
- 布林通道
- 看均線、量能、乖離、MACD（若腳本有提供資料則納入摘要）
- ETF 額外補：前十大持股、行業比重、資產分佈
- 是否查到本地持股紀錄
- 以上技術面數值後，必須補一段「白話判斷」，用台灣繁中解釋目前偏強／偏弱、是否過熱、波動大不大、短線偏多或偏震盪，避免只丟數字。

### B) 使用者詢問「大盤」

執行：

```bash
python3 skills/stocks-query/scripts/yahoo-market-browserless.py
```

回覆重點：
- 加權指數
- 漲跌（點數與百分比）
- 開高低、昨收
- 成交金額
- 更新時間

## 回覆風格

- 使用繁體中文（台灣）
- 簡潔、重點式條列
- 若某欄位缺值，明確標註「無資料」