Taiwan Stocks

@pipeworx/taiwan-stocks

台湾株式 MCP — 台湾証券取引所（TWSE、上市）および台北証券取引所（TPEx、上櫃）に上場する企業の株価、バリュエーション、月次売上高、開示情報、信用残高、配当日を提供します。キーは不要です。

Pipeworx の一部です。AI エージェントを1683以上のライブデータソースに接続する MCP ゲートウェイです。

ツール

• taiwan_stock_quote(symbols) — 日次の始値、高値、安値、終値、値動き、出来高、台湾ドル建て売買代金を取得します。両市場に対応しています。
• taiwan_search_securities(query, market?, limit?) — 企業名、英語略称、コードから上場証券を特定します。
• taiwan_company_profile(symbol) — 業種、会長、社長、設立日と上場日、払込資本金、発行済み株式数、監査人、ウェブサイトを取得します。TWSE のメインボードが対象です。
• taiwan_market_summary(days?) — TAIEX および TPEx の指数水準と、取引日ごとの市場全体の売買代金、出来高、取引件数を取得します。
• taiwan_stock_valuation(symbols) — 各取引所が毎日公表する PER、配当利回り、株価純資産倍率を取得します。
• taiwan_monthly_revenue(symbol?, industry?, limit?) — 月次売上高（月營收）と前月比、前年同月比、年初来の変化率を取得します。または、売上高の成長率で業種をランキングします。
• taiwan_material_news(symbol?, query?, limit?) — 当日中の開示が義務付けられている重要情報（重大訊息）を取得します。取締役会決議、M&A、訴訟、増資などが含まれます。
• taiwan_top_traded(limit?) — その日の TWSE で最も活発に取引された上位20銘柄を取得します。
• taiwan_foreign_holdings(mode?, limit?) — 銘柄別または業種別に、外国人および中国大陸の保有状況と法定上限までの余裕を取得します。
• taiwan_margin_balance(symbols) — 信用取引（融資）と空売り（融券）の残高、および当日の取引状況と取引枠を取得します。
• taiwan_ex_dividend_calendar(symbol?, limit?) — 発表済みの配当落ち日・権利落ち日と、現金および株式による配当条件を取得します。

認証

不要です。両取引所は、キーや利用枠なしでこれらのデータをオープンデータとして公開しています。

入力規則

シンボルを受け取る各ツールでは、次の3形式を相互に使用できます。

形式	例
数値コード	2330、2330.TW、6488
英語略称（取引所独自のもの）	TSMC、HON HAI
中国語名	台積電、鴻海

ETF やワラントは企業マスターに掲載されていなくても TWSE で取引されるため、コードは企業情報を照会せず、そのまま使用されます。

注意点

• 1 つの API に 2 種類の暦があります。 ほとんどのエンドポイントでは中華民国暦の年が使われています （1150819 = 2026-08-19、11507 = 2026-07）。一方、MI_INDEX20 と TPEx の指数 履歴ではグレゴリオ暦が使われています（20260819）。このパックは両方を ISO 形式に正規化します。
• 一部の JSON キーには末尾に空白が含まれます — 開示フィードの件名フィールドは、文字どおり "主旨 " です。取り込み時にすべてのキーの前後の空白を削除します。
• これらは市場全体のファイルであり、銘柄ごとのエンドポイントではありません。 /quote/2330 はありません。最小単位は「本日取引されたすべての銘柄」です（TWSE では 318 KB、TPEx では約 4 MB）。このパックは市場ファイルを取得し、分離環境内で 5 分間キャッシュしてから、サイズの小さい TWSE ファイルを常に先に試し、次に TPEx にフォールバックします。
• TPEx は Cloudflare の送信トラフィックを拒否します（調査中）。 デプロイ済みゲートウェイからは、www.tpex.org.tw は HTTP 520 を返した後、/errors へのリダイレクトループになります。同一の URL に、ワーカーと完全に同じ User-Agent と Accept ヘッダーを付けると、ノートパソコンからは 200 が返るため、問題はリクエストではなく送信元 IP にあります。このパックは、ゲートウェイから送信リレーが渡された場合は TPEx 経由のリクエストをリレーに振り分け、リレーが host_not_allowed を返した場合は直接送信にフォールバックします。そのため、どちらのデプロイが先でもかまいません。www.tpex.org.tw はリレーの許可リストのソースに含まれていますが、エッジ関数はまだ再デプロイされていません — 再デプロイされるまでは TPEx の呼び出しは失敗し、ツールは例外を投げずに機能を縮退させます。TWSE の結果は完全な状態で返され、tpex_unavailable: true と理由が付加されます。また、OTC 銘柄の場合は空の結果ではなく、reason: "tpex_unreachable" が返されます。到達できなかった OTC 証券と、存在しない OTC 証券は異なる結果になります。
• カバレッジの違い。 株価、バリュエーション、証拠金残高は両方の市場を対象とします。企業プロフィール、月次売上高、開示情報、外国人保有状況、権利落ち日カレンダーは TWSE メインボードのファイルを対象とします。TPEx 銘柄の場合は空の結果ではなく、found: false とその理由が返されます。
• 公開時刻。 両取引所とも台北時間 13:30 の取引終了後に公開するため、それより前に表示される最新の取引日は前の取引日です。
• 月次売上高の金額単位は千 TWD、証拠金残高の単位は1,000 株のロットです。

