每日从集思录抓取可转债基本数据、强赎倒计时、下修倒计时，支持Cookie管理和本地持久化存储

SKILL.md

---
name: jisilu-cb-daily
description: 每日从集思录 webapi 抓取可转债基本数据、强赎倒计时、下修倒计时，支持Cookie管理和本地持久化存储
---

## 前置依赖

- Python 3.8+
- 依赖包：`requests`, `pandas`
- 集思录账号（需要登录后的 `kbzw__user_login` 和 `kbzw__Session` Cookie）

## Cookie 管理规范

### 存储位置
Cookie 存储在 Skill 目录下的 `references/cookie.json`：
```json
{
  "kbzw__user_login": "用户输入的cookie值",
  "kbzw__Session": "用户输入的session值",
  "updated_at": "2026-04-28"
}
```

### 检查逻辑
1. 每次执行任务前，先检查 `references/cookie.json` 是否存在且包含 `kbzw__user_login` 和 `kbzw__Session`
2. 如果任一不存在或为空，**立即停止数据抓取**，向用户发送以下提示：

   ```
   【集思录登录Cookie缺失】

   本Skill需要两个Cookie才能获取完整数据（尤其是cb/list等会员数据）：

   1. kbzw__user_login
   2. kbzw__Session

   请按以下步骤获取：
   1. 用Chrome/Edge打开 https://www.jisilu.cn/ 并登录账号
   2. F12打开开发者工具 → Application/应用 → Cookies → https://www.jisilu.cn
   3. 分别找到 kbzw__user_login 和 kbzw__Session，复制它们的Value值
   4. 依次将两个Cookie值粘贴给我

   获取后我将自动保存，后续每日抓取无需重复输入。
   ```

3. 收到用户提供的 Cookie 后，写入 `references/cookie.json`，然后继续执行

## 数据源与接口

### 接口1：可转债基本数据
- **URL**: `https://www.jisilu.cn/webapi/cb/list/`
- **方法**: GET
- **Headers**:
  ```
  User-Agent: Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36
  Referer: https://www.jisilu.cn/web/data/cb/list
  Cookie: kbzw__user_login={cookie值}; kbzw__Session={session值}
  ```
- **返回格式**: JSON 平铺数组，直接取 `data` 字段
  ```json
  {
    "data": [
      {
        "bond_id": "123045",
        "bond_nm": "某转债",
        "price": 105.50,
        "increase_rt": 1.23,
        "stock_nm": "某正股",
        "sprice": 10.50,
        "sincrease_rt": 2.10,
        "convert_price": 12.50,
        "convert_value": 84.00,
        "premium_rt": 25.60,
        "force_redeem_price": 16.25,
        "put_convert_price": 8.75,
        "year_left": 3.52,
        "ytm_rt": 2.35,
        "rating_cd": "AA+",
        "dblow": 131.10,
        "force_redeem": null,
        "maturity_dt": "2027-06-15"
      }
    ]
  }
  ```

### 接口2：强赎倒计时数据
- **URL**: `https://www.jisilu.cn/webapi/cb/redeem/`
- **方法**: GET
- **Headers**: 同上，需携带 Cookie
- **返回格式**: JSON 平铺数组 `data`
- **关键字段**:
  - `bond_id`: 转债代码
  - `bond_nm`: 转债名称
  - `redeem_count`: 已满足强赎天数
  - `redeem_trigger`: 强赎触发条件（如 15/30）
  - `redeem_status`: 强赎状态（如"公告强赎"、"暂不强赎"、"倒计时中"）
  - `redeem_price`: 赎回价格
  - `last_redeem_dt`: 最后交易日

### 接口3：下修倒计时数据（主表，340条全量）
- **URL**: `https://www.jisilu.cn/webapi/cb/adjust/`
- **方法**: GET
- **Headers**: 同上，需携带 Cookie
- **返回格式**: JSON 平铺数组 `data`
- **关键字段**:
  - `bond_id`: 转债代码
  - `bond_nm`: 转债名称
  - `adjust_count`: 已满足下修天数
  - `adjust_trigger`: 下修触发条件
  - `adjust_status`: 下修状态（如"已公告下修"、"董事会提议"、"倒计时中"）
  - `adjust_price`: 拟下修价格（如有）
  - `adjust_dt`: 下修股东大会日期

## 执行工作流

