基金详情获取（韭才说 / jiucaishuo）

Goal: 通过 scripts/get_fund_info.py 调用韭才说基金详情接口，获取并格式化展示某只基金的完整详情数据（基金经理、基金基本信息、最大套牢天数、年化收益、收益率、换手率等）。

接口信息

| 项 | 值 | |----|----| | 地址 | https://govip.jiucaishuo.com/v2/account-book/get-fund-info | | 方式 | POST | | 请求头 | Content-Type: application/json | | 请求体 | {"fund_code": "159801"} | | 返回 | {"code": 0, "message": "", "data": "<详情长文本>"} |

fund_code：基金代码，如 159801（芯片ETF广发）、510300、000001 等。
code 为 0 表示成功；非 0 时 message 携带错误原因。
data 是一段包含多个板块（经理基本信息 / 基金基本信息 / 基金最大套牢 / 年化收益 / 收益率 / 换手率等）的长文本。

When to Use

用户出现以下意图之一时加载本 skill：

"查一下 159801 这只基金的详情"
"帮我把 XX 基金的信息整理出来"
"这只基金套牢多少天 / 年化收益多少 / 基金经理是谁"
任何涉及 fund_code 或韭才说 get-fund-info 接口的请求

When NOT to Use

需要基金实时行情 / 净值 / 估值等接口未包含的实时数据（本接口不含）
需要下单、交易、账户操作等写操作（本接口为只读查询）
用户只聊基金投资观点、不涉及查询具体基金详情数据

核心原则

必须使用脚本：所有查询通过 scripts/get_fund_info.py 执行，不要手写 curl 临时拼请求体。
先确认基金代码：若用户未给出明确 fund_code，先询问或根据名称/上下文确认代码再调用。
失败要提示：接口返回非 0 或网络异常时，向用户说明具体原因（见错误码 / 下方排错）。
默认易读输出：默认输出解析后的 Markdown 文本；调试或二次处理时使用 --raw / --json。

脚本使用

脚本位置：<skill-directory>/scripts/get_fund_info.py（Python3，仅依赖标准库，无需安装）

<skill-directory> 指本 Skill 所在目录，即 jiucaishuo-fund-info/。

查询单个基金（默认易读 Markdown）

python3 <skill-directory>/scripts/get_fund_info.py 159801
# 或显式指定
python3 <skill-directory>/scripts/get_fund_info.py --fund-code 159801

批量查询多个基金

python3 <skill-directory>/scripts/get_fund_info.py 159801 510300 000001

输出原始 JSON（调试）

python3 <skill-directory>/scripts/get_fund_info.py 159801 --raw

输出结构化 JSON（含解析后的分段，便于二次处理 / 接入其他流程）

python3 <skill-directory>/scripts/get_fund_info.py 159801 --json

自定义接口地址

python3 <skill-directory>/scripts/get_fund_info.py 159801 --url https://your-proxy/get-fund-info

输出格式说明

默认（无参数）：将 data 长文本解析为 Markdown，每个板块作为 ### 标题，板块内条目作为 - 列表项，方便直接在对话 / 文档中展示。
--raw：原样输出接口 JSON 响应。
--json：输出 {fund_code, code, message, sections:[{title, lines}]} 结构，便于程序消费。

示例

用户说："查一下 159801 的基金详情"

执行：

python3 <skill-directory>/scripts/get_fund_info.py 159801

得到类似输出：

## 基金详情 · 159801

### 基金基本信息
- 基金名称：芯片ETF广发，基金类型：指数型-股票，最新规模：66.97亿，基金成立日：2020-01-20，比较基准：国证半导体芯片指数收益率，投资目标：紧密跟踪标的指数...，托管人：工商银行，申购状态：场内交易，赎回状态：场内交易。

### 基金最大套牢
- 近1月套牢28天
- 近3月套牢28天
- 近6月套牢90天
- 近1年套牢99天
- ...

### 年化收益
- 近1月年化-98.61%
- 近三月年化84.11%
- ...

排错

| 现象 | 原因 / 处理 | |------|------------| | 网络错误 / 请求异常 | 检查网络连通性、接口地址是否正确，或临时用 --url 切换代理 | | 接口返回非 0 状态码 | 基金代码可能无效或接口限流，确认 fund_code 是否正确 | | 返回内容为空 / 板块缺失 | 该基金可能无对应数据（如新发基金、特殊类型），属正常情况 | | 返回内容不是合法 JSON | 接口可能返回了 HTML 错误页，检查 URL 与网络环境 |

安全提示

本接口为只读查询，不携带用户凭证 / Token，可安全调用。
不要在脚本或对话中硬编码非公开凭证；如未来接口需要鉴权，应通过环境变量注入。