ONE10 研究工具 ONE10 Research Tools
此頁涵蓋 production 預設公開的 10 個 ONE10 research tools。它們不計入 19 個 GAS Quant API-backed endpoints，但仍屬於客戶可見 MCP surface，必須遵守相同的日期、來源、權限與 missing-data 規則。 GAS Quant MCP 的 32 個 public read-only MCP tools 中，包含一組 ONE10 external research tools。它們補上概念族群、模型指標、研究評論與風險預測，適合放在進階研究或額外資料區塊。
這些工具會出現在 public tools/list，並計入 32 個 public read-only MCP tools；但它們不是 19 個 core API-backed endpoint。憑證由 server 端管理、不對外曝露。頁面與計數上請標示為 external research tools，避免和 core API-backed 分類混淆。
驗證狀態：artifact-confirmed。範例與 assertions 由 validation/tool_usage_cases.json 管理；remote live 結果尚待受保護 credentials。
宏觀與半導體 timing
get_macro_semiconductor_timing
- 適用：ONE10 global macro / semiconductor timing context。
- 必要資訊：無；server 會查詢 global market comment source。
請取得最新的全球宏觀與半導體 timing 研究資料，並標示來源與資料日期。
回答應保留來源、資料日期、原始研究欄位與 warnings，不可自行擴寫為交易建議。
概念族群與成分股
get_concept_groups_and_stocks
- 適用：取得指定 market 的完整 concept groups 與 constituents。
- 必要資訊：
market，例如tw。
請列出台股目前的概念族群與各族群成分股，並標示取得時間。
大量結果應摘要並標示截斷方式，不得把族群成分描述為推薦名單。
概念族群搜尋
search_concept_groups
- 適用：以概念名稱、strategy name、stock code 或 stock name 搜尋族群。
- 必要資訊：非空
query；可指定market、include_stocks、limit。
請在台股概念族群中搜尋 Rubin，回傳最多 10 個符合的族群、命中欄位與成分股。
回答應包含 matched_fields、available / returned counts 與 truncation warning。空白 query 必須回傳 INVALID_ARGUMENT。
概念族群指標
get_concept_group_indicators
- 適用：查詢特定
strategy_name的模型指標。 - 必要資訊：canonical
strategy_name；可指定market、category、strategy、limit。
請取得台股策略名稱 C-VeraRubin_HBM記憶體(Daily) 的最新 model 類別 beta 指標，最多 1 筆，並標示資料日期。
Strategy name 不確定時，先搜尋概念族群，不可猜測。
指標字典
get_indicator_dictionary
- 適用：查詢靜態 indicator names、categories 與 definitions。
- 必要資訊：無；此 tool 不查個別商品歷史資料。
請列出系統可用的研究指標字典，包含每個指標的分類與定義；不要查個別商品資料。
歷史指標
get_indicators
- 適用：商品的 long-term historical indicator lines。
- 必要資訊：
code、category（index、stock或etf）；可指定start_date、strategy、market。
請取得台股 2330 TT Equity 自 2025-01-01 起的 stock 類別 beta 歷史指標資料，並標示資料日期。
Category 必須是 endpoint 支援的 index、stock、etf、fund、concept 或 model，並與 code 和 market 的實際資料類型一致；模型不可自行猜測或替換 category。
股票評論
get_stock_comments
- 適用：一個或多個股票的 research comments 與 indicators。
- 必要資訊：
market、codes；可指定strategy與單一date。若要長期間序列，改用get_indicators。
請取得台股 2330 TT Equity 最新可用的 beta 股票評論與指標，並標示資料日期。
回答應檢查 rowCount 與 comments；零筆資料不能產生評論摘要。
ETF 評論
get_etf_comments
- 適用：一個或多個 ETF 的 research comments 與 indicators。
- 必要資訊：
market、codes；日期與 strategy 規則同股票評論。
請取得台股 ETF 0050 TT Equity 最新可用的 beta 評論與指標，並標示資料日期。
指數評論
get_index_comments
- 適用：一個或多個 index codes 的 comments 與 indicators。
- 必要資訊：
codes；可指定單一date。若要長期間序列，改用get_indicators。
請取得 TWOTCI Index 最新可用的指數評論與指標，並標示資料日期。
市場風險預測訊號
get_risk_forecast_signals
- 適用：trend、bottom-fishing、escaping-top、position 與 events 的長中短期研究。
- 必要資訊：
lookback_days，代表保留的最新觀測筆數。
請分析最近 60 個觀測期的市場趨勢、逃頂與抄底訊號，說明長中短期訊號代碼、事件與資料日期。
回答必須依 signal_legend 解讀數值，不可用模型記憶重建代碼定義；日期與 signal arrays 應保持對齊。
共用失敗判讀
| 症狀 | 處理方式 |
|---|---|
FORBIDDEN | 檢查 customer key 的 allowed_tools；不可繞過權限。 |
rowCount=0、空 comments 或空 data | 回報 unavailable，不產生研究內容。 |
| Strategy / code / category 不確定 | 先使用 discovery 或 dictionary tool 解析，不可猜測。 |
source.data_date 與 requested date 不同 | 同時呈現 requested / returned dates 與 warnings。 |
source.data_date=null | 靜態字典、無版本日期的概念目錄或空結果沒有可宣稱的資料日；可改看 source.retrieved_at 了解取得時間。 |
| Tool | Method |
| --- | :--: |
get_macro_semiconductor_timing | GET |
get_concept_groups_and_stocks | GET |
search_concept_groups | GET |
get_concept_group_indicators | GET |
get_indicator_dictionary | GET |
get_indicators | GET |
get_stock_comments | POST |
get_etf_comments | POST |
get_index_comments | POST |
get_risk_forecast_signals | GET |
參數 Parameters
| Tool | 主要參數 |
|---|---|
get_macro_semiconductor_timing | 無參數。 |
get_concept_groups_and_stocks | market（tw / cn，預設 tw）。 |
search_concept_groups | query（必填）、market、include_stocks（預設 true）、limit（預設 20，最大 500）。 |
get_concept_group_indicators | strategy_name（必填）、market、category（預設 model）、strategy（預設 beta）、limit。 |
get_indicator_dictionary | 無參數。 |
get_indicators | code、category（index/stock/etf/fund/concept/model）、start_date、strategy（beta/spot/futures）、market（cn/tw/hk/jp/us）。 |
get_stock_comments | market、codes（必填，至少一個）、strategy（beta/spot，預設 beta）、date（選用，省略用最新日）。中國 ETF 代碼會自動導向 get_etf_comments。 |
get_etf_comments | market、codes（必填，至少一個）、strategy（beta/spot）、date。 |
get_index_comments | codes（必填，至少一個）、date。 |
get_risk_forecast_signals | lookback_days（預設 252）。 |
中國市場會統一代碼格式：股票如 601138 / 601138.SH 轉為 601138 CG Equity；ETF 如 159941.OF 轉為後端資料表使用的 159941.SZ。SH、SZ、A 等 market 別名會正規化為 cn，price category 會正規化為 stock，舊的 alpha strategy 會正規化為 spot。
Example prompts
找出概念股群裡 Vera Rubin 相關的主題與成分股。
幫我取 2330 的最新股票評論與指標。
回傳格式 Response
共用 envelope 見 工具總覽。多數工具回傳 object 形式的 data；search_concept_groups 回傳 data.records（含 stock_count、matched_fields、選用 stocks）與 total_count / available_count / searched_count。
各 external tool 的實際 data 欄位以對應 ONE10 API 回傳為準，將以 dev 端實打結果補上。
AI 回應示意
使用者拿到的是 AI 依外部研究資料整理後的脈絡補充，而非原始 JSON。示意（內容依查詢與當日資料而定）：
概念族群搜尋 · "Vera Rubin"
- 命中的概念族群與其策略名、成分股數
- 每檔成分股的代碼與名稱（
include_stocks=true時）- 可延伸查
get_concept_group_indicators看族群強弱- ⚠️ 外部研究資料整理，非投資建議
外部研究工具用於補充脈絡，回應會標示資料來源屬 ONE10 external research，不與核心 API-backed 資料混淆。