恒生聚源金融数据

概述

gildata-finance-data Skill

核心边界一句话：精确数值用结构化工具，观点解读用研报，原文核实用公告，候选名单用筛选工具，宏观行业用时序工具，兜底取数用聚合接口。

目标口诀：先判路由 → 再消歧 → 再调用 → 再统一口径 → 再输出。

---

§1 何时使用

当用户表达以下任一意图时，优先使用本 skill：

行情 / 趋势

• "看下 XX 最近怎么样" / "今年以来表现如何" / "这票最近强不强" / "近三个月走势"

财务 / 估值

• "看下 XX 财报" / "最近几个季度利润趋势" / "现在估值算高吗" / "帮我看 PE/PB/ROE"

对比 / 排行 / 筛选

• "XX 和 YY 谁更强" / "哪些公司利润增长更快" / "帮我筛一下高 ROE 低负债" / "排个前十"

板块 / 指数 / 主题

• "最近哪个板块最强" / "半导体最近怎么样" / "机器人为什么涨" / "指数成分股有哪些"

资金流 / 情绪

• "最近资金在买什么" / "北向资金最近流向哪里" / "主力资金流入最多的是谁" / "龙虎榜上有什么看点"

公告 / 新闻 / 研报

• "最近有什么公告" / "最近有没有什么催化" / "券商怎么看 XX" / "分析师对 XX 的最新观点"

工商 / 尽调 / 风控

• "查一下 XX 的工商信息" / "这家公司有诉讼或被执行记录吗" / "XX 的股权质押情况" / "查一下这家公司的股东和高管" / "XX 有没有被列入失信被执行人" / "这家公司的对外担保情况"

宏观 / 跨市场

• "CPI/PMI/社融最近怎么看" / "宏观环境怎么样" / "美国国债收益率"

数据导出 / 研究准备

• "给我导出一份行情数据" / "把近两年日线拉成 CSV" / "生成可回测的数据表"

---

§2 工作原则

1. 本 skill 优先：金融数据查询优先使用本 skill 调用的 GilData MCP 工具，不要自己编数据
2. 最少工具原则：保证回答质量的前提下，尽可能使用最少的工具
3. 先分类，再调用：不要试错式撞工具
4. 能直查就直查：信息够就别再问
5. 歧义低时可用默认，但必须写明假设
6. 歧义高时先澄清：不要猜标的、口径、时间
7. 结构化数据优先于叙事：精确数值不能用研报凑

---

§3 工具路由（10 个 MCP 工具）

3.1 恒生聚源 MCP 工具列表

恒生聚源 MCP 提供 10 个数据 Tool。这是取数据的主通道，优先使用，不要自己编数据。

Tool 名	数据形态	用途
FinQuery	结构化数据	金融标的的精确数值/属性查询（财务/行情快照/估值/单只基金净值）
MacroIndustryData	结构化时序	宏观经济或行业经济的时间序列指标
FinancialResearchReport	非结构化研报	研报观点、行业格局判断、叙事性分析
AnnouncementData	非结构化公告	A 股上市公司公告原文与重大事项
SmartStockSelection	结构化候选筛选	多维条件筛选股票候选清单
SmartFundSelection	结构化候选筛选	多维条件筛选基金候选清单
SmartFundManagerSelection	结构化候选筛选	多维条件筛选基金经理候选清单
NewsDataQuery	非结构化资讯	资讯舆情检索、新闻舆情、市场快讯
IcEnterpriseDataQuery	结构化数据	工商企业数据（工商档案/合规风险/司法涉诉）
FinDataFallbackQuery	聚合接口（兜底）	行情/财务/估值/资金流等精确取数；通过 api_name 路由

所有 Tool 统一入参 query 字符串（自然语言）。

---

3.2 取数顺序规则

3.2.1 第 1 优先级 · 主通道（9 个独立 Tool，按数据问题分工）