データソース

• TWSE オープンデータ — https://openapi.twse.com.tw/v1 (仕様)
• TPEx オープンデータ — https://www.tpex.org.tw/openapi/v1 (仕様)

クイックスタート

MCP クライアント（Claude Desktop、Cursor、Windsurf など）に追加します。

{
  "mcpServers": {
    "taiwan-stocks": {
      "url": "https://gateway.pipeworx.io/taiwan-stocks/mcp"
    }
  }
}

このエンドポイントが実際に提供するもの

https://gateway.pipeworx.io/taiwan-stocks/mcp の tools/list は、上の表にあるツールに加えて、共有 Pipeworx メタツール — ask_pipeworx、 discover_tools、search_within、remember／recall など、ゲートウェイ全体で使えるツール群 — を返します。そのため、表示されるツール数はこの表より多くなります。現在、単一パックのエンドポイントには、そのパック独自のツールとともに、共有ツールがおよそ 30 個表示されます。接続の initialize 応答には正確な対象範囲が記載されており、その日の状況を確認する際の正式な情報源となります。

これは意図的な設計であり、偶然の多重化ではありません。メタツールを使うことで、このパックでは対応していない質問にも、カタログ全体を横断して振り分ける ask_pipeworx を通じて回答できます。MCP サーバーを追加する必要はありません。現在、メタツールなしでパックのエンドポイントを接続する方法はありません。追加のスキーマにかかるコンテキストのコストが、ルーティングの利点を上回る場合は、複数のパックのエンドポイントではなく、フルゲートウェイに一度接続してください。

または、フル Pipeworx ゲートウェイに接続すると、このパックだけでなく、すべてのパックのツールが直接一覧表示されます。

{
  "mcpServers": {
    "pipeworx": {
      "url": "https://gateway.pipeworx.io/mcp"
    }
  }
}

どちらの URL も、同じゲートウェイと同じ 1683 以上のデータソースに接続します。違いは、どのパックのツールが直接一覧表示されるかだけです。どちらからでも ask_pipeworx を使えば、すべてのツールにアクセスできます。

MCP クライアントがない場合：HTTP で呼び出す

curl -X POST https://gateway.pipeworx.io/v1/tools/taiwan_stock_quote \
  -H 'Content-Type: application/json' \
  -d '{"symbols":"TSMC,2317"}'

最初の呼び出しにアカウントは不要です。任意のツールを確認するには、GET https://gateway.pipeworx.io/v1/tools/taiwan_stock_quote を実行します。ツールを探すには、{"query":"..."} を指定して POST https://gateway.pipeworx.io/v1/tools/search_packs を実行します。

スタンドアロン（ゲートウェイアカウント不要）

このパッケージはローカルの stdio MCP サーバーとしても実行できます。Pipeworx アカウントもゲートウェイを介した往復も不要です。

{
  "mcpServers": {
    "taiwan-stocks": {
      "command": "npx",
      "args": ["-y", "@pipeworx/mcp-taiwan-stocks"]
    }
  }
}

または、直接実行して起動を確認できます。

npx -y @pipeworx/mcp-taiwan-stocks

stdin/stdout 経由で MCP をやり取りし、このパックのツールのみについて initialize／tools/list／tools/call に応答します。上記のゲートウェイ接続で追加される共有メタツールは含まれません。同じソース、同じツールで、ask_pipeworx によるルーティングはありません。

ask_pipeworx の使用

ツールを直接呼び出す代わりに、平易な英語で質問できます。これは上記のパックエンドポイントでも、ゲートウェイ全体でも利用できます。

ask_pipeworx({ question: "your question about Taiwan Stocks data" })

ゲートウェイが適切なツールを選び、引数を自動的に入力します。

詳細

• ドキュメントとガイド
• pipeworx.io

ライセンス

MIT