indicator
Retrieve annual and quarterly financial performance reports for specific stocks from the Xueqiu stock market data service.
Instructions
按年度、季度获取业绩报表数据
Args:
stock_code: 股票代码
is_annals: 只获取年报,默认为1
count: 返回数据数量,默认5条Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| stock_code | No | SZ000002 | |
| is_annals | No | ||
| count | No |
Implementation Reference
- main.py:141-152 (handler)The handler function for the 'indicator' MCP tool. It is registered via @mcp.tool() decorator. Fetches performance indicator data from pysnowball.ball.indicator with parameters for stock code, annual/quarterly reports, and count, then processes the data with timestamps conversion.
@mcp.tool() def indicator(stock_code: str="SZ000002", is_annals: int = 1, count: int = 5) -> dict: """按年度、季度获取业绩报表数据 Args: stock_code: 股票代码 is_annals: 只获取年报,默认为1 count: 返回数据数量,默认5条 """ result = ball.indicator(symbol=stock_code, is_annals=is_annals, count=count) return process_data(result) - main.py:141-141 (registration)The @mcp.tool() decorator registers the subsequent indicator function as an MCP tool named 'indicator' (by function name).
@mcp.tool() - main.py:142-149 (schema)The function signature and docstring define the input schema (parameters with types, defaults, descriptions) and output type (dict).
def indicator(stock_code: str="SZ000002", is_annals: int = 1, count: int = 5) -> dict: """按年度、季度获取业绩报表数据 Args: stock_code: 股票代码 is_annals: 只获取年报,默认为1 count: 返回数据数量,默认5条 """ - main.py:34-61 (helper)Shared helper function used by the indicator tool (and others) to process response data, including converting timestamps to readable datetime strings.
def process_data(data, process_config=None): """ 通用数据处理函数，可扩展添加各种数据处理操作 Args: data: 原始数据 process_config: 处理配置字典，用于指定要执行的处理操作 例如: {'convert_timestamps': True, 'other_process': params} Returns: 处理后的数据 """ if process_config is None: # 默认配置 process_config = { 'convert_timestamps': True } # 如果开启了时间戳转换 if process_config.get('convert_timestamps', True): data = convert_timestamps(data) # 在这里可以添加更多的数据处理逻辑 # 例如: # if 'format_numbers' in process_config: # data = format_numbers(data, **process_config['format_numbers']) return data