接口文档
工具、参数与返回结构
这里记录公开文档展示的 28 个工具:工具名、描述、参数、示例参数和返回说明。 其中 27 个业务工具支持 HTTP API 备用调用,连接测试工具仅用于 MCP 连通性验证。
实际可用工具以登录后的 tools/list 为准。
业务工具可用同一参数结构调用 HTTP API。
用于验证 MCP 端点与 Token 配置。
28 个工具参数
MCP 调用时把下列参数放入 params.arguments;支持 HTTP API 的工具使用同样的 { arguments: { ... } } 请求体。 结构化业务工具的 MCP 响应会同时在 content[].text 和 structuredContent 中提供完整 JSON 结果。
search_code代码搜索MCP / HTTP API股票代码、指数代码和宏观指标代码查询。
查看详情
search_code代码搜索MCP / HTTP API股票代码、指数代码和宏观指标代码查询。
用户提到“股票代码”“指数代码”“宏观指标代码”或准备按代码取数时首选;先确认标准 ticker,再传给行情、估值、财务或宏观接口。
| 参数 | 类型 | 必填 | 默认 | 说明 |
|---|---|---|---|---|
| keyword | string | 是 | - | 搜索关键词,例如 "平安"、"000001"。 |
| data_type | string | 否 | - | 数据类型过滤,可选 "A股"、"美股"、"港股"、"指数"、"宏观指标"。 |
| 返回字段 | 类型 | 说明 |
|---|---|---|
| tool | string | 本次调用的工具名。 |
| arguments | object | 服务端校验后实际执行的参数。 |
| result[] | object[] | 匹配到的代码候选列表。 |
| result[].code / ticker | string | 可继续传给行情、估值、财务或宏观工具的标准代码。 |
| result[].name | string | 证券、指数或宏观指标名称。 |
| result[].data_type | string | 候选结果所属类型,例如 A股、美股、港股、指数或宏观指标。 |
返回候选标的代码、名称、市场类型,以及宏观指标的单位、来源和样本覆盖信息。
{
"arguments": {
"keyword": "平安",
"data_type": "A股"
}
}{
"tool": "search_code",
"arguments": {
"keyword": "平安",
"data_type": "A股"
},
"result": [
{
"ticker": "000001.SZ",
"name": "平安银行",
"data_type": "A股"
}
]
}get_basicinfo基础信息MCP / HTTP API根据 A股 TRADE_CODE 查询公司基础信息。
查看详情
get_basicinfo基础信息MCP / HTTP API根据 A股 TRADE_CODE 查询公司基础信息。
已知 A股代码时,用于读取公司名称、上市日期、地域、行业分类、主营业务和主要股东信息。
| 参数 | 类型 | 必填 | 默认 | 说明 |
|---|---|---|---|---|
| TRADE_CODE | string | 是 | - | A股股票代码,例如 "000001.SZ"、"600519.SH"。 |
| 返回字段 | 类型 | 说明 |
|---|---|---|
| tool | string | 本次调用的工具名。 |
| arguments | object | 服务端校验后实际执行的参数。 |
| result.message | string | 本次工具调用的结果摘要。 |
| result.data[] | object[] | 一个或多个结构化结果集。 |
| result.data[].format | string | 结果集格式;表格结果通常为 "compact_table"。 |
| result.data[].columns | string[] | 表格列名,按 rows 中每行的值顺序排列。 |
| result.data[].rows | array[] | 二维数组形式的数据行,避免每行重复字段名。 |
| result.credits | string | 额度计算说明;实际扣费以调用日志记录为准。 |
返回 compact_table 结构的公司基础信息,表头直接使用 db_schema.json 对应列 comment,例如 股票代码、股票名称、上市日期、申万一级行业、业务范围、大股东名称、大股东持股比例、更新日期;metadata 保留内部字段名和原始数据库列名。
{
"arguments": {
"TRADE_CODE": "600519.SH"
}
}{
"tool": "get_basicinfo",
"arguments": {
"TRADE_CODE": "600519.SH"
},
"result": {
"message": "返回 compact_table 结构的公司基础信息,表头直接使用 db_schema.json 对应列 comment,例如 股票代码、股票名称、上市日期、申万一级行业、业务范围、大股东名称、大股东持股比例、更新日期;metadata 保留内部字段名和原始数据库列名。",
"data": [
{
"format": "compact_table",
"columns": [
"date",
"value"
],
"rows": [
[
"2024-01-02",
1.23
]
]
}
],
"credits": "按实际返回量计算"
}
}get_stock_market_history行情MCP / HTTP API获取股票或指数历史行情数据。
查看详情
get_stock_market_history行情MCP / HTTP API获取股票或指数历史行情数据。
首次按 ticker 和日期区间查询,并可用 row_limit 指定每页 1-5000 行(默认 1000)。has_more 为 true 时,下一次只传服务端返回的 next_cursor。
| 参数 | 类型 | 必填 | 默认 | 说明 |
|---|---|---|---|---|
| ticker | string | 否 | - | 首次查询必填。证券代码,例如 "000001.SZ"、"AAPL.O"、"0700.HK"。 |
| start_date | string | 否 | - | 开始日期,格式 YYYY-MM-DD。 |
| end_date | string | 否 | - | 结束日期,格式 YYYY-MM-DD。 |
| data_type | string | 否 | - | 数据类型,可选 "A股"、"美股"、"港股"、"指数"。 |
| row_limit | integer | 否 | 1000 | 首次查询每页返回行数,范围 1-5000;续页时由 cursor 固化。 |
| cursor | string | 否 | - | 续页时传上一页的 next_cursor;使用 cursor 时不要再传其它查询参数。 |
| 返回字段 | 类型 | 说明 |
|---|---|---|
| tool | string | 本次调用的工具名。 |
| arguments | object | 服务端校验后实际执行的参数。 |
| result.message | string | 本次工具调用的结果摘要。 |
| result.data[] | object[] | 一个或多个结构化结果集。 |
| result.data[].format | string | 结果集格式;表格结果通常为 "compact_table"。 |
| result.data[].columns | string[] | 表格列名,按 rows 中每行的值顺序排列。 |
| result.data[].rows | array[] | 二维数组形式的数据行,避免每行重复字段名。 |
| result.metadata.pagination.returned_rows | integer | 本页实际返回的数据行数。 |
| result.metadata.pagination.row_limit | integer | 本次分页固定的每页行数。 |
| result.metadata.pagination.has_more | boolean | 是否还有下一页。 |
| result.metadata.pagination.next_cursor | string | null | 下一页 cursor;has_more 为 true 时,下一次请求只传此值到 cursor。 |
| result.credits | string | 额度计算说明;实际扣费以调用日志记录为准。 |
返回 compact_table 结构的历史行情行;顶层 metadata.pagination 包含 returned_rows、row_limit、has_more 和 next_cursor。
{
"arguments": {
"ticker": "000001.SZ",
"start_date": "2024-01-01",
"end_date": "2024-01-31",
"data_type": "A股",
"row_limit": 1000
}
}{
"tool": "get_stock_market_history",
"arguments": {
"ticker": "000001.SZ",
"start_date": "2024-01-01",
"end_date": "2024-01-31",
"data_type": "A股",
"row_limit": 1000
},
"result": {
"message": "返回 compact_table 结构的历史行情行;顶层 metadata.pagination 包含 returned_rows、row_limit、has_more 和 next_cursor。",
"data": [
{
"format": "compact_table",
"columns": [
"date",
"value"
],
"rows": [
[
"2024-01-02",
1.23
]
]
}
],
"credits": "按实际返回量计算",
"metadata": {
"pagination": {
"returned_rows": 1,
"row_limit": 1000,
"has_more": false,
"next_cursor": null
}
}
}
}get_futures_market_history期货MCP / HTTP API获取期货、现货指数或国债期货主连的历史行情。
查看详情
get_futures_market_history期货MCP / HTTP API获取期货、现货指数或国债期货主连的历史行情。
按代码和日期区间查询开高低收、成交量、持仓量与结算价;主力连续还会返回每天对应的实际合约。不传日期时默认查询最近 30 天。
| 参数 | 类型 | 必填 | 默认 | 说明 |
|---|---|---|---|---|
| ticker | string | 是 | - | 期货代码,例如 "ZNZL.SHF"(沪锌主力连续)、"ZN2408.SHF"(具体合约)、"AU9999.SHG"(现货指数)或 "TZL.CFE"(十债主连)。 |
| start_date | string | 否 | - | 开始日期,格式 YYYY-MM-DD。 |
| end_date | string | 否 | - | 结束日期,格式 YYYY-MM-DD。 |
| 返回字段 | 类型 | 说明 |
|---|---|---|
| tool | string | 本次调用的工具名。 |
| arguments | object | 服务端校验后实际执行的参数。 |
| result.message | string | 本次工具调用的结果摘要。 |
| result.data[] | object[] | 一个或多个结构化结果集。 |
| result.data[].format | string | 结果集格式;表格结果通常为 "compact_table"。 |
| result.data[].columns | string[] | 表格列名,按 rows 中每行的值顺序排列。 |
| result.data[].rows | array[] | 二维数组形式的数据行,避免每行重复字段名。 |
| result.credits | string | 额度计算说明;实际扣费以调用日志记录为准。 |
返回 compact_table 结构的期货行情,包含 OHLC、成交量、成交额、持仓量、结算价、前收盘、前结算、主力实际合约、涨跌额和涨跌幅,并附品种单位与合约类别元数据。
{
"arguments": {
"ticker": "ZNZL.SHF",
"start_date": "2026-04-01",
"end_date": "2026-07-22"
}
}{
"tool": "get_futures_market_history",
"arguments": {
"ticker": "ZNZL.SHF",
"start_date": "2026-04-01",
"end_date": "2026-07-22"
},
"result": {
"message": "返回 compact_table 结构的期货行情,包含 OHLC、成交量、成交额、持仓量、结算价、前收盘、前结算、主力实际合约、涨跌额和涨跌幅,并附品种单位与合约类别元数据。",
"data": [
{
"format": "compact_table",
"columns": [
"date",
"value"
],
"rows": [
[
"2024-01-02",
1.23
]
]
}
],
"credits": "按实际返回量计算"
}
}get_futures_rolling_map期货MCP / HTTP API获取主力连续合约的换月映射历史。
查看详情
get_futures_rolling_map期货MCP / HTTP API获取主力连续合约的换月映射历史。
查看主力连续每天对应的具体合约及其持仓量,用于识别移仓换月窗口或解释连续行情中的合约切换。不传日期时默认查询最近 30 天。
| 参数 | 类型 | 必填 | 默认 | 说明 |
|---|---|---|---|---|
| zl_code | string | 是 | - | 主力连续代码,例如 "ZNZL.SHF"、"YZL.DCE"。 |
| start_date | string | 否 | - | 开始日期,格式 YYYY-MM-DD。 |
| end_date | string | 否 | - | 结束日期,格式 YYYY-MM-DD。 |
| 返回字段 | 类型 | 说明 |
|---|---|---|
| tool | string | 本次调用的工具名。 |
| arguments | object | 服务端校验后实际执行的参数。 |
| result.message | string | 本次工具调用的结果摘要。 |
| result.data[] | object[] | 一个或多个结构化结果集。 |
| result.data[].format | string | 结果集格式;表格结果通常为 "compact_table"。 |
| result.data[].columns | string[] | 表格列名,按 rows 中每行的值顺序排列。 |
| result.data[].rows | array[] | 二维数组形式的数据行,避免每行重复字段名。 |
| result.credits | string | 额度计算说明;实际扣费以调用日志记录为准。 |
返回日期、主力连续代码、当天对应的具体合约及其持仓量。
{
"arguments": {
"zl_code": "YZL.DCE",
"start_date": "2026-01-01",
"end_date": "2026-07-22"
}
}{
"tool": "get_futures_rolling_map",
"arguments": {
"zl_code": "YZL.DCE",
"start_date": "2026-01-01",
"end_date": "2026-07-22"
},
"result": {
"message": "返回日期、主力连续代码、当天对应的具体合约及其持仓量。",
"data": [
{
"format": "compact_table",
"columns": [
"date",
"value"
],
"rows": [
[
"2024-01-02",
1.23
]
]
}
],
"credits": "按实际返回量计算"
}
}get_futures_basis期货MCP / HTTP API获取期货品种的现货基差历史。
查看详情
get_futures_basis期货MCP / HTTP API获取期货品种的现货基差历史。
按品种代码查询现货参考价、期货价格、基差和基差比率,并返回品种中文名与现货腿口径。不传日期时默认查询最近 365 天。
| 参数 | 类型 | 必填 | 默认 | 说明 |
|---|---|---|---|---|
| pair | string | 是 | - | 期货品种代码,例如 "Y"(豆油)、"V"(PVC)、"AU"(黄金)。 |
| start_date | string | 否 | - | 开始日期,格式 YYYY-MM-DD。 |
| end_date | string | 否 | - | 结束日期,格式 YYYY-MM-DD。 |
| 返回字段 | 类型 | 说明 |
|---|---|---|
| tool | string | 本次调用的工具名。 |
| arguments | object | 服务端校验后实际执行的参数。 |
| result.message | string | 本次工具调用的结果摘要。 |
| result.data[] | object[] | 一个或多个结构化结果集。 |
| result.data[].format | string | 结果集格式;表格结果通常为 "compact_table"。 |
| result.data[].columns | string[] | 表格列名,按 rows 中每行的值顺序排列。 |
| result.data[].rows | array[] | 二维数组形式的数据行,避免每行重复字段名。 |
| result.credits | string | 额度计算说明;实际扣费以调用日志记录为准。 |
返回现货腿、期货腿、两腿价格、基差 value 和基差比率 basis_ratio;metadata 包含品种中文名和现货口径说明。
{
"arguments": {
"pair": "AU",
"start_date": "2025-07-22",
"end_date": "2026-07-22"
}
}{
"tool": "get_futures_basis",
"arguments": {
"pair": "AU",
"start_date": "2025-07-22",
"end_date": "2026-07-22"
},
"result": {
"message": "返回现货腿、期货腿、两腿价格、基差 value 和基差比率 basis_ratio;metadata 包含品种中文名和现货口径说明。",
"data": [
{
"format": "compact_table",
"columns": [
"date",
"value"
],
"rows": [
[
"2024-01-02",
1.23
]
]
}
],
"credits": "按实际返回量计算"
}
}get_futures_calendar_spread期货MCP / HTTP API获取期货品种的近远月跨期价差。
查看详情
get_futures_calendar_spread期货MCP / HTTP API获取期货品种的近远月跨期价差。
按品种代码查询近月、远月合约价格及两者价差,用于观察期限结构变化。不传日期时默认查询最近 365 天。
| 参数 | 类型 | 必填 | 默认 | 说明 |
|---|---|---|---|---|
| pair | string | 是 | - | 期货品种代码,例如 "Y"(豆油)、"V"(PVC)、"AU"(黄金)。 |
| start_date | string | 否 | - | 开始日期,格式 YYYY-MM-DD。 |
| end_date | string | 否 | - | 结束日期,格式 YYYY-MM-DD。 |
| 返回字段 | 类型 | 说明 |
|---|---|---|
| tool | string | 本次调用的工具名。 |
| arguments | object | 服务端校验后实际执行的参数。 |
| result.message | string | 本次工具调用的结果摘要。 |
| result.data[] | object[] | 一个或多个结构化结果集。 |
| result.data[].format | string | 结果集格式;表格结果通常为 "compact_table"。 |
| result.data[].columns | string[] | 表格列名,按 rows 中每行的值顺序排列。 |
| result.data[].rows | array[] | 二维数组形式的数据行,避免每行重复字段名。 |
| result.credits | string | 额度计算说明;实际扣费以调用日志记录为准。 |
返回近月合约、远月合约、两腿价格、跨期价差 value 和价差比率 basis_ratio;跨期价差口径为近月价格减远月价格。
{
"arguments": {
"pair": "Y",
"start_date": "2025-07-22",
"end_date": "2026-07-22"
}
}{
"tool": "get_futures_calendar_spread",
"arguments": {
"pair": "Y",
"start_date": "2025-07-22",
"end_date": "2026-07-22"
},
"result": {
"message": "返回近月合约、远月合约、两腿价格、跨期价差 value 和价差比率 basis_ratio;跨期价差口径为近月价格减远月价格。",
"data": [
{
"format": "compact_table",
"columns": [
"date",
"value"
],
"rows": [
[
"2024-01-02",
1.23
]
]
}
],
"credits": "按实际返回量计算"
}
}get_stock_valuation_history估值MCP / HTTP API获取股票或指数历史估值数据。
查看详情
get_stock_valuation_history估值MCP / HTTP API获取股票或指数历史估值数据。
首次查询 PE、PB、PS、分位数、股息率等字段,并可用 row_limit 指定每页 1-5000 行(默认 1000)。has_more 为 true 时,下一次只传 next_cursor。
| 参数 | 类型 | 必填 | 默认 | 说明 |
|---|---|---|---|---|
| ticker | string | 否 | - | 首次查询必填。证券代码,例如 "000001.SZ"、"AAPL.O"、"0700.HK"。 |
| start_date | string | 否 | - | 开始日期,格式 YYYY-MM-DD。 |
| end_date | string | 否 | - | 结束日期,格式 YYYY-MM-DD。 |
| data_type | string | 否 | - | 数据类型,可选 "A股"、"美股"、"港股"、"指数"。 |
| row_limit | integer | 否 | 1000 | 首次查询每页返回行数,范围 1-5000;续页时由 cursor 固化。 |
| cursor | string | 否 | - | 续页时传上一页的 next_cursor;使用 cursor 时不要再传其它查询参数。 |
| 返回字段 | 类型 | 说明 |
|---|---|---|
| tool | string | 本次调用的工具名。 |
| arguments | object | 服务端校验后实际执行的参数。 |
| result.message | string | 本次工具调用的结果摘要。 |
| result.data[] | object[] | 一个或多个结构化结果集。 |
| result.data[].format | string | 结果集格式;表格结果通常为 "compact_table"。 |
| result.data[].columns | string[] | 表格列名,按 rows 中每行的值顺序排列。 |
| result.data[].rows | array[] | 二维数组形式的数据行,避免每行重复字段名。 |
| result.metadata.pagination.returned_rows | integer | 本页实际返回的数据行数。 |
| result.metadata.pagination.row_limit | integer | 本次分页固定的每页行数。 |
| result.metadata.pagination.has_more | boolean | 是否还有下一页。 |
| result.metadata.pagination.next_cursor | string | null | 下一页 cursor;has_more 为 true 时,下一次请求只传此值到 cursor。 |
| result.credits | string | 额度计算说明;实际扣费以调用日志记录为准。 |
返回 compact_table 结构的估值历史行;顶层 metadata.pagination 包含 returned_rows、row_limit、has_more 和 next_cursor。
{
"arguments": {
"ticker": "000001.SZ",
"start_date": "2024-01-01",
"end_date": "2024-01-31",
"data_type": "A股",
"row_limit": 1000
}
}{
"tool": "get_stock_valuation_history",
"arguments": {
"ticker": "000001.SZ",
"start_date": "2024-01-01",
"end_date": "2024-01-31",
"data_type": "A股",
"row_limit": 1000
},
"result": {
"message": "返回 compact_table 结构的估值历史行;顶层 metadata.pagination 包含 returned_rows、row_limit、has_more 和 next_cursor。",
"data": [
{
"format": "compact_table",
"columns": [
"date",
"value"
],
"rows": [
[
"2024-01-02",
1.23
]
]
}
],
"credits": "按实际返回量计算",
"metadata": {
"pagination": {
"returned_rows": 1,
"row_limit": 1000,
"has_more": false,
"next_cursor": null
}
}
}
}get_index_components指数MCP / HTTP API通过指数代码获取指数成份股。
查看详情
get_index_components指数MCP / HTTP API通过指数代码获取指数成份股。
输入指数代码,返回当前可用的成份股列表、权重和成份日期。
| 参数 | 类型 | 必填 | 默认 | 说明 |
|---|---|---|---|---|
| index_code | string | 是 | - | 指数代码,例如 "000300.SH"、"000905.SH"、"399001.SZ"。 |
| as_of_date | string | 否 | - | 查询日期,格式 YYYY-MM-DD;不传默认为当前日期。 |
| 返回字段 | 类型 | 说明 |
|---|---|---|
| tool | string | 本次调用的工具名。 |
| arguments | object | 服务端校验后实际执行的参数。 |
| result.message | string | 本次工具调用的结果摘要。 |
| result.data[] | object[] | 一个或多个结构化结果集。 |
| result.data[].format | string | 结果集格式;表格结果通常为 "compact_table"。 |
| result.data[].columns | string[] | 表格列名,按 rows 中每行的值顺序排列。 |
| result.data[].rows | array[] | 二维数组形式的数据行,避免每行重复字段名。 |
| result.credits | string | 额度计算说明;实际扣费以调用日志记录为准。 |
返回 compact_table 结构的成份股列表,字段包含 trade_code、weight、component_date。
{
"arguments": {
"index_code": "000300.SH",
"as_of_date": "2026-05-28"
}
}{
"tool": "get_index_components",
"arguments": {
"index_code": "000300.SH",
"as_of_date": "2026-05-28"
},
"result": {
"message": "返回 compact_table 结构的成份股列表,字段包含 trade_code、weight、component_date。",
"data": [
{
"format": "compact_table",
"columns": [
"date",
"value"
],
"rows": [
[
"2024-01-02",
1.23
]
]
}
],
"credits": "按实际返回量计算"
}
}get_macro_data宏观MCP / HTTP API获取宏观指标历史数据。
查看详情
get_macro_data宏观MCP / HTTP API获取宏观指标历史数据。
先用 search_code 确认指标代码。首次按日期区间查询,并可用 row_limit 指定每页 1-5000 行(默认 1000);has_more 为 true 时,下一次只传 next_cursor。
| 参数 | 类型 | 必填 | 默认 | 说明 |
|---|---|---|---|---|
| ticker | string | 否 | - | 首次查询必填。宏观指标代码,例如 "M0001385"(M2:同比)。 |
| start_date | string | 否 | - | 开始日期,格式 YYYY-MM-DD。 |
| end_date | string | 否 | - | 结束日期,格式 YYYY-MM-DD。 |
| row_limit | integer | 否 | 1000 | 首次查询每页返回行数,范围 1-5000;续页时由 cursor 固化。 |
| cursor | string | 否 | - | 续页时传上一页的 next_cursor;使用 cursor 时不要再传其它查询参数。 |
| 返回字段 | 类型 | 说明 |
|---|---|---|
| tool | string | 本次调用的工具名。 |
| arguments | object | 服务端校验后实际执行的参数。 |
| result.message | string | 本次工具调用的结果摘要。 |
| result.data[] | object[] | 一个或多个结构化结果集。 |
| result.data[].format | string | 结果集格式;表格结果通常为 "compact_table"。 |
| result.data[].columns | string[] | 表格列名,按 rows 中每行的值顺序排列。 |
| result.data[].rows | array[] | 二维数组形式的数据行,避免每行重复字段名。 |
| result.metadata.pagination.returned_rows | integer | 本页实际返回的数据行数。 |
| result.metadata.pagination.row_limit | integer | 本次分页固定的每页行数。 |
| result.metadata.pagination.has_more | boolean | 是否还有下一页。 |
| result.metadata.pagination.next_cursor | string | null | 下一页 cursor;has_more 为 true 时,下一次请求只传此值到 cursor。 |
| result.credits | string | 额度计算说明;实际扣费以调用日志记录为准。 |
返回观测日期和数值;顶层 metadata.pagination 包含 returned_rows、row_limit、has_more 和 next_cursor,结果集 metadata 仍包含指标口径信息。
{
"arguments": {
"ticker": "M0001385",
"start_date": "2020-01-01",
"end_date": "2024-12-31",
"row_limit": 1000
}
}{
"tool": "get_macro_data",
"arguments": {
"ticker": "M0001385",
"start_date": "2020-01-01",
"end_date": "2024-12-31",
"row_limit": 1000
},
"result": {
"message": "返回观测日期和数值;顶层 metadata.pagination 包含 returned_rows、row_limit、has_more 和 next_cursor,结果集 metadata 仍包含指标口径信息。",
"data": [
{
"format": "compact_table",
"columns": [
"date",
"value"
],
"rows": [
[
"2024-01-02",
1.23
]
]
}
],
"credits": "按实际返回量计算",
"metadata": {
"pagination": {
"returned_rows": 1,
"row_limit": 1000,
"has_more": false,
"next_cursor": null
}
}
}
}get_financial_data财务MCP / HTTP API获取股票财务报表与核心财务字段。
查看详情
get_financial_data财务MCP / HTTP API获取股票财务报表与核心财务字段。
支持按报告日期、财年、年报口径过滤,也可请求白名单扩展字段。需要每个字段的币种、单位、口径和披露日期等业务语义元数据时用 data_type=full;需要按产品和地区的主营收入拆解时用 data_type=segment(仅 A股)。
| 参数 | 类型 | 必填 | 默认 | 说明 |
|---|---|---|---|---|
| ticker | string | 是 | - | 股票代码,例如 "000001.SZ"、"AAPL.O"、"0700.HK"。 |
| periods | integer | 否 | 8 | 返回期数,范围 1-500。 |
| data_type | string | 否 | all | "all"、"balance_sheet"、"income_statement"、"cash_flow"、"key_metrics"、"full"(财务表全字段并注入每字段币种、单位、口径和披露日期等业务语义元数据)、"segment"(主营构成:按产品、按地区和海外业务的收入拆解,仅 A股,返回全量字段并注入元数据)。 |
| market_type | string | 否 | - | 市场类型,可选 "A股"、"美股"、"港股"。 |
| start_date | string | 否 | - | 按报告日期 DT 过滤的开始日期,格式 YYYY-MM-DD。 |
| end_date | string | 否 | - | 按报告日期 DT 过滤的结束日期,格式 YYYY-MM-DD。 |
| fiscal_year | integer | 否 | - | 指定单个财年,按 DT 年份过滤。 |
| start_year | integer | 否 | - | 起始财年,按 DT 年份过滤。 |
| end_year | integer | 否 | - | 结束财年,按 DT 年份过滤。 |
| annual_only | boolean | 否 | false | 是否只返回年报日期 12-31。 |
| extra_fields | string | 否 | - | 额外字段白名单,当前支持 "holder_pct_by_fund"。 |
| 返回字段 | 类型 | 说明 |
|---|---|---|
| tool | string | 本次调用的工具名。 |
| arguments | object | 服务端校验后实际执行的参数。 |
| result.message | string | 本次工具调用的结果摘要。 |
| result.data[] | object[] | 一个或多个结构化结果集。 |
| result.data[].format | string | 结果集格式;表格结果通常为 "compact_table"。 |
| result.data[].columns | string[] | 表格列名,按 rows 中每行的值顺序排列。 |
| result.data[].rows | array[] | 二维数组形式的数据行,避免每行重复字段名。 |
| result.credits | string | 额度计算说明;实际扣费以调用日志记录为准。 |
返回财务结果集,包含报告日期、字段值和对应口径;data_type=full 或 segment 时额外在 metadata 中返回每字段的币种、单位、口径说明和披露日期。
{
"arguments": {
"ticker": "000001.SZ",
"data_type": "income_statement",
"periods": 8,
"annual_only": true
}
}{
"tool": "get_financial_data",
"arguments": {
"ticker": "000001.SZ",
"data_type": "income_statement",
"periods": 8,
"annual_only": true
},
"result": {
"message": "返回财务结果集,包含报告日期、字段值和对应口径;data_type=full 或 segment 时额外在 metadata 中返回每字段的币种、单位、口径说明和披露日期。",
"data": [
{
"format": "compact_table",
"columns": [
"date",
"value"
],
"rows": [
[
"2024-01-02",
1.23
]
]
}
],
"credits": "按实际返回量计算"
}
}get_stock_forecast_history预测MCP / HTTP API获取 A股股票一致预期历史。
查看详情
get_stock_forecast_history预测MCP / HTTP API获取 A股股票一致预期历史。
查询 FY1/FY2 收入、利润,以及同日可用的分歧度字段。
| 参数 | 类型 | 必填 | 默认 | 说明 |
|---|---|---|---|---|
| ticker | string | 是 | - | A股股票代码,例如 "000001.SZ"。 |
| start_date | string | 否 | - | 开始日期,格式 YYYY-MM-DD。 |
| end_date | string | 否 | - | 结束日期,格式 YYYY-MM-DD。 |
| limit | integer | 否 | 120 | 返回行数上限,范围 1-1000。 |
| market_type | string | 否 | - | 市场类型;当前仅支持 "A股"。 |
| 返回字段 | 类型 | 说明 |
|---|---|---|
| tool | string | 本次调用的工具名。 |
| arguments | object | 服务端校验后实际执行的参数。 |
| result.message | string | 本次工具调用的结果摘要。 |
| result.data[] | object[] | 一个或多个结构化结果集。 |
| result.data[].format | string | 结果集格式;表格结果通常为 "compact_table"。 |
| result.data[].columns | string[] | 表格列名,按 rows 中每行的值顺序排列。 |
| result.data[].rows | array[] | 二维数组形式的数据行,避免每行重复字段名。 |
| result.credits | string | 额度计算说明;实际扣费以调用日志记录为准。 |
返回预测历史行;没有同日分歧度记录时不返回对应 std 字段。
{
"arguments": {
"ticker": "000001.SZ",
"start_date": "2024-01-01",
"end_date": "2024-12-31",
"limit": 120
}
}{
"tool": "get_stock_forecast_history",
"arguments": {
"ticker": "000001.SZ",
"start_date": "2024-01-01",
"end_date": "2024-12-31",
"limit": 120
},
"result": {
"message": "返回预测历史行;没有同日分歧度记录时不返回对应 std 字段。",
"data": [
{
"format": "compact_table",
"columns": [
"date",
"value"
],
"rows": [
[
"2024-01-02",
1.23
]
]
}
],
"credits": "按实际返回量计算"
}
}get_financial_ratios财务MCP / HTTP API计算并获取核心财务比率。
查看详情
get_financial_ratios财务MCP / HTTP API计算并获取核心财务比率。
查询 ROE、ROA、毛利率、净利率、资产负债率等指标。
| 参数 | 类型 | 必填 | 默认 | 说明 |
|---|---|---|---|---|
| ticker | string | 是 | - | 股票代码,例如 "000001.SZ"、"AAPL.O"、"0700.HK"。 |
| periods | integer | 否 | 4 | 返回期数,范围 1-40。 |
| market_type | string | 否 | - | 市场类型,可选 "A股"、"美股"、"港股"。 |
| end_date | string | 否 | - | 锚点日期,格式 YYYY-MM-DD;返回不晚于该日期的最近 periods 期。 |
| 返回字段 | 类型 | 说明 |
|---|---|---|
| tool | string | 本次调用的工具名。 |
| arguments | object | 服务端校验后实际执行的参数。 |
| result.message | string | 本次工具调用的结果摘要。 |
| result.data[] | object[] | 一个或多个结构化结果集。 |
| result.data[].format | string | 结果集格式;表格结果通常为 "compact_table"。 |
| result.data[].columns | string[] | 表格列名,按 rows 中每行的值顺序排列。 |
| result.data[].rows | array[] | 二维数组形式的数据行,避免每行重复字段名。 |
| result.credits | string | 额度计算说明;实际扣费以调用日志记录为准。 |
返回按报告期排列的财务比率数据。
{
"arguments": {
"ticker": "000001.SZ",
"periods": 4,
"market_type": "A股"
}
}{
"tool": "get_financial_ratios",
"arguments": {
"ticker": "000001.SZ",
"periods": 4,
"market_type": "A股"
},
"result": {
"message": "返回按报告期排列的财务比率数据。",
"data": [
{
"format": "compact_table",
"columns": [
"date",
"value"
],
"rows": [
[
"2024-01-02",
1.23
]
]
}
],
"credits": "按实际返回量计算"
}
}get_financial_growth财务MCP / HTTP API获取财务指标增长率。
查看详情
get_financial_growth财务MCP / HTTP API获取财务指标增长率。
用于追踪营收、净利润、总资产、权益等增长趋势。
| 参数 | 类型 | 必填 | 默认 | 说明 |
|---|---|---|---|---|
| ticker | string | 是 | - | 股票代码,例如 "000001.SZ"、"AAPL.O"、"0700.HK"。 |
| periods | integer | 否 | 8 | 返回期数,范围 1-40。 |
| market_type | string | 否 | - | 市场类型,可选 "A股"、"美股"、"港股"。 |
| 返回字段 | 类型 | 说明 |
|---|---|---|
| tool | string | 本次调用的工具名。 |
| arguments | object | 服务端校验后实际执行的参数。 |
| result.message | string | 本次工具调用的结果摘要。 |
| result.data[] | object[] | 一个或多个结构化结果集。 |
| result.data[].format | string | 结果集格式;表格结果通常为 "compact_table"。 |
| result.data[].columns | string[] | 表格列名,按 rows 中每行的值顺序排列。 |
| result.data[].rows | array[] | 二维数组形式的数据行,避免每行重复字段名。 |
| result.credits | string | 额度计算说明;实际扣费以调用日志记录为准。 |
返回按报告期排列的增长率数据。
{
"arguments": {
"ticker": "000001.SZ",
"periods": 8,
"market_type": "A股"
}
}{
"tool": "get_financial_growth",
"arguments": {
"ticker": "000001.SZ",
"periods": 8,
"market_type": "A股"
},
"result": {
"message": "返回按报告期排列的增长率数据。",
"data": [
{
"format": "compact_table",
"columns": [
"date",
"value"
],
"rows": [
[
"2024-01-02",
1.23
]
]
}
],
"credits": "按实际返回量计算"
}
}screen_stocks选股MCP / HTTP APIA股多指标组合选股。
查看详情
screen_stocks选股MCP / HTTP APIA股多指标组合选股。
传入行业、指标列表、上下限和时间位移,筛选满足条件的股票;结果默认最新季度在前,并回填筛选指标值。
| 参数 | 类型 | 必填 | 默认 | 说明 |
|---|---|---|---|---|
| industry | string | 是 | - | 申万一级行业名称,例如 "电子";传 "全部" 表示全市场。 |
| ind_list | string[] | 是 | - | 指标名称列表,例如 ["roe", "net_profit_yoy"]。 |
| lower_list | number[] | 是 | - | 每个指标下限,与 ind_list 一一对应。 |
| upper_list | number[] | 是 | - | 每个指标上限,与 ind_list 一一对应。 |
| time_zone_list | integer[] | 是 | - | 每个指标的时间位移;0 表示当前,N 表示未来 N 年。 |
| limit | integer | 否 | 50 | 返回记录数上限,范围 1-500。 |
| latest_only | boolean | 否 | false | 为 true 时每只股票只保留最近一个满足条件的季度。 |
| 返回字段 | 类型 | 说明 |
|---|---|---|
| tool | string | 本次调用的工具名。 |
| arguments | object | 服务端校验后实际执行的参数。 |
| result.message | string | 本次工具调用的结果摘要。 |
| result.data[] | object[] | 一个或多个结构化结果集。 |
| result.data[].format | string | 结果集格式;表格结果通常为 "compact_table"。 |
| result.data[].columns | string[] | 表格列名,按 rows 中每行的值顺序排列。 |
| result.data[].rows | array[] | 二维数组形式的数据行,避免每行重复字段名。 |
| result.credits | string | 额度计算说明;实际扣费以调用日志记录为准。 |
返回满足条件的 A股标的、命中季度和指标值;metadata 中包含排序口径、latest_only 和指标取值口径。
{
"arguments": {
"industry": "全部",
"ind_list": [
"roe",
"net_profit_yoy"
],
"lower_list": [
10,
20
],
"upper_list": [
100,
200
],
"time_zone_list": [
0,
0
],
"limit": 50,
"latest_only": true
}
}{
"tool": "screen_stocks",
"arguments": {
"industry": "全部",
"ind_list": [
"roe",
"net_profit_yoy"
],
"lower_list": [
10,
20
],
"upper_list": [
100,
200
],
"time_zone_list": [
0,
0
],
"limit": 50,
"latest_only": true
},
"result": {
"message": "返回满足条件的 A股标的、命中季度和指标值;metadata 中包含排序口径、latest_only 和指标取值口径。",
"data": [
{
"format": "compact_table",
"columns": [
"date",
"value"
],
"rows": [
[
"2024-01-02",
1.23
]
]
}
],
"credits": "按实际返回量计算"
}
}list_indicators选股MCP / HTTP API列出 screen_stocks 可用指标。
查看详情
list_indicators选股MCP / HTTP API列出 screen_stocks 可用指标。
构造 screen_stocks 条件前,先查看可用指标名称和解释。
| 返回字段 | 类型 | 说明 |
|---|---|---|
| tool | string | 本次调用的工具名。 |
| arguments | object | 服务端校验后实际执行的参数。 |
| result | string | 文本结果,包含检索摘要、匹配片段、指标说明或策略分析。 |
返回可用于多指标选股的指标名称和说明。
{
"arguments": {}
}{
"tool": "list_indicators",
"arguments": {},
"result": "返回文本摘要、匹配片段或指标说明。"
}get_stock_excess_return收益MCP / HTTP API计算 A股个股相对申万行业指数的超额收益。
查看详情
get_stock_excess_return收益MCP / HTTP API计算 A股个股相对申万行业指数的超额收益。
用于观察个股相对行业基准在一段时间内的收益表现。
| 参数 | 类型 | 必填 | 默认 | 说明 |
|---|---|---|---|---|
| ticker | string | 是 | - | A股股票代码,例如 "000001.SZ"。 |
| date_benchmark | string | 是 | - | 基准日期,格式 YYYY-MM-DD。 |
| days | integer | 否 | 250 | 统计天数,范围 1-1000。 |
| 返回字段 | 类型 | 说明 |
|---|---|---|
| tool | string | 本次调用的工具名。 |
| arguments | object | 服务端校验后实际执行的参数。 |
| result.message | string | 本次工具调用的结果摘要。 |
| result.data[] | object[] | 一个或多个结构化结果集。 |
| result.data[].format | string | 结果集格式;表格结果通常为 "compact_table"。 |
| result.data[].columns | string[] | 表格列名,按 rows 中每行的值顺序排列。 |
| result.data[].rows | array[] | 二维数组形式的数据行,避免每行重复字段名。 |
| result.credits | string | 额度计算说明;实际扣费以调用日志记录为准。 |
返回个股收益、行业基准收益和超额收益。
{
"arguments": {
"ticker": "000001.SZ",
"date_benchmark": "2024-01-01",
"days": 250
}
}{
"tool": "get_stock_excess_return",
"arguments": {
"ticker": "000001.SZ",
"date_benchmark": "2024-01-01",
"days": 250
},
"result": {
"message": "返回个股收益、行业基准收益和超额收益。",
"data": [
{
"format": "compact_table",
"columns": [
"date",
"value"
],
"rows": [
[
"2024-01-02",
1.23
]
]
}
],
"credits": "按实际返回量计算"
}
}search_us_transcript文本检索MCP / HTTP API美股电话会、业绩会和管理层指引检索。
查看详情
search_us_transcript文本检索MCP / HTTP API美股电话会、业绩会和管理层指引检索。
用户提到“美股电话会”“earnings call”“业绩会”时首选;明确要求A股官方IR或管理层原话时用 search_cn_transcript;研究产业细节,或泛称纪要、调研、专家交流、小作文、渠道反馈时用 search_field_notes。默认 matched 模式只返回命中句及上下文窗口。
| 参数 | 类型 | 必填 | 默认 | 说明 |
|---|---|---|---|---|
| keyword | string | 是 | - | 搜索关键词,例如 "Apple"、"AAPL"。 |
| limit | integer | 否 | 10 | 返回结果数量,范围 1-100。 |
| content_mode | string | 否 | matched | 内容返回模式:matched 返回命中句及上下文窗口;full 返回完整纪要正文。 |
| 返回字段 | 类型 | 说明 |
|---|---|---|
| tool | string | 本次调用的工具名。 |
| arguments | object | 服务端校验后实际执行的参数。 |
| result.message | string | 本次工具调用的结果摘要。 |
| result.data[] | object[] | 一个或多个结构化结果集。 |
| result.data[].format | string | 结果集格式;表格结果通常为 "compact_table"。 |
| result.data[].columns | string[] | 表格列名,按 rows 中每行的值顺序排列。 |
| result.data[].rows | array[] | 二维数组形式的数据行,避免每行重复字段名。 |
| result.credits | string | 额度计算说明;实际扣费以调用日志记录为准。 |
返回简短命中摘要,并在结构化结果中提供纪要标识、ticker、公司、文件、日期、相关度和 content_preview;content_mode=full 时 content_preview 为完整纪要正文。
{
"arguments": {
"keyword": "AAPL guidance",
"limit": 3,
"content_mode": "matched"
}
}{
"tool": "search_us_transcript",
"arguments": {
"keyword": "AAPL guidance",
"limit": 3,
"content_mode": "matched"
},
"result": {
"message": "返回简短命中摘要,并在结构化结果中提供纪要标识、ticker、公司、文件、日期、相关度和 content_preview;content_mode=full 时 content_preview 为完整纪要正文。",
"data": [
{
"format": "compact_table",
"columns": [
"date",
"value"
],
"rows": [
[
"2024-01-02",
1.23
]
]
}
],
"credits": "按实际返回量计算"
}
}search_cn_transcript文本检索MCP / HTTP API官方纪要、A股调研纪要和 IR 记录检索。
查看详情
search_cn_transcript文本检索MCP / HTTP API官方纪要、A股调研纪要和 IR 记录检索。
用户明确要求“官方纪要”“A股调研纪要”“IR记录”“投资者关系活动记录”“管理层原话”时首选;研究产业细节,或泛称纪要、调研、专家交流、小作文、渠道反馈时用 search_field_notes;美股电话会用 search_us_transcript。
| 参数 | 类型 | 必填 | 默认 | 说明 |
|---|---|---|---|---|
| keyword | string | 是 | - | 语义搜索关键词,例如 "毛利率下降原因"。 |
| limit | integer | 否 | 10 | 返回结果数量,范围 1-50。 |
| company_name | string | 否 | - | 按公司名称过滤,例如 "宁德"。 |
| stock_code | string | 否 | - | 按股票代码精确过滤,例如 "300750"。 |
| start_date | string | 否 | - | 开始日期,格式 YYYY-MM-DD;传入后按 create_date 硬过滤并关闭时间衰减。 |
| end_date | string | 否 | - | 结束日期,格式 YYYY-MM-DD;传入后按 create_date 硬过滤并关闭时间衰减。 |
| 返回字段 | 类型 | 说明 |
|---|---|---|
| tool | string | 本次调用的工具名。 |
| arguments | object | 服务端校验后实际执行的参数。 |
| result.message | string | 本次工具调用的结果摘要。 |
| result.data[] | object[] | 一个或多个结构化结果集。 |
| result.data[].format | string | 结果集格式;表格结果通常为 "compact_table"。 |
| result.data[].columns | string[] | 表格列名,按 rows 中每行的值顺序排列。 |
| result.data[].rows | array[] | 二维数组形式的数据行,避免每行重复字段名。 |
| result.credits | string | 额度计算说明;实际扣费以调用日志记录为准。 |
返回文本摘要,并在结构化结果中提供股票代码、公司、标题、会议时间、发布时间、相关度和调研内容正文;未传日期范围时使用时间衰减排序。
{
"arguments": {
"keyword": "毛利率下降原因",
"company_name": "宁德",
"start_date": "2022-02-15",
"end_date": "2022-10-13",
"limit": 10
}
}{
"tool": "search_cn_transcript",
"arguments": {
"keyword": "毛利率下降原因",
"company_name": "宁德",
"start_date": "2022-02-15",
"end_date": "2022-10-13",
"limit": 10
},
"result": {
"message": "返回文本摘要,并在结构化结果中提供股票代码、公司、标题、会议时间、发布时间、相关度和调研内容正文;未传日期范围时使用时间衰减排序。",
"data": [
{
"format": "compact_table",
"columns": [
"date",
"value"
],
"rows": [
[
"2024-01-02",
1.23
]
]
}
],
"credits": "按实际返回量计算"
}
}search_chart文本检索MCP / HTTP API图表、趋势图和可视化数据检索。
查看详情
search_chart文本检索MCP / HTTP API图表、趋势图和可视化数据检索。
用户提到“图表”“趋势图”“走势图”时首选;只需结构化数值时用 get_data。拿到图表 ID 后继续查看 chart_settings 并获取真实图表数据。
| 参数 | 类型 | 必填 | 默认 | 说明 |
|---|---|---|---|---|
| keyword | string | 是 | - | 搜索关键词,例如 "GDP增速"、"居民消费"。 |
| limit | integer | 否 | 10 | 返回结果数量,范围 1-100。 |
| 返回字段 | 类型 | 说明 |
|---|---|---|
| tool | string | 本次调用的工具名。 |
| arguments | object | 服务端校验后实际执行的参数。 |
| result.message | string | 本次工具调用的结果摘要。 |
| result.data[] | object[] | 一个或多个结构化结果集。 |
| result.data[].format | string | 结果集格式;表格结果通常为 "compact_table"。 |
| result.data[].columns | string[] | 表格列名,按 rows 中每行的值顺序排列。 |
| result.data[].rows | array[] | 二维数组形式的数据行,避免每行重复字段名。 |
| result.credits | string | 额度计算说明;实际扣费以调用日志记录为准。 |
返回文本摘要,并在结构化结果中提供图表 ID、标题、描述和相关度。
{
"arguments": {
"keyword": "GDP增速",
"limit": 10
}
}{
"tool": "search_chart",
"arguments": {
"keyword": "GDP增速",
"limit": 10
},
"result": {
"message": "返回文本摘要,并在结构化结果中提供图表 ID、标题、描述和相关度。",
"data": [
{
"format": "compact_table",
"columns": [
"date",
"value"
],
"rows": [
[
"2024-01-02",
1.23
]
]
}
],
"credits": "按实际返回量计算"
}
}get_chart_settings文本检索MCP / HTTP API获取 chart_settings(图表渲染参数定义)。
查看详情
get_chart_settings文本检索MCP / HTTP API获取 chart_settings(图表渲染参数定义)。
已知图表 ID 时,先读取 chart_settings。它不是图表数据,而是可传给 get_chart_data.selection_values 的 varname、默认值、候选项和日期约束。
| 参数 | 类型 | 必填 | 默认 | 说明 |
|---|---|---|---|---|
| chart_id | integer | 是 | - | 图表 ID,例如 9258;可先用 search_chart 查找。 |
| include_dynamic_options | boolean | 否 | true | 是否展开 tmpl 类型 chart_settings 的动态候选值。 |
| 返回字段 | 类型 | 说明 |
|---|---|---|
| tool | string | 本次调用的工具名。 |
| arguments | object | 服务端校验后实际执行的参数。 |
| result.message | string | 本次工具调用的结果摘要。 |
| result.data[] | object[] | 一个或多个结构化结果集。 |
| result.data[].format | string | 结果集格式;表格结果通常为 "compact_table"。 |
| result.data[].columns | string[] | 表格列名,按 rows 中每行的值顺序排列。 |
| result.data[].rows | array[] | 二维数组形式的数据行,避免每行重复字段名。 |
| result.credits | string | 额度计算说明;实际扣费以调用日志记录为准。 |
返回 compact_table chart_settings 表,并在顶层 resolved_setting 给出默认选择值。
{
"arguments": {
"chart_id": 9258,
"include_dynamic_options": true
}
}{
"tool": "get_chart_settings",
"arguments": {
"chart_id": 9258,
"include_dynamic_options": true
},
"result": {
"message": "返回 compact_table chart_settings 表,并在顶层 resolved_setting 给出默认选择值。",
"data": [
{
"format": "compact_table",
"columns": [
"date",
"value"
],
"rows": [
[
"2024-01-02",
1.23
]
]
}
],
"credits": "按实际返回量计算"
}
}get_chart_data文本检索MCP / HTTP API按 chart_settings 选择值获取图表数据。
查看详情
get_chart_data文本检索MCP / HTTP API按 chart_settings 选择值获取图表数据。
用 get_chart_settings 确认 chart_settings.varname 后,传入 selection_values 获取对应真实渲染数据。
| 参数 | 类型 | 必填 | 默认 | 说明 |
|---|---|---|---|---|
| chart_id | integer | 是 | - | 图表 ID,例如 9258;可先用 search_chart 查找。 |
| selection_values | object | 否 | - | 选择值,键为 chart_settings.varname,会覆盖默认值。 |
| 返回字段 | 类型 | 说明 |
|---|---|---|
| tool | string | 本次调用的工具名。 |
| arguments | object | 服务端校验后实际执行的参数。 |
| result.message | string | 本次工具调用的结果摘要。 |
| result.data[] | object[] | 一个或多个结构化结果集。 |
| result.data[].format | string | 结果集格式;表格结果通常为 "compact_table"。 |
| result.data[].columns | string[] | 表格列名,按 rows 中每行的值顺序排列。 |
| result.data[].rows | array[] | 二维数组形式的数据行,避免每行重复字段名。 |
| result.credits | string | 额度计算说明;实际扣费以调用日志记录为准。 |
返回 resolved_setting 和 compact_table 数据集。
{
"arguments": {
"chart_id": 9258,
"selection_values": {
"industry": "消费"
}
}
}{
"tool": "get_chart_data",
"arguments": {
"chart_id": 9258,
"selection_values": {
"industry": "消费"
}
},
"result": {
"message": "返回 resolved_setting 和 compact_table 数据集。",
"data": [
{
"format": "compact_table",
"columns": [
"date",
"value"
],
"rows": [
[
"2024-01-02",
1.23
]
]
}
],
"credits": "按实际返回量计算"
}
}search_field_notes文本检索MCP / HTTP API纪要、调研、专家交流和产业细节检索。
查看详情
search_field_notes文本检索MCP / HTTP API纪要、调研、专家交流和产业细节检索。
用户需要研究产业细节,或提到“纪要”“调研”“专家交流”“小作文”“渠道反馈”时首选;明确要求“A股官方IR记录”“投资者关系活动记录”或“管理层原话”时用 search_cn_transcript,美股电话会用 search_us_transcript,宏观/海外公开新闻用 search_news。材料来源类型不一,可信度应结合具体出处判断。
| 参数 | 类型 | 必填 | 默认 | 说明 |
|---|---|---|---|---|
| keyword | string | 是 | - | 全文搜索关键词,例如 "HBM"、"磷化铟"、"水泥 需求 价格"。 |
| limit | integer | 否 | 10 | 返回结果数量,范围 1-50。 |
| start_date | string | 否 | - | 按文档发布时间筛选的开始日期,格式 YYYY-MM-DD。 |
| end_date | string | 否 | - | 按文档发布时间筛选的结束日期,格式 YYYY-MM-DD。 |
| 返回字段 | 类型 | 说明 |
|---|---|---|
| tool | string | 本次调用的工具名。 |
| arguments | object | 服务端校验后实际执行的参数。 |
| result.message | string | 本次工具调用的结果摘要。 |
| result.data[] | object[] | 一个或多个结构化结果集。 |
| result.data[].format | string | 结果集格式;表格结果通常为 "compact_table"。 |
| result.data[].columns | string[] | 表格列名,按 rows 中每行的值顺序排列。 |
| result.data[].rows | array[] | 二维数组形式的数据行,避免每行重复字段名。 |
| result.credits | string | 额度计算说明;实际扣费以调用日志记录为准。 |
返回 doc_id、doc_type、标题和摘要;用 get_field_note 获取全文和出处。doc_type 中 signal 表示市场变化信号,post 表示调研小作文/转述纪要,telegraph 表示快讯电报,article 表示弘则研报或文章。metadata 会返回日期范围并标记是否触发宽松 fallback。
{
"arguments": {
"keyword": "水泥 需求 价格",
"limit": 10,
"start_date": "2026-07-01",
"end_date": "2026-07-27"
}
}{
"tool": "search_field_notes",
"arguments": {
"keyword": "水泥 需求 价格",
"limit": 10,
"start_date": "2026-07-01",
"end_date": "2026-07-27"
},
"result": {
"message": "返回 doc_id、doc_type、标题和摘要;用 get_field_note 获取全文和出处。doc_type 中 signal 表示市场变化信号,post 表示调研小作文/转述纪要,telegraph 表示快讯电报,article 表示弘则研报或文章。metadata 会返回日期范围并标记是否触发宽松 fallback。",
"data": [
{
"format": "compact_table",
"columns": [
"date",
"value"
],
"rows": [
[
"2024-01-02",
1.23
]
]
}
],
"credits": "按实际返回量计算"
}
}get_field_note文本检索MCP / HTTP API获取纪要、小作文或投研资讯全文。
查看详情
get_field_note文本检索MCP / HTTP API获取纪要、小作文或投研资讯全文。
已从 search_field_notes 拿到 doc_id,且用户要求“看全文”“打开原文”时使用;返回正文、来源、标签、实体、要点和 doc_type 说明。
| 参数 | 类型 | 必填 | 默认 | 说明 |
|---|---|---|---|---|
| doc_id | integer | 是 | - | 文档 ID,可先用 search_field_notes 查找。 |
| 返回字段 | 类型 | 说明 |
|---|---|---|
| tool | string | 本次调用的工具名。 |
| arguments | object | 服务端校验后实际执行的参数。 |
| result.message | string | 本次工具调用的结果摘要。 |
| result.data[] | object[] | 一个或多个结构化结果集。 |
| result.data[].format | string | 结果集格式;表格结果通常为 "compact_table"。 |
| result.data[].columns | string[] | 表格列名,按 rows 中每行的值顺序排列。 |
| result.data[].rows | array[] | 二维数组形式的数据行,避免每行重复字段名。 |
| result.credits | string | 额度计算说明;实际扣费以调用日志记录为准。 |
返回单篇投研资讯详情,包含全文 content、来源、发布时间、字数和 doc_type 解释。
{
"arguments": {
"doc_id": 10222
}
}{
"tool": "get_field_note",
"arguments": {
"doc_id": 10222
},
"result": {
"message": "返回单篇投研资讯详情,包含全文 content、来源、发布时间、字数和 doc_type 解释。",
"data": [
{
"format": "compact_table",
"columns": [
"date",
"value"
],
"rows": [
[
"2024-01-02",
1.23
]
]
}
],
"credits": "按实际返回量计算"
}
}search_news文本检索MCP / HTTP API财经新闻、最新消息、政策与海外动态检索。
查看详情
search_news文本检索MCP / HTTP API财经新闻、最新消息、政策与海外动态检索。
用户提到“新闻”“最新消息”“政策”“宏观”“海外动态”时首选;研究产业细节、纪要、调研、小作文或渠道反馈时用 search_field_notes,管理层原话用中美 transcript 工具。time_range 与具体日期范围二选一。
| 参数 | 类型 | 必填 | 默认 | 说明 |
|---|---|---|---|---|
| query | string | 是 | - | 财经新闻搜索问题或关键词,例如 "AI earnings"、"美联储 降息"。 |
| max_results | integer | 否 | 5 | 返回结果数量,范围 1-20。 |
| time_range | string | 否 | - | 按发布或更新时间过滤,可选 day/week/month/year 或 d/w/m/y;不能与日期参数同时设置。 |
| start_date | string | 否 | - | 开始日期,格式 YYYY-MM-DD;不能与 time_range 同时设置。 |
| end_date | string | 否 | - | 结束日期,格式 YYYY-MM-DD;不能与 time_range 同时设置。 |
| 返回字段 | 类型 | 说明 |
|---|---|---|
| tool | string | 本次调用的工具名。 |
| arguments | object | 服务端校验后实际执行的参数。 |
| result.message | string | 本次工具调用的结果摘要。 |
| result.data[] | object[] | 一个或多个结构化结果集。 |
| result.data[].format | string | 结果集格式;表格结果通常为 "compact_table"。 |
| result.data[].columns | string[] | 表格列名,按 rows 中每行的值顺序排列。 |
| result.data[].rows | array[] | 二维数组形式的数据行,避免每行重复字段名。 |
| result.credits | string | 额度计算说明;实际扣费以调用日志记录为准。 |
返回文本摘要,并在结构化结果中提供标题、URL、相关度、内容片段和 favicon;metadata 包含请求 ID、响应耗时和用量信息。日期范围无结果时返回 time_range 重试建议。
{
"arguments": {
"query": "AI earnings",
"max_results": 5,
"time_range": "week"
}
}{
"tool": "search_news",
"arguments": {
"query": "AI earnings",
"max_results": 5,
"time_range": "week"
},
"result": {
"message": "返回文本摘要,并在结构化结果中提供标题、URL、相关度、内容片段和 favicon;metadata 包含请求 ID、响应耗时和用量信息。日期范围无结果时返回 time_range 重试建议。",
"data": [
{
"format": "compact_table",
"columns": [
"date",
"value"
],
"rows": [
[
"2024-01-02",
1.23
]
]
}
],
"credits": "按实际返回量计算"
}
}get_data语义查询MCP / HTTP API自然语言取数和行情、估值、财务综合查询。
查看详情
get_data语义查询MCP / HTTP API自然语言取数和行情、估值、财务综合查询。
用户要求“查数据”“对比行情和估值”或同时看多个数据维度时首选;适合 2-3 只标的,复杂任务应拆分或使用底层数据工具。
| 参数 | 类型 | 必填 | 默认 | 说明 |
|---|---|---|---|---|
| query | string | 是 | - | 自然语言查询,例如 "获取茅台的行情数据和财务数据"。 |
| 返回字段 | 类型 | 说明 |
|---|---|---|
| tool | string | 本次调用的工具名。 |
| arguments | object | 服务端校验后实际执行的参数。 |
| result.message | string | 本次工具调用的结果摘要。 |
| result.data[] | object[] | 一个或多个结构化结果集。 |
| result.data[].format | string | 结果集格式;表格结果通常为 "compact_table"。 |
| result.data[].columns | string[] | 表格列名,按 rows 中每行的值顺序排列。 |
| result.data[].rows | array[] | 二维数组形式的数据行,避免每行重复字段名。 |
| result.credits | string | 额度计算说明;实际扣费以调用日志记录为准。 |
返回 message 加 data 的结构化结果,通常使用 compact_table 表示表格数据。
{
"arguments": {
"query": "获取茅台近一个月行情和最近四期财务数据"
}
}{
"tool": "get_data",
"arguments": {
"query": "获取茅台近一个月行情和最近四期财务数据"
},
"result": {
"message": "返回 message 加 data 的结构化结果,通常使用 compact_table 表示表格数据。",
"data": [
{
"format": "compact_table",
"columns": [
"date",
"value"
],
"rows": [
[
"2024-01-02",
1.23
]
]
}
],
"credits": "按实际返回量计算"
}
}get_strategy语义查询MCP / HTTP APIA股多指标组合选股与历史超额收益回测。
查看详情
get_strategy语义查询MCP / HTTP APIA股多指标组合选股与历史超额收益回测。
用自然语言描述选股策略,由系统转成指标条件并给出筛选和回测结果。
| 参数 | 类型 | 必填 | 默认 | 说明 |
|---|---|---|---|---|
| strategy_description | string | 是 | - | 自然语言描述选股策略,包括行业、指标条件和目标。 |
| 返回字段 | 类型 | 说明 |
|---|---|---|
| tool | string | 本次调用的工具名。 |
| arguments | object | 服务端校验后实际执行的参数。 |
| result | string | 文本结果,包含检索摘要、匹配片段、指标说明或策略分析。 |
返回策略解析、候选股票和历史超额收益结果。
{
"arguments": {
"strategy_description": "在电子行业中筛选 ROE 高于 10 且净利润增速高于 20 的股票"
}
}{
"tool": "get_strategy",
"arguments": {
"strategy_description": "在电子行业中筛选 ROE 高于 10 且净利润增速高于 20 的股票"
},
"result": "返回文本摘要、匹配片段或指标说明。"
}greet连接测试仅 MCP打招呼工具,用于测试 MCP 服务器连接和鉴权是否成功。
查看详情
greet连接测试仅 MCP打招呼工具,用于测试 MCP 服务器连接和鉴权是否成功。
完成 MCP 端点和 Bearer Token 配置后,可用这个工具做最小化连通性检查;该工具仅通过 MCP tools/list 与 tools/call 暴露。
| 参数 | 类型 | 必填 | 默认 | 说明 |
|---|---|---|---|---|
| name | string | 是 | - | 要打招呼的名称,例如 "World"。 |
| 返回字段 | 类型 | 说明 |
|---|---|---|
| content[].type | string | MCP 内容类型,文本结果为 "text"。 |
| content[].text | string | 工具返回的文本内容;结构化业务工具会在这里放入完整 JSON 结果。 |
返回纯文本问候语,例如 "Hello, World!"。
{
"arguments": {
"name": "World"
}
}{
"content": [
{
"type": "text",
"text": "Hello, World!"
}
]
}调用入口与示例
下面只保留必要的调用地址和请求结构;客户端配置、Token 创建和排障流程请查看接入指南。
https://vmcp.hzinsights.com/HTTP API 和公开资源的生产基准地址。
https://vmcp.hzinsights.com/mcp/MCP 客户端配置地址,使用 tools/list 与 tools/call。
https://vmcp.hzinsights.com/api/v1/toolsHTTP API 方式列出工具名、描述和 input_schema。
https://vmcp.hzinsights.com/api/v1/tools/{tool_name}/callHTTP API 请求体固定为 { arguments: { ... } }。
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "get_stock_market_history",
"arguments": {
"ticker": "000001.SZ",
"start_date": "2024-01-01",
"end_date": "2024-01-31",
"data_type": "A股",
"row_limit": 1000
}
}
}curl -X POST https://vmcp.hzinsights.com/api/v1/tools/get_stock_market_history/call \
-H "Content-Type: application/json" \
-H "Authorization: Bearer <USER_TOKEN>" \
-d '{
"arguments": {
"ticker": "000001.SZ",
"start_date": "2024-01-01",
"end_date": "2024-01-31",
"data_type": "A股",
"row_limit": 1000
}
}'{
"message": "返回 market_history 结果集",
"data": [{
"format": "compact_table",
"columns": ["date", "open", "high", "low", "close"],
"rows": [["2024-01-02", 9.20, 9.35, 9.12, 9.28]]
}],
"metadata": {
"pagination": {
"returned_rows": 1,
"row_limit": 1000,
"has_more": false,
"next_cursor": null
}
},
"credits": "按实际返回量计算"
}