韭圈儿基金数据统一查询（jiucaishuo）

Goal：把原先分散的韭圈儿相关 skill 合并为单一 skill，并在其上扩展股债性价比模块（国债收益率 / 股市温度 / FED风险溢价），通过 scripts/jiucaishuo.py 一个 CLI 暴露全部能力。所有请求统一走脚本，不要把请求细节写死在对话里。

能力总览

| 子命令 | 能力 | 数据源 API | | --- | --- | --- | | manager | 基金经理简介（履历/规模/年化/在管基金/持仓风格/获奖） | POST v4/open-ai-v2/person-desc11 | | nav | 基金历史单位净值（走势/统计/CSV/JSON 导出） | GET v4/open-ai/jz（无需鉴权） | | info | 基金详情（基本信息/套牢天数/年化/收益率/换手率） | POST v2/account-book/get-fund-info | | qdii | QDII 申购/赎回限额（暂停/限大额/开放/场内，可筛选导出） | POST v4/open-ai/fund-sx-qdii | | fear-greed | 韭圈恐贪指数（最新读数/分档/走势） | GET v4/open-ai/kt | | gz | 股债性价比总览（国债收益率+股市温度+FED风险溢价，三接口汇总） | POST vip.jiucaishuo.com/gz/gz/{zhai,fed,gu} | | bond | 中国十年期国债收益率（最新值+债券温度） | POST vip.jiucaishuo.com/gz/gz/zhai | | fed | 股债性价比风险溢价（FED/股息率，可指定指数与回看年数） | POST vip.jiucaishuo.com/gz/gz/fed | | temp | 股市温度（万得全A，温度+3年盈利概率） | POST vip.jiucaishuo.com/gz/gz/gu | | index | 指数估值分栏列表（行业/主题/策略/规模/精选/境外/其他的 PE/PB/股息率/ROE 估值分位与区间收益，可排序/翻页/导出） | POST govip.jiucaishuo.com/indexvaluation/industry/group-list | | index-data | 指数估值详细历史数据（指定指数 code 的收盘价/PE/PB/ROE 时间序列，支持时间范围筛选） | POST pre.jiucaishuo.com/v4/open-ai/index-data | | stage | 基金阶段涨幅（涨跌幅/同类平均/同类排名，覆盖近1日~成立来等区间，可筛选区间/多基金/导出） | POST govip.jiucaishuo.com/funddetail/changepercent/achieve |

When to Use（按意图路由）

基金经理类："朱少醒是谁""查一下张坤的资料""基金经理简介" → manager
净值类："查 159801 历史净值""基金净值走势""导出净值 CSV" → nav
基金详情类："159801 的详情""这只基金套牢多少天/年化多少" → info
QDII 限额类："哪些 QDII 暂停申购""QDII 限额""查 006555 申购状态" → qdii
情绪类："恐贪指数多少""市场恐惧还是贪婪""韭圈恐贪" → fear-greed
股债性价比类："股债性价比多少""国债收益率多少""股市温度""FED风险溢价""股息率溢价""现在该买股还是买债""股票便宜还是债券便宜" → gz（总览）/ bond / fed / temp
指数估值分栏类："查行业指数估值""主题指数 PE 百分位""境外指数列表""指数估值分栏""排序看 PB 百分位最低的指数""导出指数估值 CSV" → index
指数估值详细历史数据类："查 399975.SZ 历史估值""某指数 PE 历史走势""指数估值时间序列""指数历史 PE/PB/ROE" → index-data
基金阶段涨幅类："查 005851 阶段涨幅""近1年涨了多少""同类排名多少""和同类平均比怎么样""区间涨幅""成立以来收益""阶段收益" → stage

股债性价比（gz / bond / fed / temp）

数据源为 vip.jiucaishuo.com/gz/gz/{zhai,fed,gu}，需要鉴权：脚本默认内置一个 authtoken，也可用环境变量 JIUCAISHUO_GZ_AUTHTOKEN 覆盖（token 失效时只改这个变量即可，无需改脚本）。

三个底层接口与含义：

zhai → 中国十年期国债收益率（债券端机会成本）
fed → 股债性价比风险溢价（股票端相对债券的便宜程度）
gu → 股市温度（万得全A 估值温度 + 买入持有3年盈利概率）

