Investoday Finance Data

---
name: investoday-finance-data
title: 今日投资金融数据
version: 1.8.4
description: "获取中国市场金融数据与投研信息，覆盖 A股、港股、基金、指数、财务、公告、研报和宏观经济等 200+ 接口。Use when: 查询行情数据、财务数据、公告研报、基金指数数据、宏观经济数据。"
tags:
  - stock
  - fund
  - etf
  - index
  - bond
  - a-share
  - hk-stock
  - china-market
  - financial-data
  - market-data
  - quote
  - realtime-quote
  - financial-statement
  - balance-sheet
  - income-statement
  - cash-flow
  - valuation
  - dividend
  - ipo
  - announcement
  - research-report
  - analyst-rating
  - macro-economics
  - quantitative
  - investment-research
  - portfolio
  - backtesting
  - data-api
  - finance-api
  - 股票
  - 基金
  - 行情
  - 财务
  - A股
  - 港股
  - 指数
  - 宏观经济
  - 研报
  - 公告
  - 量化
  - 投研
metadata:
  clawdbot:
    emoji: "📈"
    category: "finance"
requirements:
  node: 18+
  packages:
    - name: "@investoday/investoday-api"
  network_access: true
---
# 今日投资金融数据 Skill

获取中国金融市场金融数据，覆盖A股、港股、指数、市场、研报、新闻、实时、宏观经济等数据。

## 典型场景

适合用这个 skill 的常见任务：

- 看某只股票、港股、指数或基金最近走势
- 查公司基本资料、财务趋势、估值和经营表现
- 梳理公告、研报、新闻和投资评级
- 看板块、主题、产业链和市场热度
- 查看宏观经济和市场数据
- 导出研究数据，供后续分析、对比或回测使用

先理解用户要解决的问题，再决定是浏览分组、搜索接口，还是直接调用具体接口。

## 何时使用

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

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

## 不适合什么

这个 skill 不适合：

- 直接给出买卖建议或替代投资顾问
- 自动下单或执行交易
- 在数据不可得、时间范围不合理或接口无结果时硬编结论
- 实现复杂回测引擎、组合优化系统或交易系统本身

如果数据权限、时间范围或接口能力有限，要明确说出限制。

## 自然语言触发指南

即使用户没有说接口名、字段名或 `investoday-api`，只要意图符合以下表达，也应该触发本 skill：

- 看看这只股票最近怎么样
- 帮我快速研究一下 XX
- 帮我看下财报
- 最近有什么公告或催化
- 最近哪个板块最强
- 帮我看下基金净值或 ETF 表现
- 把这几个公司对比一下
- 给我拉份数据
- 导出成 CSV

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

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

## 安装 & 使用

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

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

## CLI命令参考
```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 init

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

# 关键词搜索
investoday-api search-api query=股票,基本面分析
# 工具信息搜索
investoday-api search-api tool_ids=list_stock_violation_penalt,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
```

## 使用策略
- 未明确接口，使用search-api或list查找
- 明确接口,不明确使用方式,使用 search-api来获取接口使用方式。
- 明确接口及使用方式，直接调用。

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