get_shareholder_info

Retrieve shareholder information for specific Chinese stocks to analyze ownership structure and investor composition using stock symbol lookup.

Instructions

获取指定股票的股东情况

Input Schema

TableJSON Schema

Name	Required	Description	Default
`symbol`	Yes	股票代码 (例如: '000001')
`output_format`	No	输出数据格式: json, csv, xml, excel, markdown, html。默认: markdown	markdown

Implementation Reference

src/china_stock_mcp/server.py:642-642 (registration)
Registers the get_shareholder_info tool with the MCP framework, specifying its name and description.
```
@mcp.tool(name="get_shareholder_info", description="获取指定股票的股东情况")
```

src/china_stock_mcp/server.py:643-660 (handler)

Main handler function for the get_shareholder_info tool. Takes stock symbol and output format, fetches shareholder data using akshare, handles empty data, and formats output.

def get_shareholder_info(
    symbol: Annotated[str, Field(description="股票代码 (例如: '000001')")]  ,
    output_format: Annotated[
        Literal["json", "csv", "xml", "excel", "markdown", "html"],
        Field(description="输出数据格式: json, csv, xml, excel, markdown, html。默认: markdown"),
    ] = "markdown"
) -> str:
    """获取股东情况"""
    def get_shareholder_info_fetcher(
        symbol: str, **kwargs: Any
    ) -> pd.DataFrame:
        """获取股东数据"""
        return ak.stock_zh_a_gdhs_detail_em(symbol)
    
    df = get_shareholder_info_fetcher(symbol)    
    if df.empty:
        df = pd.DataFrame()
    return _format_dataframe_output(df, output_format)

src/china_stock_mcp/server.py:644-648 (schema)

Pydantic schema definitions for input parameters: symbol (str) and output_format (Literal with default 'markdown'), output is str.

symbol: Annotated[str, Field(description="股票代码 (例如: '000001')")]  ,
output_format: Annotated[
    Literal["json", "csv", "xml", "excel", "markdown", "html"],
    Field(description="输出数据格式: json, csv, xml, excel, markdown, html。默认: markdown"),
] = "markdown"

src/china_stock_mcp/server.py:651-656 (helper)

Helper function to fetch shareholder detail data from akshare (stock_zh_a_gdhs_detail_em).

def get_shareholder_info_fetcher(
    symbol: str, **kwargs: Any
) -> pd.DataFrame:
    """获取股东数据"""
    return ak.stock_zh_a_gdhs_detail_em(symbol)

China Stock MCP