---
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 <代號>
python3 skills/stocks-query/scripts/twse-margin-trading.py <代號>
python3 skills/stocks-query/scripts/yahoo-dividend-browserless.py <代號>
python3 skills/stocks-query/scripts/yahoo-market-brief.py
python3 skills/stocks-query/scripts/yahoo-broker-trading-browserless.py <代號>
python3 skills/stocks-query/scripts/twse-day-trading.py <代號>
python3 skills/stocks-query/scripts/twse-foreign-holdings.py <代號>
```

若標的**不是** ETF（非 `00` 開頭），額外執行：

```bash
python3 skills/stocks-query/scripts/twse-monthly-revenue.py <代號>
python3 skills/stocks-query/scripts/twse-pe-pbr.py <代號>
```

若標的是 ETF（`00` 開頭），改為額外執行：

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

注意：月營收、本益比 對 ETF 無資料，不要對 ETF 執行。

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

回覆重點：
- 現價、漲跌、開高低、昨收、成交量、均價、最佳買賣
- 三大法人（外資／投信／自營商／合計）
- 近 5 日 K 線（開高低收）
- RSI14
- ATR14
- KD
- 布林通道
- 看均線、量能、乖離、MACD（若腳本有提供資料則納入摘要）
- 融資融券：融資餘額（增減）、融券餘額（增減）、券資比、融資使用率
- 股利殖利率：歷年現金股利、殖利率、最近除息日與填息天數
- 大盤同步：加權指數現值與漲跌（一行簡要）
- 主力券商：買超／賣超前 15 大券商、主力買賣超合計張數
- 當沖統計：當沖成交量、佔個股成交比例、大盤當沖佔比
- 外資持股：外資持有股數與持股比例
- 非 ETF 額外補：月營收（當月、MoM、YoY、累計）、本益比、股價淨值比
- ETF 額外補：前十大持股、行業比重、資產分佈
- 是否查到本地持股紀錄
- 以上技術面數值後，必須補一段「白話判斷」，用台灣繁中解釋目前偏強／偏弱、是否過熱、波動大不大、短線偏多或偏震盪，避免只丟數字。

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

執行：

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

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

## 回覆風格

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