用户问题特征	用户常见说法	优先调用
单/多金融标的结构化数据（财务/行情/估值/单只基金净值）	"查 XX 财报"、"XX 净利润"、"XX 最新净值"	FinQuery
宏观/行业经济时序数据	"GDP 增速"、"CPI"、"XX 行业销量趋势"	MacroIndustryData
研报观点 / 行业格局 / 叙事分析	"券商怎么看 XX"、"最近有什么重要研报"	FinancialResearchReport
A 股公司公告 / 重大事项 / 权益分派	"XX 最近有什么公告"、"业绩预告"、"权益分派方案"	AnnouncementData
满足条件的股票筛选	"ROE 大于 15% 的票"、"高股息低估值股票"	SmartStockSelection
指数成分股查询	"中证800成分股"、"沪深300有哪些股票"、"科创50成分股"	SmartStockSelection
满足条件的基金筛选	"重仓 XX 的基金"、"夏普高的混合基金"	SmartFundSelection
满足条件的基金经理筛选	"百亿明星基金经理"、"擅长科技的基金经理"	SmartFundManagerSelection
资讯舆情/新闻舆情/市场快讯	"XX 最近有什么新闻"、"看看舆情怎么样"	NewsDataQuery
工商企业数据（工商档案/合规风险/司法涉诉）	"查 XX 工商信息"、"XX 被执行人信息"、"XX 股权质押"	IcEnterpriseDataQuery

3.2.2 第 2 优先级 · 兜底通道

主通道找不到所需数据时，调用 FinDataFallbackQuery。两条路径：

• 路径一（指定）：skill 或用户 query 中已明确 api_name → 直接路由到该细分接口
• 路径二（兜底）：未指定 api_name 时直接传递 query，由工具内部自动决策

3.2.3 第 3 优先级 · Web 搜索（最后兜底）

聚源 MCP 也找不到 → 使用 Web 搜索。适用：最新新闻、海外信息、聚源 MCP 暂未覆盖的资讯。

3.3 最易混淆的边界

边界 1 · FinQuery vs SmartStockSelection

场景	正确工具	理由
已知标的查详情/属性/行情/财务	FinQuery	单标的精确查数，返回结构化数据
要筛一批标的（自定义条件）	SmartStockSelection	按条件筛选候选清单
查指数成分股列表	SmartStockSelection	成分股本身就是一批标的，query 中指明指数名称即可，避免全量超长
查指数本身的行情/估值	FinQuery	指数作为标的的属性查询

典型错调：

• "高 ROE 的票有哪些" → 应该调 SmartStockSelection 筛清单，不是用 FinQuery
• "中证800成分股有哪些" → 应该调 SmartStockSelection，不是用 FinQuery，因为SmartStockSelection本身就是做候选筛选的，语义更匹配

边界 2 · FinQuery vs MacroIndustryData

场景	正确工具	典型错调
个股/基金/指数行情或属性	FinQuery	❌ 用 MacroIndustryData 查个股
宏观和行业经济指标	MacroIndustryData	❌ 用 FinQuery 查 GDP/CPI

典型错调："上证指数 + 半导体行业销量趋势" → 前者走 FinQuery，后者走 MacroIndustryData，分别调用。

边界 3 · AnnouncementData vs FinancialResearchReport

场景	正确工具	典型错调
公司自己披露的原文	AnnouncementData	❌ 用研报代替公告原文
分析师/研究员写的解读	FinancialResearchReport	❌ 用公告代替券商观点

典型错调："茅台业绩怎么样" → 原始数据走 FinQuery；券商评价走 FinancialResearchReport；业绩预告原文走 AnnouncementData。几者不可混用。

---

§4 工具能力边界

4.1 FinQuery

一句话定位：已知标的的精确结构化数据

核心能力：本工具支持自然语言提问，提供金融标的（如股票/债券/基金/基金经理/指数/行业/概念/理财/期权/市场等）的结构化数据（如基本资料、财务数据、行情快照、估值指标）查询服务，返回结果为数据表格，非叙事文本。

适用场景：

• "查询某股票2020年至今的净利润数据"
• "获取某指数近一个月每日收盘价"
• "某债券基金的最新净值和费率？"

适合：

• 已知标的查财务 / 估值 / 行情 / 基础属性
• 单只基金的净值、费率、规模
• 指数成分股、行情快照
• 单标的资金流（北向、主力、龙虎榜）

