财报公告与投研报告 Skill

面向上市公司财报解读、公告跟踪、投资者关系材料和投研报告草稿的公开 API 组合。

业务场景

用于上市公司财报解读、公告跟踪、投资者关系材料、投研报告草稿和跨市场资料整理。适合把证券代码、公司基础信息、财务报表、财务指标、业绩报表、港股公告、文章抽取、摘要、关键词、情感和翻译组合成投研文档链路。

• 数据范围：覆盖 A 股代码、公司基础信息、三大财务报表、财务指标、业绩报表、AI 财报解读、港股公告、港股财报、文章正文、摘要、关键词、情感和翻译。
• 关键数据维度：公司维度：证券代码、名称、市场、行业和基础资料。；财务维度：年份、季度、报表类型、指标、同比环比和公告时间。；文本维度：公告标题、正文、摘要、关键词、情感和目标语言。

何时使用

• 围绕股票代码汇总公司基础信息、三大报表、财务指标和业绩数据。
• 对公告、年报或新闻内容做摘要、关键词、情感和多语言处理。
• 为 IR、投研、资讯或内部看板生成可复核的报告草稿。

不适用场景

• 用户只需要查看某一个接口的完整参数、响应字段、价格或购买入口时，直接打开接口详情页。
• 用户希望绕过接口开通、鉴权、配额或人工复核要求时，不应使用 Skill 作为替代。
• 任务需要法律、医疗、金融投资或升学录取的最终决策时，Skill 只能提供数据辅助和复核线索。

用户需要提供的信息

• 股票代码、上市市场、报告年份、季度、公告类型、公司名称和输出语言。
• 输出目标：财报摘要、公告跟踪、投资者关系材料、投研草稿或风险提示。
• 调用接口所需的 AppKey、开通状态和接口详情页限制。

推荐工作流

1. 先用证券代码和公司基础信息确认上市主体。
2. 再查询财报、财务指标、业绩报表、公告或文章原文。
3. 最后用摘要、关键词、情感和翻译接口生成可复核报告材料。

参数传递关系

• 先用证券代码和公司基础信息确认上市主体，再把 symbol 传给年报、财务指标、业绩报表和 AI 财报解读接口。
• 公告类任务按港股公告或外部文章 URL 获取原文，再传给摘要、关键词、情感和翻译接口。
• 报告年份、季度和公告日期必须分开记录，避免把交易日当作财务报告期。
• 多语言输出时先完成财务口径解释，再做翻译，避免直接翻译导致指标含义丢失。

典型任务模板

• 财报摘要：输入股票代码、年份和季度；输出核心指标、同比变化、AI 解读、风险提示和详情页链接。
• 公告跟踪：输入港股代码或公告 URL；输出公告摘要、关键词、情感倾向和待复核事项。
• IR 材料草稿：输入公司代码和目标语言；输出公司简介、财务亮点、公告摘要和翻译稿。

接口与关键参数

统一鉴权：调用接口前需要准备咕咕数据 AppKey。推荐在服务端通过 Header 传递 AppKey；历史 Query 参数 appkey 仍以接口详情页说明为准。

A 股股票代码

• 业务角色：A 股代码
• 调用阶段：基础数据
• 接口地址：GET https://api.gugudata.com/stock/symbols
• 产出用途：用于确认 A 股证券代码。
• 参数来源：分页参数由调用方控制，用于分批读取结果；指标类型来自接口详情页中的可选指标说明
• 接口详情页：https://www.gugudata.com/api/details/stocksymbols
• 接口 Markdown：https://www.gugudata.com/api/details/stocksymbols/llm.md

关键请求参数：

A 股个股信息查询

• 业务角色：上市公司基础信息
• 调用阶段：基础数据
• 接口地址：GET https://api.gugudata.com/stock/cn/fundamentalinfo
• 产出用途：用于获取公司基础资料。
• 参数来源：证券或基金代码来自代码列表、基金基础信息或用户自选标的
• 接口详情页：https://www.gugudata.com/api/details/fundamentalinfo
• 接口 Markdown：https://www.gugudata.com/api/details/fundamentalinfo/llm.md

