"""Daily trading data tools."""
from typing import Optional
from fastmcp import FastMCP
from utils import (
TWSEAPIClient,
format_properties_with_values_multiline,
MSG_NO_DATA_FOR_CODE,
MSG_QUERY_FAILED_WITH_CODE,
handle_api_errors,
)
def register_tools(mcp: FastMCP, client: Optional[TWSEAPIClient] = None) -> None:
"""Register daily trading tools with the MCP instance."""
# Use injected client or fallback to singleton
_client = client or TWSEAPIClient.get_instance()
@mcp.tool
@handle_api_errors(use_code_param=True)
def get_stock_daily_trading(code: str) -> str:
"""Obtain daily trading information for a listed company stock based on its stock code.
Returns information including:
- Date: Trading date (ROC calendar YYYMMDD)
- Code: Stock code
- Name: Stock name
- TradeVolume: Trade volume (in shares)
- TradeValue: Trade value (in TWD)
- OpeningPrice: Opening price
- HighestPrice: Highest price
- LowestPrice: Lowest price
- ClosingPrice: Closing price
- Change: Price change
- Transaction: Transaction count
"""
data = _client.fetch_company_data("/exchangeReport/STOCK_DAY_ALL", code)
if not data:
return MSG_NO_DATA_FOR_CODE.format(query_target=f"股票代號 {code}", data_type="日成交資訊")
result = f"【{data.get('Name', 'N/A')} ({data.get('Code', code)})】日成交資訊\n\n"
date = data.get("Date", "N/A")
trade_volume = data.get("TradeVolume", "N/A")
trade_value = data.get("TradeValue", "N/A")
opening = data.get("OpeningPrice", "N/A")
highest = data.get("HighestPrice", "N/A")
lowest = data.get("LowestPrice", "N/A")
closing = data.get("ClosingPrice", "N/A")
change = data.get("Change", "N/A")
transaction = data.get("Transaction", "N/A")
result += f"日期: {date}\n"
result += f"開盤價: {opening}\n"
result += f"最高價: {highest}\n"
result += f"最低價: {lowest}\n"
result += f"收盤價: {closing}\n"
result += f"漲跌: {change}\n"
result += f"成交股數: {trade_volume}\n"
result += f"成交金額: {trade_value}\n"
result += f"成交筆數: {transaction}\n"
return result