不适合：

• 股票/基金/基金经理列表筛选 → 用 SmartStockSelection / SmartFundSelection / SmartFundManagerSelection
• 宏观/行业经济时序 → 用 MacroIndustryData
• 研报观点/叙事 → 用 FinancialResearchReport
• 公告原文核实 → 用 AnnouncementData
• 资讯舆情 → 用 NewsDataQuery
• 工商档案/合规风险/司法涉诉 → 用 IcEnterpriseDataQuery

组合使用：

• 可配合 SmartStockSelection 筛选股票后再查询具体数据
• 可配合 SmartFundSelection 筛选基金后再查询具体数据
• 可配合 SmartFundManagerSelection 筛选基金经理后再查询具体数据
• 可配合 FinancialResearchReport 了解金融数据背后的研报解读

4.2 MacroIndustryData

一句话定位：宏观/行业经济时序指标

核心能力：本工具支持自然语言提问，提供宏观经济或行业经济指标的时间序列数据，覆盖中国宏观（GDP/CPI）、地方宏观、行业经济（半导体销售额）、全球多经济体指标，返回结果为时序数值，非叙事文本。指标覆盖范围包括：宏观指标（国民经济核算、工业、地产、价格、进出口、财政、货币等近20个领域，覆盖美欧日等发达经济体、亚非拉新兴经济体，以及IMF、OECD等国际组织指标）、行业指标（农林牧渔、采掘、食品饮料、化工等31个行业，提供价格、产量、销量、库存、订单、调查指数及重点上市公司经营数据）、以及其他类指标（产品价格、进出口、产能、价格指数等）。

适用场景：

• "查询近五年中国GDP同比增速数据"
• "获取新能源汽车行业月度销量时间序列"
• "对比美国CPI与核心PCE同比走势"

适合：

• GDP、CPI、PPI、PMI、社融、利率等宏观指标时序
• 行业产量、销量、库存、订单、价格等行业经济数据
• 区域宏观和全球多经济体指标

不适合：

• 个股 / 指数行情 → 用 FinQuery
• 候选筛选 → 用 SmartStockSelection 等
• 研报观点 → 用 FinancialResearchReport
• 公告原文核实 → 用 AnnouncementData
• 资讯舆情 → 用 NewsDataQuery

组合使用：

• 可配合 FinancialResearchReport 获取宏观数据变化背后的研报解读
• 可配合 SmartStockSelection 在宏观周期判断基础上筛选行业
• 可配合 NewsDataQuery 获取宏观行业数据相关的新闻政策舆情

4.3 FinancialResearchReport

一句话定位：券商研报中的观点与叙事

核心能力：本工具支持自然语言提问，提供从券商研报库中信息查询（如查研报、查观点和查事件等），询问相关分析、点评、观点、影响等叙事性内容。包括分析师观点、行业格局判断、公司发展历程、历史事件回溯、市场趋势叙述、案例研究、风险评估等。返回结果为研究报告片段，非数据表格。

适用场景：

• "查找最近三个月关于新能源汽车行业的券商研报"
• "获取某券商对贵州茅台2024年年报的点评观点"
• "搜索提到'AI算力'且评级为'推荐'的研报列表"

适合：

• 观点、趋势判断、影响分析
• 券商点评、行业格局、公司发展叙事
• 投资评级、机构看法

不适合：

• 精确原始数值 → 用 FinQuery 或 MacroIndustryData
• 股票/基金/基金经理列表筛选 → 用 SmartStockSelection / SmartFundSelection / SmartFundManagerSelection
• 公告原文核实 → 用 AnnouncementData
• 资讯舆情 → 用 NewsDataQuery

组合使用：

• 可配合 MacroIndustryData 查询宏观行业数据时补充研报观点
• 可配合 SmartStockSelection 筛选个股后再查找相关研报
• 可配合 NewsDataQuery 获取近期舆情背后的研报解读

4.4 AnnouncementData

一句话定位：A 股上市公司公告原文

