| name | huachuang-morphology-api |
| description | 调用华创金工形态学 HTTP API（基础形态、择时截面/历史、ETF 信号与中间数据等）。在用户询问形态学、择时信号、ETF 截面/历史、指数中间数据或需拉取 mark.hcquant.com / xingtai.pro 数据时使用；通过运行 scripts 目录下 CLI 并读取 scripts/config.json 中的 token 完成请求。 |
华创金工形态学 API（OpenClaw / Agent Skill）
前置条件
-
Python 3.8+，安装依赖：
pip install -r scripts/requirements.txt
-
Token 配置（必填）：在 skill 目录下的 scripts/config.json 中存放密钥（勿提交版本库）。
- 复制
scripts/config.example.json 为 scripts/config.json
- 将
token 字段改为有效 API Token
{
"token": "你的真实Token"
}
调用方式
在 skill 根目录（本文件所在目录）执行：
python scripts/morphology_cli.py <方法名> '[可选：JSON参数字符串]'
- 成功时 stdout 为 JSON：
ok: true，type 为 dataframe / dict / text / json，数据在 data 字段（DataFrame 为行对象数组）。
- 失败时
ok: false，error 说明原因；部分错误信息在 stderr。
列出全部可调用方法：
python scripts/morphology_cli.py --list
参数说明
第二个参数为 JSON 对象，键名须与 Python 方法参数一致，仅支持的键会被传入（多余键忽略）。
示例：
python scripts/morphology_cli.py get_basic_info
python scripts/morphology_cli.py get_historical_data '{"win_rate":0.6,"trade_date":"2024-01-02","position":"负面"}'
python scripts/morphology_cli.py get_index_median_data '{"sid":"000300.SH"}'
python scripts/morphology_cli.py get_etf_cross_section_signal '{"company":"fg"}'
方法速查（与 morphology_api.py 一致）
| 方法 | 作用 |
|---|
get_basic_info | 全部形态文字介绍 |
get_supported_assets | 系统支持的资产 |
get_latest_daily_stats | 全部资产最新日统计 |
get_historical_data | 历史数据（参数：win_rate, trade_date, position） |
get_broad_index_timing | 宽基指数最新截面信号 |
get_industry_timing | 行业指数最新截面信号 |
get_style_timing | 风格指数最新截面信号 |
get_concept_timing | 概念指数最新截面信号 |
get_historical_broad_timing | 宽基历史择时（asset_code） |
get_historical_industry_timing | 行业历史择时（asset_code） |
get_historical_style_timing | 风格历史择时（asset_code） |
get_historical_concept_timing | 概念历史择时（asset_code） |
get_etf_cross_section_signal | ETF 截面信号（company 如 fg/th/bs） |
get_etf_historical_signal | ETF 历史信号（asset_code, company） |
evaluate_etf_performance | ETF 信号绩效（需 empyrical，asset_code） |
get_realtime_historical_data | 实时历史纯信号（trade_date） |
get_index_median_data | 指数中间数据（sid，港股含 HI 走港股接口） |
get_etf_median_data | ETF 中间数据（company, sid） |
get_etf_portal_data | ETF 门户 JSON（sid） |
get_etf_scores | 最新 ETF 得分 |
常用公司代码 company：fg 富国、th 天弘、bs 博时、htbr 华泰柏瑞等（完整映射见 morphology_api.py 中 asset_codes['companies']）。
Agent 执行约定
- 先确认
scripts/config.json 存在且含有效 token；若缺失，提示用户复制 config.example.json 并填写。
- 需要表格数据时优先调用 CLI，用返回的 JSON 回答用户，必要时对
data 做摘要或筛选。
evaluate_etf_performance 未安装 empyrical 时会失败，可先 pip install empyrical 或换用其他接口。
脚本说明
scripts/morphology_api.py：API 客户端实现。scripts/morphology_cli.py：命令行入口，读取 scripts/config.json。scripts/config.example.json：配置模板。scripts/requirements.txt：Python 依赖。
接口文档
HTTP 路径、Query 参数、返回值类型与 CLI 信封格式见 接口说明.md。