调用方式

# 股债性价比总览（一键看三件事）
$PY $SKILL/scripts/jiucaishuo.py gz
$PY $SKILL/scripts/jiucaishuo.py gz --gu-code 沪深300 --pe-category gxl --year 10

# 单独查：国债收益率
$PY $SKILL/scripts/jiucaishuo.py bond

# 单独查：股债性价比风险溢价（FED风险溢价 / 股息率溢价，可换指数）
$PY $SKILL/scripts/jiucaishuo.py fed
$PY $SKILL/scripts/jiucaishuo.py fed --gu-code 沪深300
$PY $SKILL/scripts/jiucaishuo.py fed --gu-code 中证500 --pe-category gxl --year 10

# 单独查：股市温度
$PY $SKILL/scripts/jiucaishuo.py temp

# 任意子命令加 --raw 输出原始 JSON
$PY $SKILL/scripts/jiucaishuo.py gz --raw

`fed` / `gz` 参数

| 参数 | 必填 | 说明 | |------|------|------| | --gu-code | 否 | 指数名称或代码，默认万得全A；支持沪深300/中证500/上证50/中证1000/中证800/恒生指数或对应代码 | | --pe-category | 否 | fed（FED风险溢价 = 1/市盈率 − 国债收益率，默认）/ gxl（股息率溢价 = 股息率 − 国债收益率） | | --year | 否 | 历史分位回看年数，默认 5，可选 10 |

输出要点

bond：最新十年期国债收益率 + 债券温度（平台指标，越高代表国债收益率处历史越低位 → 债券越贵）。
temp：股市温度 0–100 + 平台直白的「温度适中/均衡配置」结论 + 该温度带买入持有3年盈利概率。
fed/gz：风险溢价数值、区间均值、历史分位（如 23.13% 表示仅比历史上 23.13% 的时间更便宜）、平台温度带（极低温～极高温）、以及平台原文解读（含回测持有一年收益率/胜率）。
三者均属估值/温度类指标，不是投资建议；呈现时建议附「风险溢价越高 = 股票相对债券越便宜，越适合多配股票」。

依赖 / 鉴权

标准库即可，需可访问外网 vip.jiucaishuo.com。
authtoken 通过环境变量 JIUCAISHUO_GZ_AUTHTOKEN 提供，缺省使用脚本内置默认值。

通用约定

脚本为纯 Python（标准库 urllib/json/csv/argparse），跨平台：Windows/Linux/macOS 均可 python3/python 直接运行，无需安装第三方包，无需 bash。
仅 qdii 需要浏览器式 User-Agent（脚本已内置，无需关心）。
正文输出到 stdout，提示/错误输出到 stderr，互不污染，便于二次处理。
数据源为 pre.jiucaishuo.com（jz/kt/person-desc11/fund-sx-qdii/index-data）与 govip.jiucaishuo.com（get-fund-info、get-a-fund-info、indexvaluation/industry/group-list、funddetail/changepercent/achieve 阶段涨幅），均为只读查询，不携带用户凭证（阶段涨幅为公开数据，authtoken 可留空；group-list 的公开分类连 authtoken 都不需要；仅「自选」等需登录分类才传 token）；股债性价比模块（gz/bond/fed/temp）数据源为 vip.jiucaishuo.com/gz/gz，需 authtoken（见上节，可用环境变量覆盖）。

调用方式

# 用受管 Python 运行（推荐）
PY=~/.workbuddy/binaries/python/versions/3.13.12/bin/python3
SKILL=~/.workbuddy/skills/jiucaishuo

# 基金经理简介
$PY $SKILL/scripts/jiucaishuo.py manager "朱少醒"
$PY $SKILL/scripts/jiucaishuo.py manager --person 张坤

# 基金历史净值（最近 10 日 + 统计）
$PY $SKILL/scripts/jiucaishuo.py nav 159801 --last 10 --stats
$PY $SKILL/scripts/jiucaishuo.py nav 159801 --start 2025-01-01 --end 2025-06-30
$PY $SKILL/scripts/jiucaishuo.py nav 159801 --format csv -o /workspace/nav.csv