核心能力：本工具支持自然语言提问，提供A股上市公司公告库的智能检索，可快速精准获取公告原文披露信息，包括但不限于财务报告、业绩说明会、重大事项、公司治理、权益分派、关联交易、资产重组等全部公开披露内容。返回结果为公告原文片段或数据摘要，非结构化表格。

适用场景：

• "查询某股票2024年年度股东大会决议公告"
• "获取某公司近三个月所有关联交易公告"
• "搜索涉及'业绩承诺'的并购重组公告"

适合：

• 年报、季报、业绩预告、权益分派、重大资产重组、问询函、关联交易等
• 公司治理、合规研判、事件核查的原文凭据

不适合：

• 结构化金融数据查询（营收/PE等） → 用 FinQuery
• 股票/基金/基金经理列表筛选 → 用 SmartStockSelection / SmartFundSelection / SmartFundManagerSelection
• 宏观/行业时序 → 用 MacroIndustryData
• 研报观点 → 用 FinancialResearchReport
• 资讯舆情 → 用 NewsDataQuery

组合使用：

• 可配合 FinQuery 获取已结构化入库的数据（源自公告披露）
• 可配合 FinancialResearchReport 获取研报对公告内容的解读
• 可配合 NewsDataQuery 获取市场舆论对公告内容的反应
• 可配合 SmartStockSelection 筛选出特定事件类型的公司后再查公告

4.5 NewsDataQuery

一句话定位：资讯舆情检索

核心能力：本工具提供基于聚源资讯舆情库的检索功能，支持自然语言提问，帮助用户快速获取金融应用场景下的公开资讯舆情、近期动态、热门事件等高时效性信息。聚源资讯舆情库覆盖财经资讯、宏观新闻、行业新闻、市场动态、公司动态、金融产品动态、政策快讯等，时间范围为2026年1月1日至今。返回结果为资讯摘要或事件片段，非结构化数据。

适用场景：

• "查询最近一周A股市场有哪些重大事件"
• "获取近一个月新能源汽车行业热点新闻"
• "了解某上市公司近期有哪些公开动态"
• "搜索近期政策面有哪些重要消息"

适合：

• 新闻舆情、市场快讯、行业动态
• 个股/行业/宏观相关新闻检索
• 舆情监控、事件追踪

不适合：

• 精确金融数据查询 → 用 FinQuery
• 股票/基金/基金经理列表筛选 → 用 SmartStockSelection / SmartFundSelection / SmartFundManagerSelection
• 宏观/行业时序数据 → 用 MacroIndustryData
• 研报观点 → 用 FinancialResearchReport
• 公告原文 → 用 AnnouncementData

组合使用：

• 可配合 FinQuery 查询金融结构化数据作为资讯舆情内容的交叉验证
• 可配合 AnnouncementData 核实资讯提及的公司公告
• 可配合 FinancialResearchReport 获取资讯背后的研报解读
• 可配合 SmartStockSelection 筛选资讯中提到的相关概念板块
• 可配合 MacroIndustryData 查询资讯涉及的宏观行业时序数据

4.6 SmartStockSelection

一句话定位：多维条件筛选股票候选清单

核心能力：本工具支持自然语言提问，根据财务指标（净利润增速/ROE）、行情指标（涨幅/换手率）、技术指标（均线/MACD）、行业/概念/地域等多维条件筛选，返回结果为符合条件的股票候选清单。仅用于批量筛选股票候选名单，不返回单票详情或叙事内容。

适用场景：

• "筛选净利润增速超过30%且ROE大于15%的消费股"
• "筛选市盈率低于20且ROE大于15%的股票"
• "查找AI算力概念板块近一周涨幅前20的股票"

适合：

• "满足若干条件的股票有哪些"（财务、行情、技术指标组合）
• "XX 指标排名前 N"
• 按行业 / 概念 / 事件筛选股票池

不适合：

• 查单只股票的基本信息或历史数据 → 用 FinQuery
• 研报观点 → 用 FinancialResearchReport
• 宏观/行业时序 → 用 MacroIndustryData
• 基金/基金经理筛选 → 用 SmartFundSelection / SmartFundManagerSelection
• 公告原文核实 → 用 AnnouncementData
• 资讯舆情 → 用 NewsDataQuery

