Tool Group · 台股月營收
Taiwan Revenue
Taiwan Revenue tools 提供台股月營收分數、原始公告資料與支援商品清單。分數與 raw data 是不同用途，agent 不應在使用者只要求其中一種時自行混用。
驗證狀態：artifact-confirmed。範例與 assertions 由 validation/tool_usage_cases.json 管理。
月營收分數
Permission · standardBilling · x1Billing · x2（raw）Method · GETContainer · records / valuesOutput · data / raw
Tools
| Tool | API Path | Method | Container | Billing | 說明 | Best for |
|---|---|---|---|---|---|---|
get_taiwan_monthly_revenue_scores | /API/module6 | GET | records | x1 | 查詢指定公司的月營收分數，觀察營收動能與近期變化。 | 台股營收追蹤、個股基本面輔助 |
get_taiwan_monthly_revenue_raw | /API/module6_raw | GET | records | x2 | 取得指定公告期間內所有台股的原始月營收資料。 | 原始資料驗證、營收資料表 |
list_taiwan_revenue_products | /API/module6_product_list | GET | values | x1 | 查詢月營收工具支援的台股商品。 | 台股商品查找 |
參數 Parameters
get_taiwan_monthly_revenue_scores
| 參數 | 型別 | 必填 | 預設 | 說明 |
|---|---|---|---|---|
code | string | ✅ | 2330 TT Equity | 台股代碼。 |
start_date / end_date | string (YYYY-MM-DD) | ✅ | — | 區間。 |
output_mode | string | — | data | data / raw。 |
get_taiwan_monthly_revenue_raw
| 參數 | 型別 | 必填 | 說明 |
|---|---|---|---|
start_date / end_date | string (YYYY-MM-DD) | ✅ | 公告日（announcement date）區間。 |
output_mode | string | — | data / raw（預設 data）。 |
list_taiwan_revenue_products
| 參數 | 型別 | 必填 | 預設 | 說明 |
|---|---|---|---|---|
query | string | — | "" | 篩選字串。 |
limit | integer | — | 100 | 上限，最大 500。 |
output_mode | string | — | data | data / raw。 |
實務提醒
get_taiwan_monthly_revenue_raw 一次回傳所有台股的原始月營收，資料量大且計費為 x2；若只需單一公司，請用 get_taiwan_monthly_revenue_scores。
get_taiwan_monthly_revenue_scores
- 適用：單一台股公司的月營收 score 與變化。
- 必要資訊：canonical
code、start_date、end_date。 - 不可臆測：公司代碼、score、公告月份與資料日期。
請整理 2330 TT Equity 在 2025-07-01 到 2025-07-31 的台股月營收分數、變化與資料日期。
回答應包含 code、score fields、實際可用日期、趨勢描述、source.data_date 與 warnings。
原始月營收
get_taiwan_monthly_revenue_raw
- 適用：取得公告日期範圍內所有台股的 raw monthly revenue records。
- 必要資訊：announcement
start_date、end_date。 - 不可臆測：announcement date、report month、公司與營收值。
請取得 2026-01-01 到 2026-02-23 公告的台股原始月營收資料，並標示來源資料日期。
回答應說明查詢的是公告期間而非任意會計期間，並保留原始欄位、資料日與缺值狀態。
支援商品
list_taiwan_revenue_products
- 適用：確認月營收 tools 支援的 canonical Taiwan stock codes。
- 必要資訊：可提供
query與limit。 - 不可臆測：未出現在結果中的公司 coverage。
請確認台股月營收工具是否支援代碼包含 2330 的商品，最多列出 20 筆正式代碼。
常見失敗
| 症狀 | 處理方式 |
|---|---|
| 商品代碼不確定 | 先查支援商品，不可把一般股票代碼格式直接視為已支援。 |
| Score 或 raw records 為空 | 檢查公告區間與 coverage；空資料不能產生營收結論。 |
| 最新資料日不是今天 | 以 latest available data 描述，並顯示 source.data_date。 |
回傳格式 Response
共用 envelope 見 工具總覽。
- scores / raw → records 容器：
data.records（日期欄正規化為date，另有 announcement_date、report_month 等）、data.columns、data.total_count、data.available_count。 - product list → values 容器：
data.values（支援的台股代碼）。
待 live 校正
records 的實際欄位名（revenue score、原始營收欄位）以 /API/module6 系列回傳為準，將以 dev 端實打結果補上。
AI 回應示意
使用者拿到的是 AI 依營收資料整理後的摘要，而非原始 JSON。示意（內容依公司與當日資料而定）：
2330 · 月營收訊號｜資料日：依回傳
data_date
- 最新 revenue score 與近月變化（動能改善 / 轉弱）
- 對應的 announcement date 或 report month
- 原始營收的補充與資料限制
- ⚠️ 量化資訊整理，非投資建議
每段回應都會帶上 公司 / 代碼、公告或報表月份 與 非投資建議聲明。