Hk Stocks

@pipeworx/hk-stocks

香港株式市場のリアルタイムデータ — ハンセン指数ファミリー全銘柄と HKEX 株価のリアルタイム情報を提供します。銘柄名からコードを解決し、ワラントではなく実際の株式を返します。

Pipeworx の一部です。AI エージェントを 1881 以上のリアルタイムデータソースに接続する MCP ゲートウェイです。これは独立した非公式の連携であり、上流プロバイダーとは提携・承認・公開のいずれもされていません。

ツール

• hk_market_snapshot() — HSI（恒生指数）、HSCEI（恒生中国企業指数、H 株）、HSTECH（恒生科技指数）、HSCCI（恒生香港中資企業指数、レッドチップ）、VHSI（恒指波幅指数、ボラティリティ）の終値、変動幅、変動率、日中レンジ、52 週レンジ。「香港市場の終値はどうだったか」に回答します。
• hk_quote({ codes }) — HKEX コードによるリアルタイム株価。英語名と中国語名、株価、変動幅、始値／前日終値、日中高値／安値、出来高、HKD 建て売買代金、PER、52 週レンジを返します。700、00700、0700.HK、HK:700 を受け付けます。
• hk_resolve_symbol({ name }) — 会社名から HKEX コードを取得します。英語と中国語の入力に対応しています。

認証

キーは不要です。どちらの上流サービスも公開されており、認証は不要です。登録も、調整が必要な利用枠もありません。

データソース

• https://hq.sinajs.cn/list=rt_hkHSI,rt_hk00700 — 指数水準と株価。UTF-8 ではなく GBK エンコードです。生バイトからデコードしてください（new TextDecoder('gbk')）。そうしないと、中国語名がすべて文字化けします。
• https://suggest3.sinajs.cn/suggest/type=31&key=腾讯 — 中国語入力の銘柄名からコードを取得します。
• https://query1.finance.yahoo.com/v1/finance/search?q=tencent — ラテン文字入力の銘柄名からコードを取得します。

再調査の手間を省くための注意点

どちらの銘柄名解決用上流サービスも、両方の文字体系には対応していません。そのため、2 つを使い分けています。

• Yahoo は ASCII 以外の文字を拒否します。q=小米 は空の検索結果ではなく、HTTP 400 を返します。中国語のクエリにはまったく回答できません。
• Sina の香港銘柄検索は、ラテン文字入力ではワラントのインデックスになります。 key=tencent は TENCENT N4104、TENCENT N6006、TENCENT N3606-R …を返し、00700 は決して返しません。中国語入力（key=腾讯）では、同じエンドポイントが実際の株式を最初に表示します。そのため、CJK には Sina、ラテン文字には Yahoo を使い、Yahoo で見つからない場合は Sina にフォールバックします。

HKEX コードの範囲で絞り込みます。 株式と GEM は 10000 未満、10000～69999 はデリバティブ・ワラントと CBBC、80000 以上はデュアルカウンター銘柄の人民元カウンターです（80700 はテンセントの人民元建てラインであり、香港ドル建て株式ではありません）。どちらも「テンセントの HK コードは？」という質問に対する、もっともらしく見える誤った回答です。そのため、< 10000 という単一のしきい値で両方を除外します。

指数の売買代金／出来高は意図的に返していません。 Sina は株式のフィールド 11／12 に香港ドル建て売買代金と出来高を入力します。これは検証可能です。36,203,193 株 × 約 HK$462 は、報告される HK$16.76bn の売買代金と一致します。一方、指数の行では、これらの項目に別の値が入ります。HSI では 312,233,275 と 14,192,915,767 が報告されますが、いずれも既知の HKEX の日次売買代金とは一致しません。根拠を説明できない数値に別のラベルを付けるより、スナップショットから除外し、その旨を伝えます。hk_quote の銘柄別売買代金は正確です。

上場していない銘柄を指定すると、エラーではなく空のペイロードが返ります。 Sina は不明なコードに対して var hq_str_rt_hk99999=""; を返します（HTTP 200）。呼び出し側はフィールドリストが空なら見つからなかったものとして扱う必要があります。そうしないと、存在しない銘柄が価格 null の株価情報として黙って返されます。

クイックスタート

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

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

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

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

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

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

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

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

MCP クライアントがなくても HTTP で呼び出せます

curl -X POST https://gateway.pipeworx.io/v1/tools/hk_market_snapshot \
  -H 'Content-Type: application/json' \
  -d '{}'

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

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

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

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

または、直接実行して起動することを確認します。

npx -y @pipeworx/mcp-hk-stocks

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

ask_pipeworx を使う

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

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

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

詳細

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

ライセンス

MIT