# 技能：全球财经快讯服务 (Global Financial News Recap)

## 技能简介
这是一个提供全球财经快讯数据的 API 服务，可以获取：
- 📰 实时财经快讯（综合多个数据源）
- 📊 市场情绪指标
- 🚀 涨停池分析
- 📉 跌停池分析
- 🔁 连板池分析
- 💥 炸板池分析
- 📈 大盘联动数据
- 💰 融资融券统计
- 🎯 概念板块数据
- 📚 全量汇总信息（市场情绪 / 大盘联动 / 融资融券 / 概念板块 / 财经快讯 / 涨停池分析 / 跌停池分析 / 连板池分析 / 炸板池分析）
- 🏢 股票基本信息查询

## 基础信息
- **API 基础 URL**: `https://recap-service.your-subdomain.workers.dev`
- **响应格式**: Markdown
- **请求方法**: GET

## 可用接口

### 1. 🏠 API 文档首页
**端点**: `/`

获取完整的 API 文档和所有可用接口的说明。

**示例请求**:
```
GET /
```

### 2. 📰 财经快讯
**端点**: `/telegraph`

获取全球财经快讯数据，支持优先级、时间范围和数据源筛选。

**查询参数**:
| 参数 | 描述 | 可选值 | 默认值 | 示例 |
|------|------|--------|--------|------|
| priority | 优先级过滤 | 1/2/3/ALL | ALL | ?priority=1 |
| duration | 时间范围 | Nd（N为天数） | 0d | ?duration=-3d |
| sources | 数据源 | cls,mknews,gelonghui | cls,mknews,gelonghui | ?sources=cls |

**参数说明**:
- `priority`:
  - `1` = 最高优先级（CLS A级 + MK News 重要 + 格隆汇 level=1）
  - `2` = 高优先级（CLS A+B级 + MK News）
  - `3` = 所有新闻
  - `ALL` = 所有新闻（同3）
- `duration`:
  - `0d` = 今天
  - `-1d` = 昨天
  - `-3d` = 最近3天（今天+昨天+前天）
  - 负数表示从今天往前的N天聚合数据
- `sources`:
  - `cls` = 数据源A
  - `mknews` = MK News
  - `gelonghui` = 格隆汇
  - 可组合多个，用逗号分隔

**使用示例**:
```
# 获取最高优先级的今天快讯（按时间排序）
GET /telegraph?priority=1&duration=0d

# 获取最近3天的所有快讯（按时间排序）
GET /telegraph?duration=-3d

# 获取高优先级的所有数据源快讯（按时间排序）
GET /telegraph?priority=2&sources=cls,mknews,gelonghui
```

> 注意：电报快讯按时间倒序排列（最新消息在前），priority 参数用于过滤而不是排序。

### 3. 🔄 刷新快数据
**端点**: `/telegraph/refresh`

手动刷新并存储最新的财经快讯数据。

**查询参数**:
| 参数 | 描述 | 可选值 | 默认值 | 示例 |
|------|------|--------|--------|------|
| sources | 要刷新的数据源 | cls,mknews,gelonghui | cls,mknews,gelonghui | ?sources=cls |

**使用示例**:
```
# 刷新所有数据源
GET /telegraph/refresh

# 只刷新特定数据源
GET /telegraph/refresh?sources=cls
```

### 4. 📊 市场情绪
**端点**: `/emotion`

获取市场情绪指标，包括市场温度、成交量、封板率等。

**使用示例**:
```
GET /emotion
```

### 5. 🚀 涨停池分析
**端点**: `/uppool`

获取涨停股票分析数据，包含涨停原因和板块信息。

**使用示例**:
```
GET /uppool
```

### 6. 📉 跌停池分析
**端点**: `/downpool`

获取跌停股票分析数据，包含跌停原因和板块信息。

**使用示例**:
```
GET /downpool
```

### 7. 🔁 连板池分析
**端点**: `/chainpool`

获取连板股票分析数据，包含连板原因和板块信息。

**使用示例**:
```
GET /chainpool
```

### 8. 💥 炸板池分析
**端点**: `/brokenpool`

获取炸板股票分析数据，包含炸板原因和板块信息。

**使用示例**:
```
GET /brokenpool
```

### 9. 📈 大盘联动
**端点**: `/anchor`

获取板块涨跌与大盘的关联分析数据。

**使用示例**:
```
GET /anchor
```

### 10. 💰 融资融券
**端点**: `/finance`

获取沪深两市融资融券数据统计。

**使用示例**:
```
GET /finance
```

### 11. 🎯 概念板块
**端点**: `/concept`

获取概念板块涨跌统计和资金流向数据。

**使用示例**:
```
GET /concept
```

### 12. 📚 全量汇总
**端点**: `/summary`

汇总输出 `/emotion`、`/anchor`、`/finance`、`/concept`、`/telegraph`、`/uppool`、`/downpool`、`/chainpool` 和 `/brokenpool` 的所有信息。

**查询参数**: 与 `/telegraph` 一致（`priority`、`duration`、`sources`）。

**使用示例**:
```
GET /summary
```

### 13. 🏢 股票信息
**端点**: `/stock`

查询指定股票的基本信息。

**查询参数**:
| 参数 | 描述 | 必填 | 示例 |
|------|------|------|------|
| code | 股票代码 | 是 | ?code=sz002461 |

**股票代码格式**:
- 深交所：sz + 6位数字（如：sz002461）
- 上交所：sh + 6位数字（如：sh600036）

**使用示例**:
```
# 查询深交所股票
GET /stock?code=sz002461

# 查询上交所股票
GET /stock?code=sh600036
```

## 使用场景示例

### 场景1：获取今日重要财经快讯
```
GET /telegraph?priority=1&duration=0d
```

### 场景2：查看最近3天所有快讯汇总
```
GET /telegraph?priority=ALL&duration=-3d&sources=cls,mknews,gelonghui
```

### 场景3：了解当前市场状况
```
# 查看市场情绪
GET /emotion

# 查看涨停情况
GET /uppool

# 查看跌停情况
GET /downpool

# 查看连板情况
GET /chainpool

# 查看炸板情况
GET /brokenpool

# 查看概念板块表现
GET /concept

# 一次性查看所有信息
GET /summary
```

### 场景4：查询特定股票信息
```
GET /stock?code=sz002461
```

### 场景5：刷新数据源
```
# 刷新特定数据源
GET /telegraph/refresh?sources=cls

# 刷新所有数据源
GET /telegraph/refresh
```

## 注意事项
1. 所有接口返回 Markdown 格式，便于阅读
2. 数据会定时自动刷新，也可手动刷新
3. 使用时请遵守相关数据源的使用条款
4. 股票代码必须包含交易所前缀（sz/sh）

## 错误处理
如果请求的路径不存在，会返回 404 状态码和可用路由列表。