Pykrx MCP

pykrxに基づくMCPサーバーで、AIエージェントに韓国株式市場のデータ照会機能を提供し、株価、財務指標、投資家取引、空売りデータなどの多面的な分析をサポートします。

金融研究とデータ #韓国株式市場 #AIエージェント #データ照会 #MCPサービス .Python

スコア : 2ポイント

ダウンロード数 : 7.4K

更新時間 : 2026-03-13

サイトを開く

pykrx-mcpとは？

pykrx-mcpは、Model Context Protocol (MCP)に基づくサーバーで、AIアシスタント（ChatGPTやClaudeなど）に韓国株式市場のデータを提供するために特別に設計されています。ユーザーは自然言語を使って、韓国の3大取引所（KOSPI、KOSDAQ、KONEX）のさまざまな金融データを照会でき、複雑なAPI構文を覚える必要はありません。

pykrx-mcpの使い方は？

簡単な設定で、pykrx-mcpサーバーをClaude Desktopに統合し、その後はチャットのように株式データを尋ねることができます。例えば、「三星電子の直近1か月の株価はいくらですか？」や「KOSPI指数の今日の成績はどうですか？」などを直接尋ねることができます。

適用シーン

投資家、アナリスト、学生、そして韓国株式市場の情報を迅速に取得する必要のあるすべての人に適しています。投資分析、市場調査、学術プロジェクト、日常の投資決定のいずれにおいても、AIアシスタントを通じて必要なデータを簡単に取得できます。

主要機能

株式データ

個別株式の価格、取引量、時価総額、財務指標（PER、PBR、EPSなど）の照会機能を提供します。

指数データ

KOSPI、KOSDAQなどの市場指数の価格推移、構成銘柄、基本指標を照会します。

投資家分析

機関投資家、外国投資家、個人投資家などの異なるグループの売買動向と資金の流れを分析します。

空売りデータ

個別株式の空売り取引量、空売り残高、空売り比率などのデータを提供し、市場の雰囲気を把握するのに役立ちます。

ETFデータ

上場投資信託（ETF）の価格、取引量、基本情報を照会します。

自然言語インターフェース

複雑なコマンドを学ぶ必要がなく、日常の言葉を使ってすべてのデータを照会でき、使用の敷居を下げます。

利点

ユーザーフレンドリー：自然言語で照会でき、技術的な背景が必要ありません

データが充実：韓国の3大取引所のさまざまなデータタイプを網羅

リアルタイム性：KRX公式データに基づいており、情報がタイムリーかつ正確

統合が容易：ClaudeやChatGPTなどのAIプラットフォームに簡単に統合できる

無料でオープンソース：MITライセンスに基づいており、自由に使用および修正できる

制限

韓国株式市場のデータのみをサポートし、他の国際市場は含まれません

Claude DesktopまたはMCPをサポートするAIプラットフォームが必要

データの更新頻度はKRXのデータ公開時間に依存します

高度な分析機能はユーザーが独自に照会を組み合わせる必要があります

使い方

pykrx-mcpのインストール

MCP Registryを通じてワンクリックでインストールするか、pip/uvを使用して手動でインストールします。

Claude Desktopの設定

Claude Desktopの設定ファイルを変更し、pykrx-mcpサーバーの設定を追加します。

再起動して使用開始

Claude Desktopを再起動し、その後はチャットで直接株式データを尋ねることができます。

使用例

個別株式の価格分析

投資家が三星電子の直近の市場動向、価格推移と取引量の変化を知りたい場合。

財務指標の比較

アナリストが投資判断を行うために、いくつかのテクノロジー企業の評価水準を比較する必要がある場合。

市場雰囲気分析

トレーダーが外国投資家の韓国市場に対する見方を知り、外国投資家の売買行動から市場の雰囲気を判断したい場合。

空売り監視

リスク管理者が市場で空売り活動が異常に活発な株式を監視する必要がある場合。

よくある質問

pykrx-mcpは無料ですか？

使用するのにプログラミング知識が必要ですか？

データの更新頻度はどれくらいですか？

リアルタイムの株価をサポートしていますか？

ChatGPTで使用できますか？

データは正確ですか？

🚀 pykrx-mcp

このプロジェクトは、韓国株式市場のデータをAIエージェントに提供するMCP（Model Context Protocol）サーバーです。pykrxライブラリを基に、KOSPI、KOSDAQ、KONEX市場の株価、財務諸表、投資家別需給、空売りなどの様々なデータをChatGPTやClaudeで自然言語で照会することができます。

☕ 支援する

このプロジェクトが役に立った場合は、開発者を応援してください！

🚀 クイックスタート

Claude Desktopでの使用方法

自動インストール（推奨）

MCP Registryを通じたワンクリックインストール：

