cn-hk-dividend-fhpg-api

by funkygod

Install this Skill

curl -fsSL -o cn-hk-dividend-fhpg-api.zip https://skill.seembox.com/api/v1/skills/cn-hk-dividend-fhpg-api/download && unzip cn-hk-dividend-fhpg-api.zip

Download cn-hk-dividend-fhpg-api.zip

SKILL.md About

---
name: cn-hk-dividend-fhpg-api
description: 基于服务端 HTTP API 查询中国A股分红配股与港股分红数据（含股息率）。用户提到A股、港股、分红、派息、股息率、分红配股等需求时使用本技能。
homepage: http://clawhub.ai/FunkyGod/cn-hk-dividend-fhpg-api
---

# 中国A股分红配股与港股分红数据 Skill（基于服务端 API）

## 适用场景

在以下场景下优先使用本 Skill：

- 用户提到 **中国A股或港股** 的公司，例如 “腾讯”、“中国平安”、“600519”、“0700.HK”
- 用户需要 **分红/配股相关数据**：
  - A股分红配股列表与详情
  - 港股分红列表与详情
- 用户需要 **分红/派息相关数据**：
  - 历史分红记录（每股派息、送股、转增）
  - 分红频率（年度/中期/季度）
  - 股息率、近几年分红稳定性
- 用户提到：**“看某只股票的财务情况 / 分红历史 / 分红率 / 分红政策”** 等类似描述

> 重要：本仓库 **已实现分红/配股相关的 HTTP API**，但 **未实现财务报表接口**。因此本 Skill 仅处理分红/配股与股息率相关问题；若用户要求财报数据，应明确当前仓库不支持并建议补充数据源。

---

## 使用总原则

1. **统一入口，清晰步骤**
   - 先把用户自然语言需求转成 **结构化查询条件**（市场、代码/名称、时间区间、报表类型等）
   - 再调用项目中 **已实现的 HTTP API** 获取数据
   - 最后对数据进行 **摘要 + 解释 + 风险提示**

2. **强制说明数据范围与滞后性**
   - 例如：财报通常是 **按季/按年披露**，存在滞后
   - 分红为 **历史行为**，不等同于未来承诺

3. **输出时，先结论、再细节**
   - 第一段先说清：盈利是否稳定、负债情况、高/低分红等
   - 后面再给出关键指标表格或列表

---

## 数据访问约定（以服务端实现为准）

该服务提供 **无需登录** 的 REST API，用于获取港股分红与 A 股分红配股数据。所有接口均为 **只读**。

> Base URL：`http://vi-money.com/`（需确认是否为实际对外地址；如未确认，调用方必须先核验协议/端口）
> 建议通过环境变量 `STOCK_API_BASE_URL` 覆盖该地址，避免硬编码。

### 通用响应格式（所有接口一致）

```json
{
  "code": 0,
  "message": "ok",
  "data": {}
}
```

- `code = 0` 表示成功
- `code = 400/404/500` 表示错误（缺参、未找到、服务端错误）
- 错误时 `data` 通常为 `null`

### 港股分红 API（`/api/v1/hk-stock`）

- `GET /api/v1/hk-stock/dividend`
  - 说明：港股分红列表（每只股票仅保留最新一条记录）
  - 查询参数：`page`、`limit`、`keyword`、`sort_by`、`sort_order`
  - 默认排序：`sort_by=announce_date`，`sort_order=desc`
  - 返回：`data.list`、`data.total`
- `GET /api/v1/hk-stock/dividend/detail/:code`
  - 说明：某只港股完整分红历史（按公告日降序）
  - 参数：`:code`（如 `0700`）
  - 返回：`data.code`、`data.list`

**港股分红字段说明（`models/hk_dividend_detail.go`）**

- `code`：股票代码
- `name`：股票名称（由 `hk_stock_code` 关联补充）
- `fiscal_year`：财年
- `announce_date`：公告日期
- `ex_date`：除权除息日
- `dividend_plan`：分红方案文本
- `distribution_type`：派息类型
- `transfer_deadline`：过户截止日
- `payout_date`：派息日

### A 股分红配股 API（`/api/v1/cn-stock`）

- `GET /api/v1/cn-stock/fhpg`
  - 说明：A 股分红配股列表（分页 + 联合搜索）
  - 查询参数：`page`、`limit`、`code`、`name`、`plan_progress`、`bonus_type`、`cash_div`、`share_div`、`allotment`、`dividend_yield_min`、`dividend_yield_max`、`announcement_year`、`sort_by`、`sort_order`
  - 默认排序：`sort_by=dividend_yield`，`sort_order=desc`
  - 返回：`data.list`、`data.total`
- `GET /api/v1/cn-stock/fhpg/detail/:code`
  - 说明：某只 A 股分红配股详情（按最新公告日期降序）
  - 参数：`:code`（如 `600519`）
  - 返回：`data.code`、`data.name`、`data.list`

**A 股分红配股列表字段说明（`models/stock_fhps_em.go`）**

- `code`：股票代码
- `name`：股票名称
- `latest_announcement_date`：最新公告日期（列表每只股票只保留一条）
- `report_date`：报告期
- `plan_progress`：方案进度（如预案/已实施/已通过）
- `bonus_type`：送转类型
- `cash_div`：派息文本
- `share_div`：送股文本
- `allotment`：配股文本
- `dividend_yield`：股息率（小数）
- `ex_dividend_date`：除权除息日
- `net_profit_yoy`：净利润同比（可能为空）
- 其他字段（如 `eps`、`navps`、`transfer_ratio` 等）保留但一般不作为首要摘要

**A 股分红配股详情字段说明（`models/stock_fhps_detail_em.go`）**