# 基金详情（单只 / 多只 / 原始 JSON / 结构化 JSON）
$PY $SKILL/scripts/jiucaishuo.py info 159801
$PY $SKILL/scripts/jiucaishuo.py info 159801 510300
$PY $SKILL/scripts/jiucaishuo.py info 159801 --raw
$PY $SKILL/scripts/jiucaishuo.py info 159801 --json


# QDII 限额
$PY $SKILL/scripts/jiucaishuo.py qdii                      # 全量表格
$PY $SKILL/scripts/jiucaishuo.py qdii --suspended          # 仅暂停申购
$PY $SKILL/scripts/jiucaishuo.py qdii --code 006555        # 指定代码
$PY $SKILL/scripts/jiucaishuo.py qdii --name 纳斯达克       # 名称模糊
$PY $SKILL/scripts/jiucaishuo.py qdii --category QDII债券 --limited --sort limit
$PY $SKILL/scripts/jiucaishuo.py qdii --status suspended    # 申购侧筛选
$PY $SKILL/scripts/jiucaishuo.py qdii --on-exchange         # 仅场内
$PY $SKILL/scripts/jiucaishuo.py qdii --format summary      # 分布统计
$PY $SKILL/scripts/jiucaishuo.py qdii --format csv --output qdii.csv

# 韭圈恐贪指数
$PY $SKILL/scripts/jiucaishuo.py fear-greed                 # 最新 + 近 10 日走势
$PY $SKILL/scripts/jiucaishuo.py fear-greed --days 20
$PY $SKILL/scripts/jiucaishuo.py fear-greed --date 2026-07-28
$PY $SKILL/scripts/jiucaishuo.py fear-greed --raw           # 全量历史 JSON

# 指数估值分栏列表（group-list）
$PY $SKILL/scripts/jiucaishuo.py index --categories          # 列出全部可用分类（id/名称/types/是否展示）
$PY $SKILL/scripts/jiucaishuo.py index --category 境外        # 境外指数估值（默认第 1 页，含 PE/PB/股息率/ROE 分位 + 标签）
$PY $SKILL/scripts/jiucaishuo.py index --category 5 --page 2  # 用 id 指定，翻到第 2 页
$PY $SKILL/scripts/jiucaishuo.py index --category 行业 --sort PE百分位 --order asc   # 按列排序
$PY $SKILL/scripts/jiucaishuo.py index --category 主题 --all  # 抓该分类全部记录（自动翻页去重）
$PY $SKILL/scripts/jiucaishuo.py index --category 境外 --format json   # 结构化 JSON
$PY $SKILL/scripts/jiucaishuo.py index --category 境外 --format csv -o /workspace/abroad.csv
$PY $SKILL/scripts/jiucaishuo.py index --category 境外 --page 1 --raw   # 指定页原始 JSON

# 指数估值详细历史数据（index-data）
$PY $SKILL/scripts/jiucaishuo.py index-data 399975.SZ                       # 默认近一个月
$PY $SKILL/scripts/jiucaishuo.py index-data 399975.SZ --start 2026-05-01    # 从 5-01 到当天
$PY $SKILL/scripts/jiucaishuo.py index-data 399975.SZ --start 2026-10-01 --end 2026-10-14  # 指定区间
$PY $SKILL/scripts/jiucaishuo.py index-data 399975.SZ --format json         # 结构化 JSON
$PY $SKILL/scripts/jiucaishuo.py index-data 399975.SZ --format csv -o /workspace/idx.csv
$PY $SKILL/scripts/jiucaishuo.py index-data 399975.SZ --raw                 # 原始二维表 JSON

# 基金阶段涨幅（stage）
$PY $SKILL/scripts/jiucaishuo.py stage 005851                              # 默认表格：涨跌幅/同类平均/同类排名（全区间）
$PY $SKILL/scripts/jiucaishuo.py stage 005851 159801                      # 多基金（位置参数）
$PY $SKILL/scripts/jiucaishuo.py stage 005851 -c 159801                   # 多基金（等价写法）
$PY $SKILL/scripts/jiucaishuo.py stage 005851 --periods 近1月,近1年,成立来   # 仅看指定区间
$PY $SKILL/scripts/jiucaishuo.py stage 005851 --format json               # 结构化 JSON
$PY $SKILL/scripts/jiucaishuo.py stage 005851 --format csv -o /workspace/stage.csv
$PY $SKILL/scripts/jiucaishuo.py stage 005851 --raw                       # 原始 JSON 响应

