Kospi Kosdaq Stock Server

🚀 kospi-kosdaq-stock-server 中文版

這是一個使用 FastMCP 提供 KOSPI/KOSDAQ 股票數據的 MCP 服務器，可用於查找股票代碼和名稱，獲取股票的 OHLCV 數據、市值數據、基本面數據以及按投資者類型劃分的交易量。

✨ 主要特性

• 查找 KOSPI/KOSDAQ 的股票代碼和名稱。
• 獲取特定股票的 OHLCV（開盤價/最高價/最低價/收盤價/成交量）數據。
• 獲取特定股票的市值數據。
• 獲取特定股票的基本面數據（PER/PBR/股息率）。
• 獲取特定股票按投資者類型劃分的交易量。

📦 安裝指南

此包的安裝需要 uv。

通過 Smithery 安裝

要通過 Smithery 安裝，可使用以下命令：

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

安裝依賴

安裝必要的 Python 包：

pip install python-koapy

環境變量配置

此包需要以下環境變量來配置：

• KOSPI_API_KEY：KOSPI 的 API 密鑰。
• KOSDAQ_API_KEY：KOSDAQ 的 API 密鑰。

如果未設置這些環境變量，可以使用默認值或在代碼中手動指定。

💻 使用示例

基礎用法

示例 1：獲取股票信息

獲取所有股票列表

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)

輸出：

高級用法

示例 2：獲取多個股票的歷史價格數據

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(...)
}

示例 3：使用環境變量

在終端中設置以下環境變量：

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 或 KOSDAQ_API_KEY 環境變量，可能會導致程序運行出錯。可以使用默認值或在代碼中手動指定這些環境變量來避免此類錯誤。