---
name: financial-report-ir-intelligence
description: "当用户需要使用咕咕数据公开 API 完成财报解读、业务数据组合、参数传递、接口选型或结果校验时使用；不适用于绕过接口详情页、购买规则或人工复核要求的场景。"
---

# 财报公告与投研报告 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

关键请求参数：

| 参数 | 必填 | 类型 | 默认值 | 说明 | 来源与传递 |
| --- | --- | --- | --- | --- | --- |
| `pageIndex` | 是 | `number` | 1 | 分页参数，页码 | 分页参数由调用方控制，用于分批读取结果 |
| `pageSize` | 是 | `number` | - | 分页参数，每页条数，最大值：100，若传递 0 则返回所有数据 | 分页参数由调用方控制，用于分批读取结果 |
| `stockType` | 是 | `string` | A | 股票类型，A：A股 | 指标类型来自接口详情页中的可选指标说明 |

### 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

关键请求参数：

| 参数 | 必填 | 类型 | 默认值 | 说明 | 来源与传递 |
| --- | --- | --- | --- | --- | --- |
| `symbol` | 是 | `string` | 600519 | A 股股票代码，支持 6 位代码或带市场前缀代码，例如 600519、sh600519、sz000001。 | 证券或基金代码来自代码列表、基金基础信息或用户自选标的 |

### 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

关键请求参数：

| 参数 | 必填 | 类型 | 默认值 | 说明 | 来源与传递 |
| --- | --- | --- | --- | --- | --- |
| `type` | 是 | `string` | - | 三大财报类型，可选值为：资产负债表\|利润表\|现金流量表 | 指标类型来自接口详情页中的可选指标说明 |
| `symbol` | 否 | `string` | YOUR_VALUE | 传递单支股票代码，如: 600031。可通过前置接口或参见 <a href='/enum/stockcn/symbols' target='_blank'>A 股股票代码参数枚举页面</a> | 证券或基金代码来自代码列表、基金基础信息或用户自选标的 |

### 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

关键请求参数：

| 参数 | 必填 | 类型 | 默认值 | 说明 | 来源与传递 |
| --- | --- | --- | --- | --- | --- |
| `symbol` | 否 | `string` | YOUR_VALUE | 传递单支股票代码，如: 600031。可通过前置接口或参见 <a href='/enum/stockcn/symbols' target='_blank'>A 股股票代码参数枚举页面</a> | 证券或基金代码来自代码列表、基金基础信息或用户自选标的 |

### 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

关键请求参数：

| 参数 | 必填 | 类型 | 默认值 | 说明 | 来源与传递 |
| --- | --- | --- | --- | --- | --- |
| `year` | 是 | `integer` | 2024 | 年份 | 财报周期来自用户指定的报告年份、季度或公告期 |
| `symbol` | 是 | `string` | SYMBOL | 股票代码，例如 600686 | 证券或基金代码来自代码列表、基金基础信息或用户自选标的 |
| `quarter` | 是 | `string` | q1 | 季度，可选值：q1, q2, q3, q4 | 财报周期来自用户指定的报告年份、季度或公告期 |

### 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

关键请求参数：

| 参数 | 必填 | 类型 | 默认值 | 说明 | 来源与传递 |
| --- | --- | --- | --- | --- | --- |
| `symbol` | 是 | `string` | 600519 | A 股股票代码，支持 6 位代码或带市场前缀代码，例如 600519、sh600519。 | 证券或基金代码来自代码列表、基金基础信息或用户自选标的 |
| `language` | 否 | `string` | zh | 返回分析语言，例如 zh 或 en。 | 语言参数来自用户指定的源语言、目标语言或语种检测结果 |
| `reportDate` | 否 | `string` | - | 财报日期或报告期，建议使用 yyyyMMdd 或 yyyy-MM-dd；为空时按接口默认可用报告期处理。 | 交易日期需要先结合交易日历判断是否有效 |

### 港股上市公司公告

- 业务角色：港股公告
- 调用阶段：公告数据
- 接口地址：`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

关键请求参数：

| 参数 | 必填 | 类型 | 默认值 | 说明 | 来源与传递 |
| --- | --- | --- | --- | --- | --- |
| `symbol` | 是 | `string` | - | 港股股票代码，必填，示例：00814、01378。具体值参见 <a href='/enum/stockhk/symbols' target='_blank'>港股股票代码参数枚举页面</a>。 | 证券或基金代码来自代码列表、基金基础信息或用户自选标的 |
| `year` | 否 | `integer` | - | 报告所属年度，格式为 4 位年份。例如 year=2025 表示查询 2025 年报或 2025 中报，不按公告发布时间年份过滤。 | 财报周期来自用户指定的报告年份、季度或公告期 |
| `language` | 否 | `string` | en | 公告语言，可选 en 或 zh；en 表示英文公告，zh 表示繁体中文公告，默认 en。 | 语言参数来自用户指定的源语言、目标语言或语种检测结果 |
| `pageindex` | 否 | `integer` | 1 | 分页页码，从 1 开始，默认值为 1。 | 分页参数由调用方控制，用于分批读取结果 |
| `pagesize` | 否 | `integer` | 10 | 每页返回条数，默认值为 10，取值范围为 1~20。 | 分页参数由调用方控制，用于分批读取结果 |
| `sortorder` | 否 | `string` | desc | 公告发布时间排序方式，可选 desc 或 asc；desc 表示倒序，asc 表示正序，默认 desc。 | 由用户输入、业务筛选条件或上一轮接口结果确定。 |
| `reporttype` | 否 | `string` | - | 报告类型过滤，可选 annual 或 interim；annual 表示年报 PDF，interim 表示中报 PDF。不传时返回普通公告列表。 | 指标类型来自接口详情页中的可选指标说明 |

### 港股历年三大财务报表

- 业务角色：港股财报
- 调用阶段：公告数据
- 接口地址：`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

