com.twmarketdata/tw-market-data

Semantic search over MOPS filings and announcements — ⚠️ NOT YET AVAILABLE (語意檢索尚未提供/建置中). ★ STATUS, READ FIRST: the semantic index has not been built. Every call currently returns NO rows, with `corpus.index_is_empty: true` and `corpus.service_status: "not_yet_available"`. Tell the user this capability is not available yet. Do NOT present it as a working feature, and do NOT read the empty result as "the company disclosed nothing" — it is a service state, not a fact about any company. Once built, it matches on MEANING rather than keywords. The declared corpus is MOPS 重大訊息 subject lines plus a small MOPS full-text set; financial-statement notes do not exist in this database and company news is refused — `corpus` in every response says exactly what is indexed. ★ POINT-IN-TIME: pass `as_of` (YYYY-MM-DD). Chunks are filtered `published_at <= as_of` in SQL BEFORE ranking, so a backtest cannot retrieve a filing that did not exist yet. `meta.as_of_applied` echoes the cutoff that actually ran — check it. **Without `as_of` the results include the most recent filings and are look-ahead UNSAFE for backtesting**; the response says so in `meta.warnings`. ★ REFERENCE CONTEXT, NOT AUTHORITY. Every hit carries `source`, `source_tier` ("official" = MOPS/exchange, "third_party" = press) and a `url`. Read the chunk and judge it yourself; the ranking is similarity, not importance, and similarity is not evidence. **Nothing here is investment advice** (`not_investment_advice: true`). ★ A ticker you asked about that returns nothing appears in `coverage.missing` with a reason. That means NOTHING IS INDEXED for it under those filters — it does NOT mean the company disclosed nothing. Do not fill the gap. Args: query: what to look for, in Chinese or English (e.g. '匯率風險', 'CoWoS capacity'). tickers: restrict to these codes, e.g. ['2330','2317']. doc_type: 'mops_major_event' or 'mops_a…

Leave a standing instruction: tell me when this symbol crosses this price. The alert OUTLIVES this conversation. It is evaluated against official daily closes by a resident agent and delivered to your realtime stream and to any webhook endpoints you have registered — signed, retried, and de-duplicated so one crossing is one notification. This is a NOTIFICATION, not an order. Nothing in TWMD can place a trade. Args: rule_id: your name for this alert. Re-using one UPDATES it rather than adding a second. symbol: the Taiwan ticker, e.g. "2330". direction: "below" or "above". threshold: the price level, in TWD. label: optional human-readable note carried on the alert. edge_triggered: True (default) fires on the CROSSING only — one long slump does not notify you every day. False fires on every bar that is past the level.

供應鏈與同業:產業鏈位置、同業分組、轉投資、外銷訂單 vs 營收。 ★ 事實整理,不是投資建議、不是預測。輸出帶 `does_not_prove`。 ★ ⚠️ `company_peer_groups` 無日期欄:指定過去的 `as_of` 時,回的是**現況**分組, `pit_notes` 會標「非當時分類」。 ★ ⚠️ 質化的客戶/供應商關係與分部營收在年報附註,那條來源**尚未建置** —— 固定列在 `cannot_see`(status=no_loader),不是這次查失敗。 ★ Args:`ticker`(例如 "2330")、`as_of`(選填)。 ★ Returns:誠實信封;外銷訂單與營收的背離會 listed in `concerns`。 ★ PRECONDITIONS:自己取數;requires 一個已識別的 session。 ★ SIDE EFFECTS:read-only,does not 寫入。

Hand an unregistered caller a short taste of an open dataset, plus where to unlock the rest. ★ WHAT AN ACCOUNTLESS CALLER GETS INSTEAD OF A BARE REFUSAL. Somebody arriving through a chat connector with no plan would otherwise meet a flat rejection, which the host model relays as "this service turned you down". ★ WHAT IS ACTUALLY FREE, STATED CONCRETELY. The reference resources read with no key at all, and the five sample tickers (2330, 2317, 2454, 0050, 2603) answer through `query_dataset` with no plan. Querying beyond those over MCP starts at the Pro plan. ★ OPEN DATASETS YIELD A FEW MARKED ROWS; PAID ONES YIELD NONE. For a paid dataset the row list is not even consulted, so no figure can escape through this path regardless of what the caller passes in. `rows_withheld` states how many were held back, because a taste that does not say it is a taste reads as the whole thing. ★ NOT `query_dataset`. That one serves entitled callers in full. This exists only for the moment somebody hits the edge of what they are entitled to. ⚠️ Withdrawn datasets stay refused here too — a licence ruling is not a tier, so no amount of signing up unlocks them. Args: dataset, keyless_eligible, rows.