get_stock_circulate_stock_holder
Retrieve circulating shareholder data for Chinese stocks to analyze ownership distribution and identify major investors in publicly traded companies.
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:788-790 (registration)MCP tool registration decorator for the get_stock_circulate_stock_holder tool.@mcp.tool( name="get_stock_circulate_stock_holder", description="获取指定股票的流通股东情况" )
- src/china_stock_mcp/server.py:791-817 (handler)The handler function implementing the tool logic: fetches stock circulate holder data with fallback to main stock holder using akshare, handles empty data, and formats output in specified format.def get_stock_circulate_stock_holder( 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: """获取指定股票的流通股东情况，支持降级使用 stock_main_stock_holder.""" def _circulate_stock_holder_fetcher(source: str, **kwargs: Any) -> pd.DataFrame: if source == "akshare": return ak.stock_circulate_stock_holder(**kwargs) elif source == "main_stock_holder": return ak.stock_main_stock_holder(**kwargs) else: raise ValueError(f"不支持的数据源: {source}") df = _fetch_data_with_fallback( fetch_func=_circulate_stock_holder_fetcher, primary_source="akshare", fallback_sources=["main_stock_holder"], symbol=symbol, ) if df.empty: df = pd.DataFrame() return _format_dataframe_output(df, output_format)
- Input schema defined via Pydantic Annotated types for symbol (str) and output_format (Literal).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:
- Inner helper function to fetch data from different sources (akshare or main_stock_holder).def _circulate_stock_holder_fetcher(source: str, **kwargs: Any) -> pd.DataFrame: if source == "akshare": return ak.stock_circulate_stock_holder(**kwargs) elif source == "main_stock_holder": return ak.stock_main_stock_holder(**kwargs) else: raise ValueError(f"不支持的数据源: {source}")