convertible_bond

Retrieve convertible bond data from the Xueqiu stock market platform. Use this tool to access detailed information about convertible bonds, including paginated results for efficient browsing.

Instructions

获取可转债信息

Args:
    page_size: 每页显示数量
    page_count: 页码

Input Schema

TableJSON Schema

Name	Required	Description	Default
`page_size`	No
`page_count`	No

Implementation Reference

main.py:298-307 (handler)

The handler function for the 'convertible_bond' MCP tool. It is decorated with @mcp.tool() for registration and executes the tool logic by invoking pysnowball's convertible_bond method with pagination parameters and processing the returned data using process_data.

@mcp.tool()
def convertible_bond(page_size: int = 5, page_count: int = 1) -> dict:
    """获取可转债信息
    
    Args:
        page_size: 每页显示数量
        page_count: 页码
    """
    result = ball.convertible_bond(page_size=page_size, page_count=page_count)
    return process_data(result)

main.py:298-298 (registration)
The @mcp.tool() decorator registers the convertible_bond function as an MCP tool.
```
@mcp.tool()
```

main.py:34-62 (helper)

Shared helper function used by convertible_bond (and other tools) to process raw data from pysnowball, including timestamp conversion.

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

main.py:14-31 (helper)

Helper utility for converting timestamps in the data returned by pysnowball.convertible_bond, used within process_data.

def convert_timestamps(data):
    """递归地将数据中的所有 timestamp 转换为 datetime 字符串"""
    if isinstance(data, dict):
        for key, value in list(data.items()):
            if key == 'timestamp' and isinstance(value, (int, float)) and value > 1000000000000:  # 毫秒级时间戳
                data[key] = datetime.datetime.fromtimestamp(value/1000).strftime('%Y-%m-%d %H:%M:%S')
            elif key == 'timestamp' and isinstance(value, (int, float)) and value > 1000000000:  # 秒级时间戳
                data[key] = datetime.datetime.fromtimestamp(value).strftime('%Y-%m-%d %H:%M:%S')
            elif key.endswith('_date') and isinstance(value, (int, float)) and value > 1000000000000:  # 毫秒级时间戳
                data[key] = datetime.datetime.fromtimestamp(value/1000).strftime('%Y-%m-%d %H:%M:%S')
            elif key.endswith('_date') and isinstance(value, (int, float)) and value > 1000000000:  # 秒级时间戳
                data[key] = datetime.datetime.fromtimestamp(value).strftime('%Y-%m-%d %H:%M:%S')
            elif isinstance(value, (dict, list)):
                data[key] = convert_timestamps(value)
    elif isinstance(data, list):
        for i, item in enumerate(data):
            data[i] = convert_timestamps(item)
    return data

Xueqiu MCP