Windows 把 ~/.workbuddy/... 换成对应绝对路径，分隔符用反斜杠；命令用 python 而非 python3。

各子命令参数

`manager`

| 参数 | 必填 | 说明 | |------|------|------| | person | 是 | 基金经理姓名，如朱少醒（位置参数或 --person） |

退出码：0 成功 / 1 参数缺失 / 2 接口或网络错误 / 3 查无此人
is_many=1（同名多人）时会在 stderr 提示，照常呈现 stdout 结果即可。

`nav`

| 参数 | 必填 | 说明 | |------|------|------| | fund_code | 是 | 基金代码，如 159801 | | --start / --end | 否 | 日期范围（含） | | --last N | 否 | 最近 N 个交易日 | | --format | 否 | table(默认)/json/csv | | --stats | 否 | 附加统计摘要（区间最高/最低、累计涨跌幅等） | | -o,--output | 否 | 写入文件 |

`info`

| 参数 | 必填 | 说明 | |------|------|------| | fund_codes | 是 | 一个或多个基金代码（位置参数或 -c/--fund-code） | | --raw | 否 | 输出原始 JSON 响应 | | --json | 否 | 输出结构化 JSON（含解析后分段，与 --raw 互斥） | | --url | 否 | 自定义接口地址（默认官方） |

`qdii`

| 参数 | 必填 | 说明 | |------|------|------| | --code | 否 | 按基金代码精确筛选 | | --name | 否 | 按名称关键词模糊筛选 | | --category | 否 | 按细分类型筛选，如 QDII债券 / QDII股票 | | --status | 否 | open/limited/suspended/redeem-open/redeem-suspended | | --suspended / --limited / --on-exchange | 否 | 快捷筛选 | | --sort | 否 | limit（按限额）/ code（按代码） | | --format | 否 | table(默认)/json/csv/summary | | --output | 否 | 写入文件 |

sx 标签含义：开放申购 / 限大额(单日限X元) / 暂停申购 / 开放赎回 / 暂停赎回 / 场内交易。
详见 references/api_reference.md。

`fear-greed`

| 参数 | 必填 | 说明 | |------|------|------| | --raw | 否 | 输出完整原始 JSON 列表（全量历史） | | --days N | 否 | 展示最近 N 个交易日（默认 10） | | --date | 否 | 查询指定日期读数，如 2026-07-28 |

分档：0–10 极度恐惧 / 10–30 恐惧 / 30–50 中性 / 50–70 贪婪 / 70–100 极度贪婪。
退出码：0 成功 / 1 参数错误 / 2 接口或网络错误 / 3 无数据或日期不存在。

`index`

| 参数 | 必填 | 说明 | |------|------|------| | --categories | 否 | 列出全部可用分类（id/名称/types/是否展示），来自接口 titles 字段 | | --category | 否 | 分类名称或 id，如 行业 / 5 / 境外（名称支持精确与模糊匹配） | | --page | 否 | 页码，默认 1（注意：第 1 页通常是「精选预览」子集，第 2 页起才是完整列表） | | --all | 否 | 抓取该分类全部记录（自动翻页并去重，公开分类无需 token） | | --sort | 否 | 按列名排序，如 PE百分位 / 最新PE / 近1年（自动映射为接口的 field val） | | --order | 否 | 排序方向 asc / desc | | --field | 否 | 原始排序字段 val（与 --sort 二选一，优先级更高） | | --authtoken | 否 | 鉴权 token（仅「自选」等需登录的分类需要；公开分类留空即可） | | --format | 否 | table(默认)/json/csv | | --raw | 否 | 输出指定页原始 JSON（不翻页） | | -o,--output | 否 | 写入文件 |

列名动态取自接口的 head 字段：估值类分类（行业/主题/策略/规模/精选/境外）展示最新PE / PE百分位 / 最新PB / PB百分位 / 股息率 / 股息率分位 / ROE；收益类分类（其他）展示近1日 / 本周 / 本月 / 今年以来 / 近1月 / 近3月 / 近6月 / 近1年。
tag 标签（估值类有）含义：极低 / 较低 / 适中 / 较高 / 极高，对应估值分位的高低——分位越低（极低/较低）通常表示相对历史更便宜，但只是估值维度参考，不构成买卖建议。
退出码：0 成功 / 1 参数错误 / 2 接口或网络错误。