npx @modelcontextprotocol/inspector install pykrx-mcp

手動インストール

Claude Desktopの設定ファイルを直接編集します。

macOS/Linux：~/Library/Application Support/Claude/claude_desktop_config.json Windows：%APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "pykrx": {
      "command": "uvx",
      "args": ["pykrx-mcp"]
    }
  }
}

設定後、Claude Desktopを再起動するとすぐに使用できます。

✨ 主な機能

サポートされるデータとAPI

すべてのAPIはpykrxライブラリを基に実装されています。

株式データ (Stock Data)

銘柄情報

get_market_ticker_list：市場別銘柄コード照会
get_market_ticker_name：銘柄コードで銘柄名を照会

価格データ

get_stock_ohlcv：個別銘柄のOHLCV（始値/高値/安値/終値/出来高）
get_market_ohlcv_by_date：特定日付の全銘柄の相場
get_market_price_change：期間別の全銘柄の価格変動

時価総額

get_market_cap_by_date：個別銘柄の時価総額照会

財務指標

get_market_fundamental_by_date：PER、PBR、EPS、DIV、BPS、DPS

投資家別取引

get_market_trading_value_by_date：銘柄別の投資家需給（取引代金）
get_market_trading_volume_by_investor：投資家別の出来高
get_market_trading_value_by_investor：投資家別の取引代金
get_market_net_purchases_of_equities：投資家別の純買い上位銘柄

指数データ (Index Data)

指数情報

get_index_ticker_list：指数ティッカーのリスト
get_index_ticker_name：指数名を照会
get_index_portfolio_deposit_file：指数構成銘柄

指数価格

get_index_ohlcv：指数のOHLCVデータ

指数指標

get_index_fundamental：指数のPER/PBR/配当利回り

空売りデータ (Short Selling)

get_shorting_status_by_date：銘柄別の空売り状況
get_shorting_volume_by_ticker：全銘柄の空売り出来高
get_shorting_balance_top50：空売り残高上位50
get_shorting_volume_top50：空売り出来高比率上位50

外国人投資 (Foreign Investment)

get_exhaustion_rates_of_foreign_investment：外国人保有量と限度消化率

ETFデータ

get_etf_ticker_list：ETF銘柄のリスト
get_etf_ohlcv_by_date：ETFのOHLCVデータ

合計23のデータ照会ツールをサポートしています

💻 使用例

株価照会

個別銘柄の株価

"三星電子の直近1か月の株価を見せて"
"SKハイニックスの2024年1月のOHLCVデータ"
"カカオの先週の株価動きを分析して"

市場全体の相場

"コスピの全銘柄の今日の相場を見せて"
"コスダックの上位10銘柄の価格変動率"

時価総額と出来高

"三星電子の時価総額はいくら？"
"三星電子の直近1か月の出来高の推移"
"ネイバーの取引代金を分析して"

財務指標

"三星電子のPER、PBRを教えて"
"三星電子の配当利回りはいくら？"
"ネイバーの直近のEPSは？"

投資家別需給分析

"三星電子の外国人買いの勢いはどう？"
"カカオの直近の機関需給を分析"
"コスピで個人投資家が多く買った銘柄"
"外国人が純買いした上位10銘柄"

空売り分析

"三星電子の空売り比率はいくら？"
"コスピの空売り上位銘柄を教えて"
"空売り残高が最も高い銘柄は？"

指数照会

"コスピ指数の直近1か月の推移"
"コスダック150指数のPERは？"
"半導体セクター指数の構成銘柄を教えて"

外国人投資

"三星電子の外国人保有比率は？"
"外国人限度消化率が高い銘柄"

銘柄検索

"コスピの銘柄リスト"
"005930の銘柄名は何？"
"今日取引されたETFのリスト"

主な特徴

自然言語対話型インターフェース

複雑なAPI構文を使わずに、日常の言葉でデータを照会できます。

リアルタイムの韓国株式市場データ

KRX（韓国取引所）の最新データを提供します。

様々な分析機能

価格推移分析
投資家別需給分析
財務指標比較
空売り状況分析

AIエージェント最適化

ChatGPTとClaudeですぐに使用できるように、MCPプロトコルをサポートしています。

🔧 技術詳細

Python 3.10+
pykrx：韓国株式市場のデータ収集
FastMCP：MCPサーバーフレームワーク
MCP (Model Context Protocol)：AIエージェントとの通信プロトコル

📚 ドキュメント

ローカル開発環境の設定

詳細はDEVELOPMENT.mdを参照してください。

# リポジトリをクローン
git clone https://github.com/sharebook-kr/pykrx-mcp.git
cd pykrx-mcp

# 依存関係をインストール
uv pip install -e ".[dev]"

# テストを実行
uv run pytest

# サーバーを起動
uv run pykrx-mcp