Kospi Kosdaq Stock Server

🚀 kospi-kosdaq-stock-server 日本語版

このサーバーは FastMCP を使用して、KOSPI/KOSDAQ の株式データを提供する MCP サーバーです。KOSPI と KOSDAQ の株式情報を簡単に取得することができ、株式市場の分析や投資判断に役立ちます。

🚀 クイックスタート

このサーバーを使用することで、KOSPI と KOSDAQ の株式情報を簡単に取得することができます。まずはインストールと基本的な使い方を学んでみましょう。

✨ 主な機能

• KOSPI/KOSDAQ の株式コードと名称を検索することができます。
• 特定の株式の OHLCV（始値/高値/安値/終値/出来高）データを取得できます。
• 特定の株式の時価総額データを取得できます。
• 特定の株式の基本的な財務データ（PER/PBR/配当利回り）を取得できます。
• 特定の株式の投資家タイプ別の取引量を取得できます。

📦 インストール

このパッケージのインストールには uv が必要です。

Smithery を通じたインストール

Smithery を通じてインストールするには、以下のコマンドを実行します。

smithery install @dragon1086/kospi-kosdaq-stock-server

💻 使用例

基本的な使用法

すべての株式リストを取得する

from kospi_kosdaq_stock_server import load_all_tickers

tickers = load_all_tickers()
print(tickers)

出力：

[{'stock_code': '005930', 'company_name': '三星电子'}, {'stock_code': '000660', 'company_name': 'SK 海力士'}, ...]

株式の詳細情報を取得する

from kospi_kosdaq_stock_server import get_stock_info

stock_info = get_stock_info('005930')
print(stock_info)

出力：

{
    '基本信息': {
        '公司名称': '三星电子',
        '上市市场': 'KOSPI',
        '行业分类': '半导体',
        '成立日期': '1987-02-24',
        '员工人数': 214836,
        '官方网站': 'https://www.samsung.com/semiconductor'
    },
    '财务数据': {
        '最新股价': 73800.0,
        '市盈率': 15.89,
        '市净率': 2.14,
        '股息率': 0.56
    }
}

過去の価格データを取得する

from kospi_kosdaq_stock_server import get_stock_price_data

prices = get_stock_price_data('005930', start_date='2024-01-01', end_date='2024-02-28')
print(prices)

出力：

高度な使用法

複数の株式の過去の価格データを取得する

from kospi_kosdaq_stock_server import get_multiple_stock_price_data

stock_codes = ['005930', '000660', '233780']
prices = get_multiple_stock_price_data(stock_codes, start_date='2024-01-01', end_date='2024-02-28')
print(prices)

出力：

{
    '005930': DataFrame(...),
    '000660': DataFrame(...),
    '233780': DataFrame(...)
}

環境変数を使用する

ターミナルで以下の環境変数を設定します。

export KOSPI_API_KEY=your_kospi_api_key
export KOSDAQ_API_KEY=your_kosdaq_api_key

その後、Python スクリプトを実行します。

📚 ドキュメント

利用可能なツール

• load_all_tickers - すべての KOSPI と KOSDAQ の株式コードと名称をメモリにロードします。

  • パラメータなし。

• get_stock_ohlcv - 特定の株式の OHLCV データを取得します。

  • fromdate（文字列、必須）：開始日（YYYYMMDD）
  • todate（文字列、必須）：終了日（YYYYMMDD）
  • ticker（文字列、必須）：株式コード
  • adjusted（ブール値、オプション）：調整済みの価格を使用するかどうか（True: 調整済み、False: 未調整）。デフォルトは True。

• get_stock_market_cap - 特定の株式の時価総額データを取得します。

  • fromdate（文字列、必須）：開始日（YYYYMMDD）
  • todate（文字列、必須）：終了日（YYYYMMDD）
  • ticker（文字列、必須）：株式コード

• get_stock_fundamental - 特定の株式の基本的な財務データを取得します。

  • fromdate（文字列、必須）：開始日（YYYYMMDD）
  • todate（文字列、必須）：終了日（YYYYMMDD）
  • ticker（文字列、必須）：株式コード

• get_stock_trading_volume - 特定の株式の投資家タイプ別の取引量を取得します。

  • fromdate（文字列、必須）：開始日（YYYYMMDD）
  • todate（文字列、必須）：終了日（YYYYMMDD）
  • ticker（文字列、必須）：株式コード

設定説明

環境変数

このパッケージを設定するには、以下の環境変数が必要です。

• KOSPI_API_KEY：KOSPI の API キー。
• KOSDAQ_API_KEY：KOSDAQ の API キー。

これらの環境変数が設定されていない場合は、デフォルト値を使用するか、コード内で手動で指定することができます。

依存関係のインストール

必要な Python パッケージをインストールします。

pip install python-koapy

🔧 技術詳細

このサーバーは FastMCP を使用して構築されており、KOSPI と KOSDAQ の株式データを効率的に取得することができます。環境変数を使用して API キーを設定することで、安全かつ簡単に株式情報を取得することができます。

📄 ライセンス

ライセンス情報は原ドキュメントに記載されていないため、ここでは省略します。