`index-data`

| 参数 | 必填 | 说明 | |------|------|------| | code | 是 | 指数代码，如 399975.SZ（位置参数或 --code） | | --start | 否 | 起始日期 start_time（YYYY-MM-DD，含）；仅传此项时接口返回从起始日到当天的数据 | | --end | 否 | 截止日期 end_time（YYYY-MM-DD，含） | | --format | 否 | table(默认)/json/csv | | --raw | 否 | 输出原始 JSON 响应（二维表：首行为表头） | | -o,--output | 否 | 写入文件 |

三种日期组合（与接口约定一致）：code 不传日期 → 默认近一个月；只传 --start → 从起始日到当天；同时传 --start --end → 按给定区间。
返回为二维表，首行表头（日期/收盘价/pe/pb/roe 等），后续为数据行；表格默认按日期升序排列。
退出码：0 成功 / 1 参数错误（缺 code）/ 2 接口或网络错误 / 3 无数据或无法解析。

`stage`

| 参数 | 必填 | 说明 | |------|------|------| | fund_codes | 是 | 一个或多个基金代码（位置参数或 -c/--fund-code，可多次） | | --periods | 否 | 仅展示指定区间，逗号分隔，如 近1月,近1年,成立来（精确匹配优先，其次子串包含） | | --authtoken | 否 | 鉴权 token（阶段涨幅为公开数据，默认留空即可，无需个人 token） | | --format | 否 | table(默认)/json/csv | | --raw | 否 | 输出原始 JSON 响应（与 --json 互斥） | | --json | 否 | 输出结构化 JSON（含解析后的区间、指标与对比分类，与 --raw 互斥） | | --url | 否 | 自定义接口地址（默认官方） | | -o,--output | 否 | 写入文件 |

返回三行指标：涨跌幅（基金自身）、同类平均（同分类均值）、同类排名（名次/总数，已去 HTML 灰字，如 612/6642）。
对比分类取自接口的 two_category[two_category_index]（如 韭圈-权益型），即排名所依据的同分类口径；基金分类 列出该基金在多套分类体系下的归属，风格标签 为接口附带风格标记。
区间列（表头）随基金成立时间动态变化：老基金含 2019年/2020年/2019牛市来/2020疫情来 等历史列，新基金只有 近1日~成立来 等常规列——以接口实际返回为准。
退出码：0 成功 / 1 参数错误（缺基金代码）/ 2 接口或网络错误 / 3 无数据或无法解析。

向用户呈现结果的建议

拿到 stdout 正文后直接展示是最忠实的做法；也可提炼关键卡片（如经理：姓名/机构/从业年限/规模/年化/代表基金；基金：名称/类型/规模/套牢/年化）。
净值/恐贪等含多行数据，保留换行或表格更易读。
失败场景给出可读的中文原因，不要抛出原始 JSON 堆栈。
恐贪指数属情绪指标而非投资建议，呈现时可附带"恐惧常对应阶段性低位、贪婪警惕过热，但不构成买卖依据"。
指数估值分栏（index）的 tag 标签（极低/较低/适中/较高/极高）反映估值分位高低——分位越低相对历史越便宜，但仅作估值维度参考，不构成买卖建议；估值类分类看 PE/PB/股息率分位，收益类分类（其他）看近1日~近1年区间收益。

依赖

python3（或 Windows 的 python），仅标准库，无需安装第三方包。
可访问外网以调用 jiucaishuo.com 相关域名。

韭圈儿基金数据统一查询

韭圈儿基金数据统一查询（jiucaishuo）

能力总览

When to Use（按意图路由）

股债性价比（gz / bond / fed / temp）

调用方式

fed / gz 参数

输出要点

依赖 / 鉴权

通用约定

调用方式

各子命令参数

manager

nav

info

qdii

fear-greed

index

index-data

stage

向用户呈现结果的建议

依赖

`fed` / `gz` 参数

`manager`

`nav`

`info`

`qdii`

`fear-greed`

`index`

`index-data`

`stage`