关键请求参数：

A 股历年三大财务报表

• 业务角色：A 股三大财报
• 调用阶段：财务数据
• 接口地址：GET https://api.gugudata.com/stock/cn/annualreport
• 产出用途：用于查询资产负债表、利润表和现金流量表。
• 参数来源：指标类型来自接口详情页中的可选指标说明；证券或基金代码来自代码列表、基金基础信息或用户自选标的
• 接口详情页：https://www.gugudata.com/api/details/cnannualreport
• 接口 Markdown：https://www.gugudata.com/api/details/cnannualreport/llm.md

关键请求参数：

A 股历年财务指标

• 业务角色：财务指标
• 调用阶段：财务数据
• 接口地址：GET https://api.gugudata.com/stock/cn/financialindicator
• 产出用途：用于查询历年财务指标。
• 参数来源：证券或基金代码来自代码列表、基金基础信息或用户自选标的
• 接口详情页：https://www.gugudata.com/api/details/financialindicator
• 接口 Markdown：https://www.gugudata.com/api/details/financialindicator/llm.md

关键请求参数：

A 股业绩报表数据

• 业务角色：业绩报表
• 调用阶段：财务数据
• 接口地址：GET https://api.gugudata.com/stock/cn/performance-statement
• 产出用途：用于查询业绩快报和报表数据。
• 参数来源：财报周期来自用户指定的报告年份、季度或公告期；证券或基金代码来自代码列表、基金基础信息或用户自选标的
• 接口详情页：https://www.gugudata.com/api/details/performance-statement
• 接口 Markdown：https://www.gugudata.com/api/details/performance-statement/llm.md

关键请求参数：

A 股财报 AI 智能解读

• 业务角色：财报 AI 解读
• 调用阶段：智能分析
• 接口地址：POST https://api.gugudata.com/ai/stock-financial-report-analysis
• 产出用途：用于生成财务报告分析摘要。
• 参数来源：证券或基金代码来自代码列表、基金基础信息或用户自选标的；语言参数来自用户指定的源语言、目标语言或语种检测结果；交易日期需要先结合交易日历判断是否有效
• 接口详情页：https://www.gugudata.com/api/details/stock-financial-report-analysis
• 接口 Markdown：https://www.gugudata.com/api/details/stock-financial-report-analysis/llm.md

关键请求参数：

港股上市公司公告

• 业务角色：港股公告
• 调用阶段：公告数据
• 接口地址：GET https://api.gugudata.com/stock/hk/bulletin
• 产出用途：用于查询港股上市公司公告。
• 参数来源：证券或基金代码来自代码列表、基金基础信息或用户自选标的；财报周期来自用户指定的报告年份、季度或公告期；语言参数来自用户指定的源语言、目标语言或语种检测结果；分页参数由调用方控制，用于分批读取结果
• 接口详情页：https://www.gugudata.com/api/details/stockhkbulletin
• 接口 Markdown：https://www.gugudata.com/api/details/stockhkbulletin/llm.md

关键请求参数：

港股历年三大财务报表

• 业务角色：港股财报
• 调用阶段：公告数据
• 接口地址：GET https://api.gugudata.com/stock/hk/annualreport
• 产出用途：用于查询港股公司财报。
• 参数来源：指标类型来自接口详情页中的可选指标说明；证券或基金代码来自代码列表、基金基础信息或用户自选标的
• 接口详情页：https://www.gugudata.com/api/details/hkannualreport
• 接口 Markdown：https://www.gugudata.com/api/details/hkannualreport/llm.md

关键请求参数：

获取任意链接文章正文

