今日投资金融数据

技能文档

---
name: investoday-finance-data
title: 今日投资金融数据
category: 办公效率
description: "获取中国市场金融数据与投研信息，覆盖 A股、港股、基金、指数、财务、公告、研报和宏观经济等 200+ 接口。当用户需要查股票走势、基金净值、指数行情、财务报表、估值指标、公告研报、机构观点、宏观数据、板块主题、产业链、市场统计，或需要拉取、导出、对比结构化金融数据时触发。触发词：金融数据、股票行情、基金净值、财务数据、宏观经济。"
---

# 今日投资金融数据

获取中国金融市场数据与投研信息，覆盖 A 股、港股、基金、指数、行情、财务、公告、研报、新闻、宏观经济等数据。

## 技能工作流

### 步骤1：识别用户需求

判断用户要解决的问题属于以下哪类：

- **行情 / 趋势**：看最近走势、涨跌表现、成交活跃度、相对强弱
- **财务 / 估值**：看财报、利润趋势、估值水平、现金流、分红、指标变化
- **公告 / 研报 / 新闻**：查最近公告、催化、机构关注点、研究观点
- **基金 / ETF / 指数**：查净值、行情、成分、基金资料、基金业绩
- **板块 / 主题 / 产业链**：看哪些板块更强、主题热度、产业链关系和经营分析
- **宏观 / 市场**：看 CPI、PPI、PMI、利率、市场统计和其他宏观数据
- **数据导出 / 研究准备**：拉一份结构化数据，供后续分析、比较或回测

典型用户话术：

- 帮我查下某只股票最近走势
- 看下基金净值或 ETF 表现
- 我想导出财务数据
- 查一下最近公告、研报或机构观点
- 对比几家公司财务指标
- 看看最近哪个板块更强
- 拉一份宏观经济或市场统计数据

### 步骤2：定位数据接口

根据需求定位具体接口：

- **接口不明确**：用 `investoday-api list` 浏览分组，或用 `investoday-api search-api` 按关键词搜索接口
- **接口明确但参数不明确**：用 `investoday-api search-api` 查询接口说明、参数和示例
- **接口和参数都明确**：直接进入步骤3

用户说自然语言时，先理解任务，不要先回到接口名和字段名。优先把：

- "最近" 解释成合理时间窗
- "财报" 解释成最近几个季度或最近年度
- "强不强" 解释成走势、相对表现和活跃度
- "催化" 解释成公告、研报、新闻、政策等可用口径

### 步骤3：调用数据接口

执行 `investoday-api <endpoint> [key=value ...]` 获取数据。

```bash
# 初始化运行环境（首次使用需执行）
investoday-api init

# 浏览多级分组和叶子菜单
investoday-api list <group/subgroup/leaf>

# 按关键词搜索接口（query、tool_ids 支持多个入参，以英文逗号隔开）
investoday-api search-api query=<query> tool_ids=<tool_ids>

# 发起数据请求
investoday-api <endpoint> [key=value ...]
```

调用示例：

```bash
# 列举分组
investoday-api list
investoday-api list 沪深京数据
investoday-api list 沪深京数据/公司行为/基本信息

# 关键词搜索
investoday-api search-api query=股票,基本面分析

# 工具信息搜索
investoday-api search-api tool_ids=list_stock_report_schema

# 调用数据
investoday-api search key=贵州茅台 type=11
investoday-api stock/basic-info stockCode=600519
investoday-api fund/daily-quotes --method POST fundCode=000001 beginDate=2024-01-01 endDate=2024-12-31
```

### 步骤4：处理结果与异常

- **结果为空**：说明查询口径、时间范围或数据覆盖可能不支持，不要把空结果解释成确定性结论
- **缺少参数**：先说明缺少哪些参数，并给出可继续查询的最小参数
- **未初始化**：如果 `investoday-api init` 尚未执行，先提示执行初始化再继续查询
- **网络或权限问题**：明确说明当前无法取得数据，并停止基于该数据继续推断

## 不适用场景

- 直接给出买卖建议或替代投资顾问
- 自动下单或执行交易
- 查询非金融数据、系统端口、服务器状态或其他运维问题
- 在数据不可得、时间范围不合理或接口无结果时硬编结论
- 实现复杂回测引擎、组合优化系统或交易系统本身

## 安装要求

需要 Node.js 18+ 和 Node 包 `@investoday/investoday-api`。

`investoday-api init` 用于初始化 CLI 的本地运行环境配置，可能会创建或更新 CLI 使用的本地配置文件。

## 辅助文档

- 文档版接口索引见：`docs/references-index.md`

使用说明

# 今日投资金融数据

获取中国金融市场数据，覆盖 A 股、港股、基金、指数、财务、公告、研报、宏观经济等 200+ 数据接口。

## 使用

```bash
# 首次使用需初始化环境
investoday-api init

# 按关键词搜索接口
investoday-api search-api query=股票,基本面分析

# 调用具体数据接口
investoday-api stock/basic-info stockCode=600519
investoday-api fund/daily-quotes --method POST fundCode=000001 beginDate=2024-01-01 endDate=2024-12-31
```

## 工作原理

通过 `investoday-api` CLI 工具调用中国市场金融数据接口，支持股票行情、基金净值、财务报表、估值指标、研报公告、宏观经济等数据查询。先用 `list` 或 `search-api` 定位接口，再直接调用获取结构化数据。

## 支持场景

- 查看股票、港股、指数、基金最近走势
- 查询公司财务趋势、估值和经营表现
- 梳理公告、研报、新闻和机构观点
- 查看板块、主题、产业链和市场热度
- 查看宏观经济和市场统计数据
- 导出研究数据供后续分析使用

## 安装要求

- Node.js 18+
- Node 包 `@investoday/investoday-api`

如何安装此技能？

访问技能市场，点击「安装」按钮，按提示将技能包放入 AI 编程助手的 skills 目录即可。