- `latest_announcement_date`：最新公告日期（排序与图表横轴）
- `report_date`：报告期末日期
- `plan_progress`：方案进度
- `bonus_type`：送转类型
- `cash_div`：派息
- `share_div`：送股
- `allotment`：配股
- `dividend_yield`：股息率（小数）
- `content`：详情正文（可能较长）
- `analysis`：分析文本（可能较长）
- `images_json`：图片/图表 URL 或 JSON

---

## 操作流程

### 1. 解析用户意图

从用户问题中抽取：

- **市场**：A股 / 港股
  - 若用户说 “600519”“贵州茅台”，默认 A股（CN）
  - 若说 “0700.HK”“腾讯控股”，默认 港股（HK）
- **标的**：股票代码或公司名称
  - 可在项目内实现名称到代码的映射：如 `resolve_symbol(name_or_code)`
- **时间范围**：
  - 若未指定，默认 **近 3~5 年分红记录**
  - A 股列表可用 `announcement_year` 限定公告年
- **数据类型**：
  - 分红：历史分红记录、股息率、分红稳定性等
  - 配股/送转：送股、转增、配股信息

### 2. 调用数据接口

按意图调用对应 HTTP API，例如（伪代码）：

```text
# 港股：分红列表
GET /api/v1/hk-stock/dividend?page=1&limit=20&keyword=腾讯&sort_by=announce_date&sort_order=desc

# 港股：分红详情
GET /api/v1/hk-stock/dividend/detail/0700

# A股：分红配股列表（按股息率过滤）
GET /api/v1/cn-stock/fhpg?page=1&limit=20&dividend_yield_min=0.02&dividend_yield_max=0.08&sort_by=dividend_yield&sort_order=desc

# A股：分红配股详情
GET /api/v1/cn-stock/fhpg/detail/600519
```

> 要求：输出时说明股息率字段是 **小数**（如 `0.04` 表示 4%）。

---

## 进行分析与总结

在生成自然语言回答时，建议按以下结构组织：

1. **总体概览（1 段）**
   - 分红是否连续、是否集中在特定年份
   - 股息率区间是否稳定
   - 是否存在一次性大额分红/送转

2. **关键指标列表**
   - 近 3~5 年的分红/配股记录（按公告日期或年份简表）
   - 指标示例：分红方案、股息率、除权除息日、送股/转增/配股

3. **分红情况**
   - 是否持续分红（几年中有缺分红年份）
   - 近几年平均股息率区间（例如 2%–4%）
   - 特殊一次性大额分红需要单独说明

4. **风险与限制说明（必选）**
   - 数据为历史数据，不代表未来表现
   - 分红政策可能会根据经营情况变化
   - 若数据存在缺失或不完整，需要明确指出
   - 本仓库 **不提供财报口径数据**，如用户请求财报，需提示范围限制

---

## 输出格式建议

回答时优先使用 **中文**，并尽量结构化：

- **文字 + 项目符号列表**
- **简表形式**（可用 Markdown 表格，但要简洁）

示例输出结构（示意）：

```markdown
**结论概览**

- 公司近 5 年收入和净利润整体呈上升趋势，盈利能力较为稳定。
- 净利率保持在 20% 左右，ROE 在 15%–18% 区间，盈利质量较好。
- 资产负债率约 40%–45%，杠杆水平适中。

**近 5 年分红/配股记录（示意）**

| 公告日 | 分红方案 | 股息率 | 除权除息日 | 送股 | 转增 | 配股 |
| ------ | -------- | ------ | ---------- | ---- | ---- | ---- |
| 2024-xx-xx | ... | ... | ... | ... | ... | ... |
| 2023-xx-xx | ... | ... | ... | ... | ... | ... |

**分红情况（近 5 年）**

- 共实施现金分红 X 次，其中 Y 年连续分红。
- 近 5 年平均股息率约 Z%，最高年份约 W%。
- 分红较为稳定 / 存在停牌或暂停分红年份，需要注意。

**风险提示**

- 以上数据均为历史披露数据，不构成投资建议。
- 分红政策可能随公司经营环境和董事会决策调整。
- 本仓库不提供财报与预测，请结合其他数据源单独分析。
```

---

## 示例对话用法

**示例 1：查看港股公司分红历史**

> 用户：
> “帮我看看 0700.HK 这家公司最近几年的分红情况，股息率大概多少？”

- 解析：市场=HK，代码=0700.HK，需求=分红历史 + 股息率
- 调用：`GET /api/v1/hk-stock/dividend/detail/0700`
- 输出：总结近几年是否分红、分红方案、股息率区间、是否稳定

**示例 2：对比A股公司财务与分红**

> 用户：
> “把贵州茅台最近 5 年的盈利情况和分红情况总结一下。”

- 解析：市场=CN，symbol=600519（通过名称解析）
- 调用：`GET /api/v1/cn-stock/fhpg/detail/600519`
- 输出：总结分红/配股频率与股息率

---

## 开发者检查清单

在项目里真正启用本 Skill 前，请确认：

- [ ] 已实现 **分红数据接口**（含分红金额、股息率等关键字段）
- [ ] 函数、结构体、字段均有清晰中文注释，说明 **单位/币种/比例含义**
- [ ] 若使用外部数据源（聚宽、TuShare、券商 API 等），已处理好：
  - [ ] 鉴权/Token 管理
  - [ ] 调用频率限制
  - [ ] 网络错误与数据缺失的容错
- [ ] 本 SKILL.md 内容已根据真实实现的函数名/字段名进行同步调整

_meta.json Metadata

{
  "ownerId": "kn79ty6bhy4kzkqegnq58rk8jx82dz1f",
  "publishedAt": 1773757388330,
  "slug": "cn-hk-dividend-fhpg-api",
  "version": "1.0.2"
}