组合使用：

• 可配合 FinQuery 查询筛选个股的详细财务数据
• 可配合 FinancialResearchReport 获取筛选个股的研报观点

4.7 SmartFundSelection

一句话定位：多维条件筛选基金候选清单

核心能力：本工具支持自然语言提问，根据业绩指标、风险指标、持仓特征、基金经理、基金公司、基金类型、成立时间等多维条件筛选，返回结果为符合条件的基金候选清单。仅用于批量筛选基金候选名单，不返回单只基金详情或叙事内容。

适用场景：

• "筛选近一年收益率排名前10%的股票型基金"
• "查找重仓比亚迪且规模超过50亿的基金"
• "筛选夏普比率高于2的回撤小于10%的基金"

适合：

• "满足 XX 条件的基金有哪些"
• "XX 指标排名前 N 的基金"
• "重仓 XX 股票/赛道的基金"
• 按基金类型 / 公司 / 经理筛选

不适合：

• 查单只基金的基本信息或历史净值 → 用 FinQuery
• 研报观点 → 用 FinancialResearchReport
• 宏观/行业时序 → 用 MacroIndustryData
• 股票/基金经理筛选 → 用 SmartStockSelection / SmartFundManagerSelection
• 公告原文核实 → 用 AnnouncementData
• 资讯舆情 → 用 NewsDataQuery

组合使用：

• 可配合 FinQuery 查询筛选基金的持仓明细

4.8 SmartFundManagerSelection

一句话定位：多维条件筛选基金经理候选清单

核心能力：本工具支持自然语言提问，根据基本信息、管理规模、业绩表现、风险控制等多维条件筛选，返回结果为符合条件的基金经理候选清单。仅用于批量筛选基金经理候选名单，不返回单个基金经理详情或叙事内容。

适用场景：

• "筛选管理规模超过100亿且年化收益超过15%的基金经理"
• "查找擅长科技板块、换手率低于100%的基金经理"
• "筛选最大回撤控制在15%以内的百亿明星基金经理"

适合：

• 按管理规模、业绩、风险、风格筛选基金经理

不适合：

• 查单只基金/单个基金经理详情 → 用 FinQuery
• 研报观点/投资叙事 → 用 FinancialResearchReport
• 宏观/行业时序 → 用 MacroIndustryData
• 股票/基金筛选 → 用 SmartStockSelection / SmartFundSelection
• 公告原文核实 → 用 AnnouncementData
• 资讯舆情 → 用 NewsDataQuery

组合使用：

• 可配合 FinQuery 查询筛选基金经理在管产品的具体持仓

4.9 FinDataFallbackQuery

一句话定位：聚合兜底接口，通过 api_name 路由到细分业务

核心能力：本工具是金融数据查询的兜底通道，当主通道工具（FinQuery / MacroIndustryData / NewsDataQuery / FinancialResearchReport / AnnouncementData / SmartStockSelection / SmartFundSelection / SmartFundManagerSelection / IcEnterpriseDataQuery）均无法满足需求时，通过本工具获取精准数据。支持两种调用方式：(1) 指定 api_name 时直接路由到细分业务接口；(2) 未指定 api_name 时直接传递 query，由工具内部自动决策路由，返回结果为数据表格或叙事性内容。

适用场景：

• "查询某理财产品的产品业绩表现"
• "查询最新的政策法规数据"
• "查询工商企业的重大税收违法"

适合：

• 主通道工具找不到所需数据时
• 已知 api_name 的精确路由（如 AShareLiveQuote）
• 未指定 api_name 时直接传递 query，由工具内部自动决策

不适合：

• 结构化数据查询 → 优先用 FinQuery
• 舆情/资讯检索 → 优先用 NewsDataQuery
• 研报观点 → 优先用 FinancialResearchReport
• 公告原文检索 → 优先用 AnnouncementData
• 候选筛选 → 优先用 SmartStockSelection / SmartFundSelection / SmartFundManagerSelection
• 宏观/行业时序数据 → 优先用 MacroIndustryData
• 工商企业数据 → 优先用 IcEnterpriseDataQuery

取数顺序：