• 业务角色：文章正文
• 调用阶段：内容抽取
• 接口地址：POST https://api.gugudata.com/news/fetchcontent
• 产出用途：用于抽取公告或新闻正文。
• 参数来源：URL 或域名由用户提供，调用前需要确认协议、跳转和可访问性；文本内容来自用户输入、网页正文抽取或文档识别结果
• 接口详情页：https://www.gugudata.com/api/details/fetchcontent
• 接口 Markdown：https://www.gugudata.com/api/details/fetchcontent/llm.md

关键请求参数：

文本多语言 AI 摘要

• 业务角色：文本摘要
• 调用阶段：文本理解
• 接口地址：POST https://api.gugudata.com/ai/text-summarize
• 产出用途：用于压缩公告、新闻或报告正文。
• 参数来源：文本内容来自用户输入、网页正文抽取或文档识别结果
• 接口详情页：https://www.gugudata.com/api/details/summarize-text
• 接口 Markdown：https://www.gugudata.com/api/details/summarize-text/llm.md

关键请求参数：

多语言长文本 AI 关键字提取

• 业务角色：关键词提取
• 调用阶段：文本理解
• 接口地址：POST https://api.gugudata.com/ai/keyword-extraction
• 产出用途：用于提炼财报和公告关键词。
• 参数来源：文本内容来自用户输入、网页正文抽取或文档识别结果；关键词由用户输入或从上一轮内容抽取结果中生成
• 接口详情页：https://www.gugudata.com/api/details/keyword-extraction
• 接口 Markdown：https://www.gugudata.com/api/details/keyword-extraction/llm.md

关键请求参数：

多语言文本 AI 情感分析

• 业务角色：情感分析
• 调用阶段：文本理解
• 接口地址：POST https://api.gugudata.com/ai/sentiment-analysis
• 产出用途：用于判断公告或新闻情绪倾向。
• 参数来源：文本内容来自用户输入、网页正文抽取或文档识别结果
• 接口详情页：https://www.gugudata.com/api/details/sentiment-analysis
• 接口 Markdown：https://www.gugudata.com/api/details/sentiment-analysis/llm.md

关键请求参数：

多语言 AI 翻译

• 业务角色：多语言翻译
• 调用阶段：内容输出
• 接口地址：POST https://api.gugudata.com/ai/multilingual-translation
• 产出用途：用于生成英文或其他语言 IR 材料。
• 参数来源：语言参数来自用户指定的源语言、目标语言或语种检测结果；文本内容来自用户输入、网页正文抽取或文档识别结果
• 接口详情页：https://www.gugudata.com/api/details/multilingual-translation
• 接口 Markdown：https://www.gugudata.com/api/details/multilingual-translation/llm.md

关键请求参数：

数据校验与使用边界

• 财务报告期和交易日不是同一口径，必须分别标注。
• AI 解读只用于资料整理和研究辅助，不构成投资建议。
• 公告、年报和新闻摘要必须保留原文来源以便复核。

输出建议

• 输出报告时按公司信息、财务摘要、公告摘要、风险提示和来源链接分段。
• 对跨语言材料保留原文链接、译文和关键指标中文解释。
• 缺失报表或公告时标注数据缺口，不用零值代替。

常见问题

• 问：什么情况下应该使用这个 Skill？ 答：当用户提出的目标需要多个咕咕数据公开 API 组合完成，而不是只查询一个接口时，优先阅读这个 Skill。
• 问：这个 Skill 是否需要单独购买？ 答：不需要。Skill 文档只负责业务流程和接口选型，具体接口购买、价格和账号权益仍以接口详情页为准。
• 问：Agent 应该怎样使用这个 Skill？ 答：Agent 应先阅读 SKILL.md，确认业务场景和推荐工作流，再进入接口详情页核对参数、响应字段、价格和调用示例。
• 问：调用接口前需要先核对什么？ 答：需要核对业务对象、地区、时间范围、输入格式、必填参数、返回字段、购买状态和接口详情页中的限制说明。
• 问：财报公告与投研报告 Skill 会替代接口文档吗？ 答：不会。Skill 负责说明业务组合和调用顺序，接口参数、响应结构、计费和购买入口仍以接口详情页为准。