### Step 1: Cookie 检查与准备
```python
import json, os

cookie_path = os.path.join(os.path.dirname(__file__), "../references/cookie.json")

if not os.path.exists(cookie_path):
    raise FileNotFoundError("Cookie文件缺失，请按Skill说明提供 kbzw__user_login 和 kbzw__Session")

with open(cookie_path, "r", encoding="utf-8") as f:
    cookie_data = json.load(f)

kbzw_cookie = cookie_data.get("kbzw__user_login", "")
kbzw_session = cookie_data.get("kbzw__Session", "")
if not kbzw_cookie or not kbzw_session:
    raise ValueError("kbzw__user_login或kbzw__Session为空，请重新提供")
```

### Step 2: 抓取下修倒计时数据（主表）
- 使用 `requests.get()` 访问 `https://www.jisilu.cn/webapi/cb/adjust/`
- 携带 Cookie: `kbzw__user_login={kbzw_cookie}; kbzw__Session={kbzw_session}`
- 解析 JSON，直接取 `data` 字段为 DataFrame（约340条全量数据）

### Step 3: 抓取强赎倒计时数据
- 使用相同 Cookie 访问 `https://www.jisilu.cn/webapi/cb/redeem/`
- 解析 JSON，直接取 `data` 字段
- 以 `bond_id` 为键，**LEFT JOIN** 到下修主表

### Step 4: 抓取基本数据
- 使用相同 Cookie 访问 `https://www.jisilu.cn/webapi/cb/list/`
- 解析 JSON，直接取 `data` 字段
- 以 `bond_id` 为键，**LEFT JOIN** 到已有数据

### Step 5: 数据清洗与保存

#### 清洗规则
1. **价格字段**：去除 `%` 符号，转为 float
2. **涨跌幅**：同上处理
3. **日期字段**：统一转为 `YYYY-MM-DD` 格式
4. **空值处理**：`force_redeem` 为空表示"暂不强赎"；`adjust_status` 为空表示"未触发下修"
5. **去重**：按 `bond_id` 去重，保留最新记录

#### 保存格式
数据保存为 CSV，按日期命名：

```
output/
└── jisilu_cb_2026-04-28.csv
```

CSV 必须包含以下核心字段：
| 字段名 | 来源 | 说明 |
|--------|------|------|
| bond_id | adjust（主表） | 转债代码 |
| bond_nm | adjust（主表） | 转债名称 |
| price | list | 转债现价 |
| increase_rt | list | 转债涨跌幅 |
| stock_nm | list | 正股名称 |
| sprice | list | 正股现价 |
| premium_rt | list | 溢价率 |
| convert_price | list | 转股价 |
| year_left | list | 剩余年限 |
| ytm_rt | list | 到期收益率 |
| rating_cd | list | 评级 |
| dblow | list | 双低值 |
| force_redeem_price | list | 强赎触发价 |
| put_convert_price | list | 回售触发价 |
| redeem_status | redeem | 强赎状态 |
| redeem_count | redeem | 已满足强赎天数 |
| adjust_status | adjust（主表） | 下修状态 |
| adjust_count | adjust（主表） | 已满足下修天数 |
| adjust_dt | adjust（主表） | 下修股东大会日期 |
| data_date | 系统生成 | 数据日期（YYYY-MM-DD）|

### Step 6: 结果汇报
向用户汇报当日数据概况：
```
【集思录可转债数据抓取完成】
日期：2026-04-28
共抓取转债：XXX 只
其中：
- 公告强赎：XX 只
- 强赎倒计时中：XX 只
- 已公告下修：XX 只
- 下修倒计时中：XX 只

数据已保存至：output/jisilu_cb_2026-04-28.csv
```

## 异常处理

| 异常场景 | 处理方式 |
|----------|----------|
| Cookie 失效（返回 403/登录页） | 提示用户重新输入 Cookie，删除旧 cookie.json |
| 接口返回空数据 | 记录日志，重试最多 3 次，仍失败则跳过该接口 |
| 网络超时 | 设置 timeout=30s，重试 3 次 |
| 字段缺失 | 用空值填充，不中断流程 |
| 日期解析失败 | 保留原始字符串，标注"解析异常" |

## 定时执行建议

如需每日自动执行，可在本地 OpenClaw 中配合 cron/systemd：
```bash
# 每天 15:30 收盘后执行
30 15 * * * cd ~/.config/agents/skills/jisilu-cb-daily && python scripts/collect_jisilu_cb.py
```

或在 Kimi Claw 对话中每日发送指令：
```
执行 jisilu-cb-daily Skill 抓取今日可转债数据
```