1. 路径一（指定）：skill 或用户 query 中已明确 api_name → 直接路由到该细分接口
2. 路径二（兜底）：未指定 api_name 时直接传递 query，由工具内部自动决策

4.10 IcEnterpriseDataQuery

一句话定位：工商企业深度档案与合规风控数据

核心能力：本工具聚焦于工商主体（含A股、港股上市公司及非上市企业）的深度工商档案与企业合规风控数据，覆盖六大主题：工商基础档案（工商基本信息、工商变更信息、高管信息）、股权与治理（直接股东、股权质押、对外担保）、行政许可与授信（行政许可、银行授信）、风险与违法（经营异常、严重违法、失信被执行人、被执行人、限制高消费）、税收违法（欠税公告、纳税非正常户、重大税收违法）、司法涉诉（法院立案、开庭公告、裁判文书、法院公告）及监管处罚。返回结果为数据表格。

适用场景：尽调、信用审查与风险识别

• "查询某企业近一年工商变更记录、股权质押与对外担保明细"
• "查询某企业的银行授信总额、已使用额度及授信机构"
• "查询某企业是否被列入经营异常、严重违法、失信被执行人或限高名单"
• "查询某企业的欠税公告、纳税非正常户与重大税收违法记录"
• "查询某企业涉及的法院立案、开庭公告、裁判文书与法院公告、行政处罚记录"

适合：

• 工商企业基础信息（注册信息、法人、高管、工商变更）
• 股权与治理（直接股东、股权质押、对外担保）
• 行政许可与银行授信
• 合规风险（经营异常、严重违法、失信被执行、限制高消费）
• 税收违法（欠税公告、纳税非正常户、重大税收违法）
• 司法涉诉（法院立案、开庭公告、裁判文书、法院公告）
• 监管处罚

不适合：

• 上市金融标的行情/财务/估值 → 用 FinQuery
• 宏观/行业时序 → 用 MacroIndustryData
• 公告原文核实 → 用 AnnouncementData
• 研报观点 → 用 FinancialResearchReport
• 舆情资讯 → 用 NewsDataQuery

组合使用：

• 可配合 NewsDataQuery 查询企业近期舆情是否与司法/行政处罚事件相关
• 可配合 FinQuery 查询被查询企业作为上市公司时的财务、行情与估值数据，补充工商档案之外的市场表现信息

---

5.1 直接查（条件全满足）

满足以下全部条件可直接调 Tool：

• 标的明确 + 指标明确 + 时间范围明确（或按 §6 默认值安全推断）+ 输出形态清楚

5.2 安全默认（必须写明假设）

歧义低且有稳定行业默认值时，可以默认，但必须在输出里说明用了什么口径。默认值见 §6.2 节。

5.3 必须先澄清（不要猜）

下列情况一定要先问用户：

• 标的不唯一：如"平安"可能是中国平安/平安银行/平安好医生
• 时间口径影响答案：季报/单季/TTM 算出来的"净利润"不同
• 指标定义不唯一：净利润/归母净利润/扣非净利润
• 筛选缺要素：universe（全市场还是某行业）、Top N、排序规则
• 多任务混在一起没说先后（筛选 + 详情 + 观点）

5.4 澄清话术模板

一次只问最关键的一项：

• "你要查的是哪只标的 / 哪一类基金？"
• "时间口径用最新一期、单季度还是 TTM？"
• "筛选范围是全市场，还是某个行业 / 板块？"
• "你想要观点解读还是精确数值？"

---

§6 输入规范化

6.1 标的解析

• 中文俚语 → 标准名：宁王 → 宁德时代 (300750.SZ)、茅台 → 贵州茅台 (600519.SH)
• 裸代码补全：600519 → 600519.SH；000001 需提示用户区分（平安银行 SZ 或上证综指 SH）
• 统一带交易所后缀：A 股 .SH/.SZ，港股 .HK，美股 .O/.N，基金 6 位代码
• 重名先列候选：按 §5.3 澄清

6.2 时间口径默认值表