关键请求参数：

| 参数 | 必填 | 类型 | 默认值 | 说明 | 来源与传递 |
| --- | --- | --- | --- | --- | --- |
| `type` | 是 | `string` | - | 三大财报类型，可选值为：资产负债表\|利润表\|现金流量表，传递空值，获取财报基本面数据。 | 指标类型来自接口详情页中的可选指标说明 |
| `indicator` | 是 | `string` | - | 财报时间区间类型，可选值为：年度\|报告期 | 由用户输入、业务筛选条件或上一轮接口结果确定。 |
| `symbol` | 否 | `string` | YOUR_VALUE | 支持传递单个港股股票代码进行筛选，如：00012。具体值参见 <a href='/enum/stockhk/symbols' target='_blank'>港股股票代码参数枚举页面</a> | 证券或基金代码来自代码列表、基金基础信息或用户自选标的 |

### 获取任意链接文章正文

- 业务角色：文章正文
- 调用阶段：内容抽取
- 接口地址：`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

关键请求参数：

| 参数 | 必填 | 类型 | 默认值 | 说明 | 来源与传递 |
| --- | --- | --- | --- | --- | --- |
| `url` | 是 | `string` | YOUR_VALUE | 需要抓取正文的文章链接 | URL 或域名由用户提供，调用前需要确认协议、跳转和可访问性 |
| `contentwithhtml` | 否 | `boolean` | false | 返回的文章是否包含 HTML 标签 | 文本内容来自用户输入、网页正文抽取或文档识别结果 |
| `htmlsourcecontent` | 否 | `boolean` | false | 是否返回文章页面原始 HTML 内容，供您二次解析或分析正文失败时使用，需要注意接口的性能问题 | 文本内容来自用户输入、网页正文抽取或文档识别结果 |

### 文本多语言 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

关键请求参数：

| 参数 | 必填 | 类型 | 默认值 | 说明 | 来源与传递 |
| --- | --- | --- | --- | --- | --- |
| `textContent` | 是 | `string` | N/A | 需要生成摘要的文本内容 | 文本内容来自用户输入、网页正文抽取或文档识别结果 |
| `streaming` | 否 | `boolean` | false | 是否流式响应，如果为 true，那么接口会流式输出纯文本，在最后一个消息输出完整结果的 JSON。 | 由用户输入、业务筛选条件或上一轮接口结果确定。 |

### 多语言长文本 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

关键请求参数：

| 参数 | 必填 | 类型 | 默认值 | 说明 | 来源与传递 |
| --- | --- | --- | --- | --- | --- |
| `textContent` | 是 | `string` | N/A | 需要提取关键词的文本内容 | 文本内容来自用户输入、网页正文抽取或文档识别结果 |
| `keywordMaxLength` | 否 | `integer` | 5 | 单个关键字长度限制，不传递默认长度为 5 个字符 | 关键词由用户输入或从上一轮内容抽取结果中生成 |
| `streaming` | 否 | `boolean` | false | 是否流式响应，如果为 true，那么接口会流式输出纯文本，在最后一个消息输出完整结果的 JSON。 | 由用户输入、业务筛选条件或上一轮接口结果确定。 |

### 多语言文本 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

关键请求参数：

| 参数 | 必填 | 类型 | 默认值 | 说明 | 来源与传递 |
| --- | --- | --- | --- | --- | --- |
| `textContent` | 是 | `string` | N/A | 需要进行情感分析的文本内容 | 文本内容来自用户输入、网页正文抽取或文档识别结果 |
| `streaming` | 否 | `boolean` | false | 是否流式响应，如果为 true，那么接口会流式输出纯文本，在最后一个消息输出完整结果的 JSON。 | 由用户输入、业务筛选条件或上一轮接口结果确定。 |

### 多语言 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

关键请求参数：

| 参数 | 必填 | 类型 | 默认值 | 说明 | 来源与传递 |
| --- | --- | --- | --- | --- | --- |
| `language` | 是 | `string` | - | 目标语言，目标语言支持自然语言或者 ISO 639 language code，如日语、日文、jp、japanese | 语言参数来自用户指定的源语言、目标语言或语种检测结果 |
| `content` | 是 | `string` | - | 需要翻译的文本内容 | 文本内容来自用户输入、网页正文抽取或文档识别结果 |
| `streaming` | 否 | `boolean` | false | 是否流式响应，如果为 true，那么接口会流式输出纯文本，在最后一个消息输出完整结果的 JSON。 | 由用户输入、业务筛选条件或上一轮接口结果确定。 |

## 数据校验与使用边界

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

## 输出建议

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

## 常见问题

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