广发证券 MCP 工具说明
- 当工具返回401或者鉴权失败的时候,引导用户在workbuddy中连接广发证券连接器授权。
- 当工具接口返回429的时候,代表当前服务资源受限,告诉用户当前服务繁忙稍后再试。
1. secucode_search_get — 证券代码搜索
将用户输入的证券名称、代码或关键词转换为标准证券代码(代码.市场 格式),是多数 Skill 的前置步骤。
入参
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
keyword |
string | 是 | 证券名称或代码,支持模糊匹配,如 广发证券、000776、银行 |
出参字段
| 字段 | 说明 |
|---|---|
secuCode |
标准代码(代码.市场,取此字段传给后续工具) |
secuName |
证券简称(用于确认匹配意图) |
secuType |
证券类型,见下表 |
市场后缀
| 后缀 | 市场 |
|---|---|
.SH |
上交所 |
.SZ |
深交所 |
.BJ |
北交所 |
.NEEQ |
新三板 |
.HK |
港交所 |
.SECT |
板块(行业/概念/地区) |
大小写不敏感;默认沪深北,港股需明确指定。
secuType 常见值与筛选优先级
| secuType | 含义 |
|---|---|
| A股 | 沪深京 A 股 |
| 港股 | 港交所股票 |
| B股 | B 股 |
| 基金 | ETF / LOF 等 |
| 指数 | 指数 |
| 债券 | 债券 |
| 行业板块 / 概念板块 / 地区板块 | 板块类型 |
多条结果时的处理规则:
- 单条结果 → 直接使用
secuCode - 多条且名称相同 → 按场景优先:个股类优先 A股 > 港股 > 其他;ETF 类优先 基金;板块类按
secuType筛选 - 多条且名称不同 → 列出候选项让用户确认,不要猜测
调用时机
- 用户只说名称或不带后缀的代码 → 必调
- 用户已给完整
代码.市场→ 可跳过 - 后续工具调用失败 → 回退校验
2. stockmovers_get — ETF异动查询
查询指定 ETF 的异动情况及异动成因。
描述:覆盖关键词:ETF异动 / ETF异动原因 / XX ETF为什么涨 / XX ETF为什么大跌 / XX ETF异动分析。数据通过 stockmovers_get 获取。
示例问法:
- xxx ETF今天为什么异动
- xxx 代码 异动原因
- xxx ETF有什么异动
- xxx 今天异动情况
需先调用 secucode_search_get 获取标准代码,secuType 优先选 基金。用户问的非某个具体证券代码时可跳过,secuCode 可以为空。
stockmovers_get 参数:
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
secuCode |
string | 否 | ETF代码 代码.市场,不传则查询市场最近异动情况 |
articleType |
string | 是 | 固定填 etf |
最多返回 100 条,无分页参数。
何时使用
触发:用户问"XX ETF为什么异动""XX ETF异动原因""XX ETF今天为什么涨/跌""XX ETF异动分析"。 不触发:实时行情/K线/盘口、个股异动(走个股异动)、全市场热点/宏观事件/投研日历、纯概念解释。
响应结构
{
"errCode": 0, "errMsg": "success",
"data": [ { "title":"异动标题", "publishTime":"2026-08-07 10:30:00", "media":"媒体来源", "content":"异动原因内容", "detailLink":"https://..." } ]
}
errCode=0成功;非 0 看errMsg。data字段:title(异动概览)/publishTime/media(媒体源)/content(异动原因详情)/detailLink(原文链接)/stocks(ETF 信息)。
注意事项与错误恢复
| 问题 | 处理 |
|---|---|
errCode != 0 |
看顶层 errMsg 判断原因 |
secuCode 格式错误 |
必须为 代码.市场(.SH/.SZ/.BJ/.NEEQ/.HK) |
| 用户只给 ETF 名称 | 用大模型知识库推断代码和市场后缀,如不确定需向用户确认 |
| 返回数据为空 | 校验 secuCode 是否正确,提示用户确认 ETF 代码 |
| 想看更早异动 | 固定返回近一个月内的异动资讯;建议用户缩小关注时间范围或明确事件主题 |
3. sector_article_get — 行业板块资讯查询
查询行业、概念、地区板块的最新资讯列表。
描述:覆盖关键词:行业板块资讯 / 概念板块分析 / 地区板块动态 / 板块研报 / XX行业最近资讯 / XX板块最新动态。最多返回最新 50 条。
示例问法:
- 银行业最近有什么资讯
- 新能源板块资讯
- AI概念板块有哪些资讯
- 半导体行业板块研报
需先调用 secucode_search_get 获取标准代码,按 secuType 筛选 行业板块 / 概念板块 / 地区板块,排除个股类型。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
secuCode |
string | 是 | 板块代码 代码.SECT,如 801780.SECT、108550.SECT |
最多返回 50 条,无分页参数。
出参结构:
{
"errCode": 0, "errMsg": "success",
"data": [
{ "title": "标题", "type": "新闻", "publishTime": "2026-08-11 00:00:00", "media": "券商/媒体来源", "detailLink": "https://...", "content": "研报摘要(可能为空)" }
]
}
errCode=0成功;非 0 看errMsg。data按发布时间倒序。- 每个资讯对象固定字段:
title/type/publishTime/media/detailLink(原文链接)/content(摘要,可能为空)。 type标识类型:新闻或研报。content仅研报有摘要;新闻无摘要,输出时省略摘要行,不要补造。
何时使用
触发:用户问"XX 行业/板块最近有什么资讯/动态/研报""XX 概念板块有哪些资讯""XX 地区板块"。 不触发:个股资讯、个股研报、全市场热点/宏观事件、投研日历、实时行情/盘口、纯概念解释。
注意事项与错误恢复
| 问题 | 处理 |
|---|---|
errCode != 0 |
看顶层 errMsg 判断原因 |
| Step 1 查不到板块 | 用知识库推断 代码.SECT 直接调 Step 2;仍失败请用户提供准确代码 |
| Step 1 返回多个板块 | 按 secuName 匹配度选择,无法唯一确认时列出候选让用户确认 |
| 代码格式错误 | 必须为 代码.SECT |
| Step 2 返回空 | 校验 secuCode 是否正确;回退 Step 1 重新校验 |
| 想看更早资讯 | 最多返回 50 条,无法翻页 |
4. market_comment_get — 市场点评查询
获取每日证券市场点评资讯,包括早报、午报及收评。
描述:覆盖关键词:今日早报 / 市场点评 / 盘面情况 / 盘前点评 / 午间点评 / 收盘点评 / 每日复盘 / 市场早报 / 市场收评 / 今日行情回顾。数据通过 market_comment_get 获取。支持按日期查询,范围为近三月内。
示例问法:
- 今日早报
- 今天市场点评
- 收盘点评
- 2026年8月1日的市场点评
- 昨天的大盘回顾
直接调用:
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
date |
string | 否 | 查询日期,格式 YYYYMMDD(如 20260801)。不传默认查当天。仅支持近三月内日期。 |
何时使用
触发:用户问"今天早报""市场点评""盘面情况""收盘点评""每日复盘""大盘回顾""今日行情"等泛市场每日点评场景。 不触发:特定个股异动、特定个股研报、市场头条/全网热议、实时行情/K线/盘口、投研日历、纯概念解释。
响应结构
{
"errCode": 0, "errMsg": "success",
"data": [
{ "id": "文章ID", "title": "【早报】标题", "content": "HTML格式正文内容", "media": "媒体来源", "publishTime": "2026-08-01 07:00:00", "detailLink": "https://..." }
]
}
字段说明
| 字段 | 说明 |
|---|---|
id |
文章唯一ID(内部字段,不输出) |
title |
标题,通常含类型前缀:【早报】/【午报】/【收评】等 |
content |
HTML 格式正文,含多个分类板块(见下方) |
media |
媒体来源(如:财联社) |
publishTime |
发布时间,格式 YYYY-MM-DD HH:mm:ss |
detailLink |
资讯详情页 H5 链接 |
内容板块说明
content 为 HTML 格式,通常按 <strong> 标签划分为以下板块(非固定,依当日内容而定):
| 板块标签 | 内容定位 | 典型内容 |
|---|---|---|
| 宏观新闻 | 国内宏观政策、重大会议、法规发布 | 国常会部署、财政数据、规划印发等 |
| 行业新闻 | 行业政策、产业数据、监管动态 | 行业准入、集采结果、ETF 资金流向等 |
| 公司新闻 | 上市公司公告、资本运作、风险事件 | 回购/增减持/定增/立案/业绩预告等 |
| 环球市场 | 海外市场表现、国际政经大事 | 美股指数、原油/黄金、地缘事件等 |
| 投资机会参考 | 机构观点与投资主线 | 券商研报观点、行业景气度分析等 |
注意事项与错误恢复
| 问题 | 处理 |
|---|---|
errCode != 0 |
看顶层 errMsg 判断原因 |
data 为空数组 |
可能当日点评尚未发布(如非交易日),提示用户稍后重试或查询其他日期 |
date 超出近三月范围 |
提示用户仅支持查询近三月内的市场点评 |
date 格式错误 |
必须为 YYYYMMDD 格式 |
content 含 HTML 标签 |
输出时需去除 HTML 标签,转为纯文本/Markdown 格式 |
| 多条点评返回 | 同一日期可能返回早报+午报+收评多条,按 publishTime 倒序排列 |
5. news_headlines_get — 市场头条
获取当日市场精选头条财经新闻。
描述:面向 A 股市场热点发现,查询今日热点专题及当前头条内容。数据通过 news_headlines_get 获取,无需入参。
示例问法:
- 今天有什么热点新闻
- 今日市场头条
- 当前热门板块有哪些
- 今日财经资讯
无需入参,直接以空参数 {} 调用即可。
何时使用
触发:用户问"今天有什么热点""市场热点板块""今日头条""市场聚焦""今日资讯""市场动态""当前热门板块""今日财经资讯"等泛市场热点资讯场景。 不触发:特定个股异动、个股研报、实时行情/K线/盘口、投研日历、特定股票代码查询、纯概念解释。
响应结构
{
"errCode": 0, "errMsg": "success",
"data": {
"articles": [
{ "title": "文章标题", "media": "媒体来源", "publishTime": "2026-08-20 13:55:49", "detailLink": "https://..." }
]
}
}
字段说明 — data.articles[]
| 字段 | 说明 |
|---|---|
id |
文章唯一ID(内部字段,不输出) |
title |
资讯标题 |
publishTime |
发布时间,格式 YYYY-MM-DD HH:mm:ss |
media |
媒体来源(如:上海证券报、财联社、证券时报等) |
detailLink |
资讯详情页链接 |
该接口仅返回标题级元数据,不返回正文内容。如需阅读正文,引导用户点击
detailLink。
注意事项与错误恢复
| 问题 | 处理 |
|---|---|
errCode != 0 |
看顶层 errMsg 判断原因 |
articles 为空 |
提示用户当前暂无精选资讯数据,建议稍后重试 |
detailLink 为空 |
跳过详情链接行 |
6. secu_compinfo_get — 个股简况查询
查询上市公司基本信息(F10 简况)。
描述:覆盖关键词:个股简况 / F10 / 基本面信息 / 某公司是什么时候上市的 / 某公司的主营业务是什么。数据通过 secu_compinfo_get 获取。
需先调用 secucode_search_get 获取标准代码,用户已给完整代码可跳过。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| secuCode | string | 是 | 证券代码,格式如 600000.SH、000776.SZ |
示例:
- 查询广发证券:secuCode="000776.SZ"
7. stockmovers_get — 个股异动查询
查询指定 A 股个股的异动情况及异动成因。
描述:覆盖关键词:个股异动 / 股票异动原因 / XX股票为什么涨 / XX股票异动分析。数据通过 stockmovers_get 获取。
示例问法:
- xxx股票今天为什么异动
- 000776.SZ 异动原因
- xxx股票暴涨原因
需先调用 secucode_search_get 获取标准代码,secuType 优先选 A股/港股/B股。用户问的非某个具体证券代码时可跳过,secuCode 可以为空。
stockmovers_get 参数:
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
secuCode |
string | 否 | 股票代码 代码.市场,不传则查询市场最近异动情况 |
articleType |
string | 是 | 固定填 stock |
最多返回 100 条,无分页参数。
何时使用
触发:用户问"XX 股票为什么异动""XX 异动原因""XX 股票今天为什么大涨/大跌""XX 异动分析"。 不触发:实时行情/K线/盘口、个股研报、全市场热点/宏观事件/投研日历、ETF异动(走 ETF 异动)、纯概念解释。
响应结构
{
"errCode": 0, "errMsg": "success",
"data": [ {
"title": "标题", "publishTime": "2026-08-07 10:30:00", "media": "媒体来源",
"content": "异动原因内容", "detailLink": "https://...",
"stocks": [{ "Market": "市场", "Code": "代码", "Name": "个股名称" }]
} ]
}
errCode=0成功;非 0 看errMsg。data字段:title(异动概览)/publishTime/media/content(异动原因详情)/detailLink(原文链接)/stocks(个股信息)。
注意事项与错误恢复
| 问题 | 处理 |
|---|---|
errCode != 0 |
看顶层 errMsg 判断原因 |
secuCode 格式错误 |
必须为 代码.市场(.SH/.SZ/.BJ/.NEEQ/.HK) |
| 用户只给股票名称 | 用大模型知识库推断代码和市场后缀,如不确定需向用户确认 |
| 返回数据为空 | 校验 secuCode 是否正确,提示用户确认股票代码 |
| 想看更早异动 | 固定返回近一个月内的异动资讯;建议用户缩小关注时间范围或明确事件主题 |
8. stock_news_get — 个股资讯查询
查询某支股票的最新资讯列表。
描述:覆盖关键词:个股资讯 / 个股新闻 / 股票资讯 / 股票最近消息 / XX股票最新动态 / XX有什么新闻。最多返回最新 50 条。
示例问法:
- xxx股票最近有什么新闻
- 000776.SZ 最新资讯
- xxx股票最新动态有哪些
需先调用 secucode_search_get 获取标准代码,secuType 优先选 A股/港股/B股。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
secuCode |
string | 是 | 股票代码 代码.市场 |
最多返回 50 条,无分页参数。
出参结构:
{
"errCode": 0, "errMsg": "success",
"data": [
{ "title": "标题", "publishTime": "2026-08-07 10:30:00", "media": "媒体来源", "detailLink": "https://..." }
]
}
errCode=0成功;非 0 看errMsg。data按发布时间倒序。- 每个资讯对象固定 4 字段(无正文):
title/publishTime/media/detailLink。
何时使用
触发:用户问"XX 股票最近有什么新闻/资讯/动态/消息""XX 最新发生了什么"。 不触发:实时行情/K线/盘口、个股研报(走研报)、全市场热点/宏观事件/投研日历、纯概念解释。
注意事项与错误恢复
| 问题 | 处理 |
|---|---|
errCode != 0 |
看顶层 errMsg 判断原因 |
| Step 1 查不到股票 | 用知识库推断 代码.市场 直接调 Step 2;仍失败请用户提供准确代码 |
| Step 1 返回多条 | 优先选 A股/港股/B股;多条无法唯一确认时列出候选让用户确认 |
| Step 1 返回基金/指数/债券 | 非个股类型,需向用户确认是否继续 |
| 代码格式错误 | 必须为 代码.市场 |
| Step 2 返回空 | 校验 secuCode 是否正确;回退 Step 1 重新校验 |
| 想看更早资讯 | 最多返回 50 条,无法翻页 |
9. topic_hotmatch_get — 热点专题查询
根据关键词语义匹配相关热点专题,返回专题标题、事件摘要及关联文章列表。
描述:覆盖关键词:某热点事件的来龙去脉 / 某个关键词相关的专题有哪些 / 某事件的最新进展和文章。数据通过 topic_hotmatch_get 获取。
示例问法:
- 最近有什么热点事件
- 查询xx事件的来龙去脉
- xx相关的专题有哪些
调用 topic_hotmatch_get:
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| q | string | 是 | 查询关键词,如 AI、新能源、半导体;泛问热点传空字符串 "" |
使用示例:
- 查询 AI 相关的热点专题:
q="AI" - 查询新能源事件的摘要和脉络:
q="新能源事件" - 获取当前热点专题概览(无具体关键词):
q=""
注意:提取用户问题中的核心关键词传给
q,不要把整句话塞进去。例如「最近 AI 有什么大事」→q="AI"。相关性筛选:
- 有明确关键词时:接口返回多条专题,需结合用户意图判断相关性,只呈现匹配的条目。若多条均不相关,告知用户未找到匹配的专题。
- 无关键词(q="")时:接口返回的结果均为近期热点,无需做相关性筛选,直接呈现。
输出要求
- 资讯详情链接以蓝链形式给出(markdown 超链接
[查看详情](url)),不要直接回显原始 URL。 - columns中的name是tab标题的意思,注意不要当成栏目了
- 关联的资讯用模块展示,不要做成表格输出,日期尽量隐藏起来
- 如需深入回答:可用 WebFetch 读取
detailLink获取完整内容。 - 末尾标注:
数据来源:广发证券 GF Skills API
10. invest_calendar_get — 投资日历查询
查询资本市场投研日历,按月份/日期获取六类事件。
描述:覆盖关键词:投研日历 / 投资日历 / 新股申购 / 财报披露 / 宏观事件 / 隔夜全球要闻 / 下周大事 / 本月大事 / 资本市场日历。数据通过 invest_calendar_get 获取。
示例问法:
- 本月投研日历有哪些大事
- 2026年8月有哪些新股申购
- 8月7日有什么资本市场事件
- 下周资本市场有哪些大事提醒
- 最近一期的隔夜全球要闻
调用 invest_calendar_get:
| 参数 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
month |
string | 否 | 最新月份 | 月份 YYYYMM(如 202608),与 date 二选一 |
date |
string | 否 | - | 日期 YYYYMMDD(如 20260807),按天精确过滤,与 month 二选一 |
注意 日期无分隔符(
20260807,不是2026-08-07)。接口固定返回全部六类事件,无法按类型筛选;如需某一类,按typ自行过滤。
调用示例:{}(默认最新月份)/ {"month": "202608"} / {"date": "20260807"}
何时使用
触发:用户问"本月/某月投研日历/投资日历"、"某月有哪些大事/新股/财报"、"某日有什么资本市场事件"、"宏观事件/隔夜全球要闻/下周大事提醒"。 不触发:个股实时行情/K线/盘口、个股财务/估值/F10/研报、纯概念解释。
响应结构
{
"errCode": 0, "errMsg": "success",
"data": [ { "date": "2026-08-01 00:00:00", "events": [ ... ] } ]
}
errCode=0成功;非 0 看顶层errMsg。data按日期分组,每个元素含date与events。
事件类型(typ)
| typ | 名称 | 说明 |
|---|---|---|
| 1 | 新股 | 每日新股申购/上市信息 |
| 2 | 大事 | 每日资本市场大事提醒 |
| 3 | 财报 | 上市公司财报披露日期 |
| 4 | 宏观事件 | 宏观经济数据、政策会议、行业事件(带行业/分类标签) |
| 5 | 隔夜全球要闻 | 每日隔夜全球金融市场要闻 |
| 6 | 下周大事提醒 | 下周资本市场大事提醒 |
各 typ 字段说明
| typ | 字段 | 渲染方式 |
|---|---|---|
| 1 新股 / 3 财报 | title + content 股票列表(每行一条),无 invest/id,time 可能为空 |
title 做小标题,content 按行展示 |
| 2/5/6 大事/隔夜/下周 | title(已含日期/星期)+ content 编号要点 + id + time |
显示 title,content 按编号缩进展示要点 |
| 4 宏观 | invest 对象(desc/display_name/industry_name/invest_calendar_category_desc 等)+ time |
[行业] [分类] 描述,空值方括号省略 |
11. 行情排行榜单(quote_rank_get / lhb_aborttrade_get)
获取 A 股/ETF 实时排行榜单及龙虎榜数据。
描述:覆盖关键词:A 股涨幅排名 / ETF 换手率排行 / 资金净流入排行 / 个股资金流向 / 今日龙虎榜。数据通过 quote_rank_get 和 lhb_aborttrade_get 获取。
何时使用
| 用户意图 | 使用工具 |
|---|---|
| A 股涨幅/跌幅/成交额/换手率等排行 | quote_rank_get |
| ETF 涨幅/跌幅/换手率等排行 | quote_rank_get |
| 资金净流入排行 | quote_rank_get |
| 今日/某日龙虎榜、上榜个股、营业部买卖 | lhb_aborttrade_get |
quote_rank_get - 行情排行
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| rankType | string | 是 | 榜单类型:ashare=A股排行,etf=ETF排行 |
| sort | integer | 是 | 排序字段:1=涨跌幅,2=最新价,3=昨收价,4=成交量,5=成交额,10=换手率,12=涨跌值,14=振幅,15=5分钟涨速,20=资金流入 |
| sd | integer | - | 排序方向:0=升序,1=降序(默认 1) |
| pd | integer | - | 分页方向:0=下一页,1=上一页(默认 0) |
| from | integer | - | 起始位置,从 0 开始(默认 0) |
| count | integer | - | 返回数量,每页最大 100(默认 10) |
使用示例:
- A 股涨幅排行前 20:
rankType="ashare",sort=1,count=20 - A 股跌幅榜前 10:
rankType="ashare",sort=1,sd=0,count=10 - ETF 成交额排行:
rankType="etf",sort=5,count=20 - A 股资金净流入排行:
rankType="ashare",sort=20,count=20 - 翻页查询(第 2 页):
rankType="ashare",sort=1,from=20,count=20
lhb_aborttrade_get - 龙虎榜
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| date | string | - | 日期,格式 YYYYMMDD(如 20260812),为空时默认查最新 |
使用示例:
- 查询最新龙虎榜:不传 date 参数
- 查询某日龙虎榜:
date="20260801"
输出要求
- 涉及涨跌幅时补一句风险提示:排行数据不代表未来收益。
- 末尾标注:
数据来源:广发证券 GF Skills API
12. stock_report_get — 个股研报摘要查询
查询某支股票最新券商研报列表。
描述:覆盖关键词:个股研报 / 券商研报 / 研报列表 / XX股票研报 / XX研报观点 / 机构研报 / 研报评级。最多返回最新 50 条。
示例问法:
- xxx股票最近有什么研报
- 000776.SZ 研报观点
- xxx股票机构研报有哪些
需先调用 secucode_search_get 获取标准代码,secuType 优先选 A股/港股/B股。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
secuCode |
string | 是 | 股票代码 代码.市场 |
最多返回 50 条,无分页参数。
出参结构:
{
"errCode": 0, "errMsg": "success",
"data": [
{ "title": "研报标题", "publishTime": "2026-08-07 10:30:00", "media": "研究机构", "detailLink": "https://...", "content": "研报摘要(可能为空)" }
]
}
errCode=0成功;非 0 看errMsg。data按发布时间倒序。- 每个研报对象固定字段:
title/publishTime/media(研究机构)/detailLink(原文链接)/content(研报摘要,可能为空)。 content为空时仅展示标题与其他字段,不要补造内容。
何时使用
触发:用户问"XX 股票最近有什么研报/券商观点/机构评级""研报有哪些""研报列表"。 不触发:实时行情/K线/盘口、个股新闻资讯(走个股资讯)、个股财务/F10 基本面、全市场热点/宏观事件/投研日历、纯概念解释。
注意事项与错误恢复
| 问题 | 处理 |
|---|---|
errCode != 0 |
看顶层 errMsg 判断原因 |
| Step 1 查不到股票 | 用知识库推断 代码.市场 直接调 Step 2;仍失败请用户提供准确代码 |
| Step 1 返回多条 | 优先选 A股/港股/B股;多条无法唯一确认时列出候选让用户确认 |
| Step 1 返回基金/指数/债券 | 非个股类型,需向用户确认是否继续 |
| 代码格式错误 | 必须为 代码.市场 |
| Step 2 返回空 | 校验 secuCode 是否正确、该股票是否确有研报覆盖;回退 Step 1 重新校验 |
| 想看更早研报 | 最多返回 50 条,无法翻页 |
12. stock_report_get — 个股研报摘要查询
查询某支股票最新券商研报列表。
描述:覆盖关键词:个股研报 / 券商研报 / 研报列表 / XX股票研报 / XX研报观点 / 机构研报 / 研报评级。最多返回最新 50 条。
示例问法:
- xxx股票最近有什么研报
- 000776.SZ 研报观点
- xxx股票机构研报有哪些
需先调用 secucode_search_get 获取标准代码,secuType 优先选 A股/港股/B股。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
secuCode |
string | 是 | 股票代码 代码.市场 |
最多返回 50 条,无分页参数。
出参结构:
{
"errCode": 0, "errMsg": "success",
"data": [
{ "title": "研报标题", "publishTime": "2026-08-07 10:30:00", "media": "研究机构", "detailLink": "https://...", "content": "研报摘要(可能为空)" }
]
}
errCode=0成功;非 0 看errMsg。data按发布时间倒序。- 每个研报对象固定字段:
title/publishTime/media(研究机构)/detailLink(原文链接)/content(研报摘要,可能为空)。 content为空时仅展示标题与其他字段,不要补造内容。
何时使用
✅ 触发:用户问"XX 股票最近有什么研报/券商观点/机构评级""研报有哪些""研报列表"。 ❌ 不触发:实时行情/K线/盘口、个股新闻资讯(走个股资讯)、个股财务/F10 基本面、全市场热点/宏观事件/投研日历、纯概念解释。
注意事项与错误恢复
| 问题 | 处理 |
|---|---|
errCode != 0 |
看顶层 errMsg 判断原因 |
| Step 1 查不到股票 | 用知识库推断 代码.市场 直接调 Step 2;仍失败请用户提供准确代码 |
| Step 1 返回多条 | 优先选 A股/港股/B股;多条无法唯一确认时列出候选让用户确认 |
| Step 1 返回基金/指数/债券 | 非个股类型,需向用户确认是否继续 |
| 代码格式错误 | 必须为 代码.市场 |
| Step 2 返回空 | 校验 secuCode 是否正确、该股票是否确有研报覆盖;回退 Step 1 重新校验 |
| 想看更早研报 | 最多返回 50 条,无法翻页 |
13. 行业指标查询与解读(searchIndustryIndicators / queryIndicatorDetails)
查询行业、宏观、地区及大宗商品等非个股时序指标,并基于真实数据做投研解读。
精品数据库覆盖汽车、房地产、新能源、电力设备、机械、电子、基础化工、消费等 21 个重点行业,约 9 万个核心行业指标、200+ 垂类来源,提供行业经营、产业链与市场跟踪类时序数据。
描述:覆盖关键词:行业指标 / 宏观指标 / 指标数值 / 指标走势 / 最新值 / 数据解读,如「新能源汽车渗透率」「GDP增速」「动力煤价格」。
示例问法:
- 新能源汽车渗透率
- 商品房成交面积 / 光伏组件价格 / 汽车销量
- GDP增速最新值 / 动力煤价格走势
- 每间可售房收入RevPAR:全国_经济型:周
| 工具名称 | operationId | 用途 |
|---|---|---|
| 搜索行业指标 | searchIndustryIndicators |
按指标名关键词分词检索清单(名称、主题/分组、后续取数用的编号)。不含数值。 |
| 查询指标数据 | queryIndicatorDetails |
按编号或完整名称批量拉详情与时间序列 |
推荐流程:先「搜索行业指标」确认有哪些指标,再「查询指标数据」获取具体数值与走势。 仅返回当前用户有权限、且仍在正常更新的指标。鉴权由平台注入,不要向用户索要或展示 token。
何时使用
✅ 触发:用户查询行业 / 宏观 / 地区 / 大宗商品等非个股主体的时序指标数值、走势或解读。调用搜索工具时,从问法中抽取指标名关键词作为 query,去掉「最新值」「走势」「查一下」等时间或口语修饰(「GDP增速最新值」→ GDP增速;「动力煤价格走势」→ 动力煤价格)。
❌ 不触发:个股实时行情/K线、板块成分股名单、纯概念解释、新闻资讯。遇到时说明本能力覆盖行业 / 宏观 / 地区 / 大宗商品等时序指标,并请用户改用相应口径提问。
搜索结果的 display_name 通常是「指标名:主体/对象:频率或口径」三段式完整名称,用于候选消歧和详情查询;用户不必预先按三段式提问。
工作流程
用户自然语言
→ Step 1 解析关键词与时间
→ Step 2 搜索行业指标(已有 indicator_key 可跳过)
→ Step 3 查询指标数据
→ Step 4 先表格,后投研解读 + 免责声明
Step 1:解析用户问法
| 用户说法 | 动作 |
|---|---|
| 口语问法或普通指标名 | 去掉口语和时间修饰,抽出指标名关键词作为 query 单次传入 |
| 完整三段式(含两个「:」) | 整句原样作为 query 单次传入,禁止拆成多段 |
已有上一轮返回的 indicator_key |
可跳过搜索,直接「查询指标数据」 |
| 「最新 / 最近 / 今日」 | 详情可不传日期,展示 value_list 最新一期 |
| 「近一年 / 近三年 / 2025年」或明确起止 | 映射为 start_date / end_date(yyyy-MM-dd) |
| 多个相关指标一起看 | 「查询指标数据」一次传入多个 indicator_keys |
时间映射:近一年 → 今日减 1 年至今日;近三年 → 今日减 3 年;2025 年 → 2025-01-01 ~ 2025-12-31。不填日期则按系统默认范围返回。
Step 2:搜索行业指标(searchIndustryIndicators)
当你不确定具体指标叫什么、或想先看看库里有哪些相关数据时使用。只找清单,不会给出数值;单次最多约 50 条。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
query |
string | ✅ | 指标名关键词;完整三段式则整句传入 |
{ "query": "新能源汽车渗透率" }
出参(业务成功:code == 200,部分环境另有 success == true):
| 字段 | 说明 |
|---|---|
indicator_key |
指标编号。后续「查询指标数据」优先使用 |
display_name |
指标名称 |
cluster_name |
所属主题/分组;可能为 "" |
同一关键词可能返回簇下多口径及同比变体。用户已给完整名称时,优先精确匹配 display_name,勿把「周」误用成「周同比」。无法确定则列出名称 + 主题/分组请用户确认。无结果时把问法改得更具体后整体再搜一次,禁止拆词试探。
Step 3:查询指标数据(queryIndicatorDetails)
已经知道要查哪几个指标、想拿数值和时间序列时使用。单次最多 500 个指标。indicator_keys 与 display_names 至少提供一种。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
indicator_keys |
array | 条件必填 | 推荐。来自「搜索行业指标」的编号,可一次多个 |
display_names |
array | 条件必填 | 未提供编号时使用,须与库中返回的完整 display_name 一致(通常为三段式) |
cluster_name |
string | 否 | 按名称仍匹配不到时,用主题/分组辅助定位。不可单独作为唯一条件 |
start_date |
string | 否 | 开始日期,yyyy-MM-dd |
end_date |
string | 否 | 结束日期,yyyy-MM-dd,不得早于开始日期 |
优先只传 indicator_keys + 日期:
{
"indicator_keys": ["ind2024062487408648_tag074448458"],
"start_date": "2023-01-01",
"end_date": "2025-12-31"
}
出参 data[]:
| 字段 | 位置 | 展示 |
|---|---|---|
display_name |
指标级 | 指标名称 |
frequency |
指标级 | 更新频率,线上为中文频度如 周度 / 月度 / 旬度 |
unit |
指标级 | 单位,如 元、元/件、万吨 |
cluster_name |
指标级 | 主题/分组;空则不展示 |
data_source |
指标级 | 数据来源,如 酒店之家、蝉妈妈、同花顺iFinD |
indicator_key |
指标级 | 表注 |
value |
value_list[] |
原样展示(数字、长小数或区间 "[10,50)") |
data_time |
value_list[] |
yyyy-MM-dd,按该指标 frequency 转换后展示 |
data_time 展示规则:
| frequency | 展示 |
|---|---|
日度 / 周度 |
日期 yyyy-MM-dd |
旬度 |
日=01 上旬、11 中旬、21 下旬(如 2026-01-11 → 2026年1月中旬) |
月度 |
年月(2026-01-01 → 2026年1月) |
季度 |
年季 |
年度 |
年 |
| 无法判断 | 原样显示 data_time |
多指标独立制表,不强行对齐日期。value 为区间时,解读中说明这是分档而非精确点值。
Step 4:输出(先表格,后解读)
顺序固定:数据详情表格 → 投资研究解读 → 数据来源与免责声明。
- 数据详情表格(必出):覆盖
value_list有效记录;过长时取最新若干期并标注区间。列:指标名称 | 时间 | 频率 | 数值 | 单位。频率列直接展示返回值(如周度)。 - 投资研究解读(必出):只基于真实数据,不得编造数值。覆盖:① 水平与趋势(当前值相对历史分位/均值,近期方向与斜率);② 边际变化(最新一期环比/同比,是否拐点或加速/减速);③ 驱动与关联(宏观/产业/供需,与上下游、价格、库存、政策的联动);④ 投资含义(对相关行业、公司的景气与配置启示,区分短周期与中长期);⑤ 风险与局限(频率、样本区间、季节性、口径变化;区间型数值的信息损失)。
输出模板:
## {{display_name}}数据详情
> 数据来源:{{data_source}} | 主题/分组:{{cluster_name}} | 查询区间:{{start_date}} ~ {{end_date}}
| 指标名称 | 时间 | 频率 | 数值 | 单位 |
|----------|------|------|------|------|
| {{display_name}} | {{按 frequency 转换后的 data_time}} | {{frequency}} | {{value}} | {{unit}} |
### 投资研究解读
1. **水平与趋势**:…
2. **边际变化**:…
3. **驱动与关联**:…
4. **投资含义**:…
5. **风险与局限**:…
> 本回答由AI生成,仅供参考,不构成任何专业建议。
cluster_name 为空时省略「主题/分组」。
注意事项与错误恢复
| 情况 | 对用户 |
|---|---|
| 鉴权失败 | 说明精品数据库暂不可用,请稍后重试;不提及 token、appid |
code != 200 或 success == false |
用通俗语言转述 msg,不编造数据 |
| 搜索无结果 | 请用户补充行业、主体或口径后再查 |
| 多条候选 | 选最贴合问法者;拿不准则列出名称请用户选 |
value_list 为空 |
该时间范围内暂无数据,可换相邻指标或调整区间 |
| 超时 / 服务错误 | 自动重试最多 3 次(间隔 ≥ 2 秒);仍失败则说明暂时查不到 |
响应前自查
- 调用的是「搜索行业指标」「查询指标数据」,不是 HTTP 路径名
- 已从用户问法抽取指标名关键词;仅用户已给完整三段式时整句传入;先搜索再查数(已有编号除外)
- 簇内多条时未误用同比/口径变体
-
indicator_keys与display_names至少一种;日期为yyyy-MM-dd -
value原样;data_time按frequency转换 - 先表格后解读;数据来源用返回的
data_source;含免责声明 - 未向用户暴露鉴权信息