用户用语	默认窗口
"最近走势"	近 20 个交易日
"这段时间"	近 3 个月
"财报 / 业绩"	近 8 个季度 + 最近年度
"资金流最近"	近 5–20 交易日
"最新公告"	最近一条已披露
"今年以来"	当年 1 月 1 日 至今
"宏观最近"	近 6–12 期（按指标频率）

关键提醒：把"最近"解析成具体日期时，用当前运行时日期，不要硬编码。未来日期 / 非交易日 / start_date > end_date → 自动调整或请求澄清。

6.3 板块口径默认

• 行业 → 申万 / 中信（较稳定口径）
• 概念 → 聚源概念（主题口径）
• 结论依赖具体口径差异时，要明确说明用了哪种分类

---

§7 工具组合调用

7.1 典型组合模式

用户意图	推荐组合
看下 XX 最近怎么样	FinQuery（行情）+ AnnouncementData（催化）+ FinancialResearchReport（观点）
XX 和 YY 谁更强	FinQuery × N（分别拉数据后对比）
最近哪个板块最强	FinQuery（板块行情）→ SmartStockSelection（板块内龙头）
综合研究简报	FinQuery + AnnouncementData + FinancialResearchReport（+ 可选 MacroIndustryData）
筛一批股票后看龙头详情	SmartStockSelection → FinQuery
深度研究：专家视角补充	FinQuery（基础数据）+ FinancialResearchReport（研报观点）
事件驱动：调研跟踪	AnnouncementData（公告核实）+ FinancialResearchReport（研报观点）

7.2 调用顺序规则

• 先筛选 → 再取数：SmartStockSelection 给清单，FinQuery 给详情
• 先公告核实 → 再补研报：AnnouncementData 给事实，FinancialResearchReport 给解读
• 先宏观/行业 → 再补观点：MacroIndustryData 给数值，FinancialResearchReport 给判断

7.3 反向替代禁令

• 研报 ≠ 原始数值（不要用研报凑财务数字）
• 公告 ≠ 筛选结果（不要靠扫公告凑股票清单）
• 筛选工具 ≠ 单对象详情（SmartStockSelection 不替代 FinQuery）

---

§8 Workflow 模板

8.1 单标的快速研究

适用："看下 XX 最近怎么样" / "给我快速研究下 XX"

→ 主用：FinQuery → 辅助：AnnouncementData、FinancialResearchReport

默认流程：

1. 解析标的（重名时澄清）
2. 调 FinQuery 取行情 + 基础指标
3. （可选）调 AnnouncementData 取近期公告
4. （可选）调 FinancialResearchReport 取研报观点
5. 综合输出：一句话结论 + 关键数字 + 催化/观点 + 风险提示

8.2 筛选 + 详情

适用："筛一批高 ROE 的票，再看下龙头的财报"

→ 主用：SmartStockSelection → FinQuery

默认流程：

1. 调 SmartStockSelection 拉候选清单
2. （如需明细）调 FinQuery 拉龙头标的详细数据
3. 输出：候选清单 + 龙头详情 + 标注每段来源

8.3 综合研究简报

适用："帮我写一份 XX 公司的研究报告"

→ 组合：FinQuery + AnnouncementData + FinancialResearchReport

默认流程：

1. 调 FinQuery 取公司基本信息 + 财务数据
2. 调 AnnouncementData 取重大事项
3. 调 FinancialResearchReport 取券商观点
4. 整合输出：公司概况 + 财务分析 + 行业地位 + 催化剂 + 风险提示

---

§9 Query 改写规则

9.1 三条改写原则

1. 实体规范化：把"宁王"改成"宁德时代 (300750.SZ)"
2. 时间补全：用当前运行时日期换算"最近"、"今年以来"
3. 口径拆分：把"强不强"拆成"涨跌幅 + 换手率 + 相对强度"等具体维度

9.2 改写对照表

用户原话	直传（差）	改写后（好）
"宁王最近强不强"	"宁王强不强"	"宁德时代 (300750.SZ) 最近 20 个交易日 涨跌幅、换手率、相对沪深 300 强度"
"茅台财报"	"茅台财报"	"贵州茅台 (600519.SH) 最近 8 个季度 营收、净利润、毛利率、ROE"
"半导体怎么样"	"半导体"	"半导体板块（申万一级）最近 1 个月 涨跌幅、资金净流入、龙头标的"
"高 ROE 的票"	"高 ROE 股票"	"ROE 大于 15% 最新一期，按 ROE 降序排列前 30 只 A 股"
"基金经理"	"基金经理"	"管理规模 100 亿以上 擅长消费 价值风格 基金经理"

9.3 写作要点

主体明确 + 字段明确（避免 NLP 全猜）+ 时间明确 + 单一意图。

---

§10 输出规范

10.1 默认输出结构（5 段式）

除非用户明确只要原始表，否则按以下结构输出：

1. 一句话结论
2. 数据范围与口径（时间、单位、来源、口径）
3. 关键指标 / 关键表格
4. 异常点 / 风险点 / 限制说明
5. 文件路径（如有导出）

10.2 多源数据必须标来源

信息类型	标注格式
公告原文	[公告：标题]
研报观点	[研报：券商]
行情/财务	[FinQuery]
宏观行业	[MacroIndustryData]
筛选结果	[SmartStockSelection: 条件]
资讯舆情	[NewsDataQuery]
工商企业数据	[IcEnterpriseDataQuery]
兜底取数	[FinDataFallbackQuery: api_name]

---

§11 失败回退

Tool 结果为空或异常时：

1. 检查标的是否消歧失败
2. 检查时间/单位/口径是否缺失
3. 检查是否选错工具
4. 只补一个最关键缺口，再重新路由
5. 主通道仍无结果 → FinDataFallbackQuery 兜底 → Web 搜索

区分空结果原因：非交易日 / 未上市或退市 / 区间无数据 / 参数不准确 / 权限不足 / 真错误。

禁止：结果空就盲目扩大搜索、接连试错多个工具、一次性改多个参数后重试。

---

§12 常见错误

错误类型	表现	正确做法
工具错调	用 FinQuery 筛股票清单	用 SmartStockSelection
数据混用	用研报数字当财务数据	研报只用于观点，财务走 FinQuery
标的不消歧	直接查"平安"	先问清楚是中国平安/平安银行/平安好医生
时间硬编码	"最近"写成固定日期	用运行时日期动态计算
口径不说明	直接出净利润	注明是单季/累计/TTM

---

§13 详细字段查询

当用户需要特定字段时，使用以下规范：

财务类

• 营收、净利润、毛利率、ROE、资产负债率
• 现金流（经营/投资/筹资）
• 三费（销售/管理/研发）

行情类

• 涨跌幅、换手率、成交量、成交额
• 市盈率（PE-TTM/PE-静）、市净率（PB）
• 市值、股价、52 周高低

资金流类

• 北向资金、主力资金、龙虎榜
• 净流入/流出、大单/中单/小单

宏观类

• GDP、CPI、PPI、PMI
• 社融、M1/M2、利率
• 行业产量、销量、库存

---

一句话总结

回见本文件"核心边界一句话"（第 7 行）：

精确数值用结构化工具，观点解读用研报，原文核实用公告，候选名单用筛选工具，宏观行业用时序工具，兜底取数用聚合接口。

---

相关文档

• 工具字段详情：./references/tools.md — 10 个工具的输入/输出字段完整参考
• 集成示例：./references/integration-examples.md — Token 配置、调用模式、SDK 示例

---

免责声明： 本服务所生成、展示或输出的内容（包括但不限于文本、数据、分析结果等），部分来源于恒生聚源金融数据库。本服务仅对数据源进行自动化调用、处理与呈现，不构成任何投资决策或其他决策的建议或者承诺，投资者不应以本服务取代其独立判断或仅根据本服务做出决策。数据源本身可能存在不准确、不完整、过时、错误或缺失等情况。由于数据源提供方的限制、技术传输偏差、自然语言歧义或其他客观原因，本服务对所生成、展示或输出内容的真实性、准确性或完整性不做任何保证。本服务的服务提供方及其关联公司不对任何机构或个人因参照本服务所生成、展示或输出内容进行投资、决策而产生的任何后果承担任何责任。市场有风险，投资需谨慎。