期货数据分析 Pay Skill

概述

本技能以付费 API 形式提供期货市场技术面分析。Agent 通过调用部署在服务端的分析接口发起请求；服务端通过微信支付 + SkillHub X402 协议触发计费，付款完成后返回完整分析报告。

生产端点（Base URL）：https://skill.123claw.fun
计费：¥0.50 / 次（服务端 PRICE_FEN=50），微信支付，AI 专属卡余额扣款
计费协议：SkillHub X402（Agent Pay），以 HTTP 402 + WeixinPay-Required 头触发
技能版本：1.1.0（服务端 SKILL_VERSION 须与此保持一致）

⚠️ 关键约定：本技能必须通过下方 HTTP 接口调用，才能触发微信支付计费。不要在本地下载或运行 scripts/ 中的分析脚本——分析在服务端执行，脚本随技能打包仅供服务端使用。直接跑本地脚本既不会计费，也无法返回经服务端聚合的报告。

标准调用流程（付费触发）

步骤 1：发起分析（首次调用，无 payment_code）

POST https://skill.123claw.fun/analyze
Content-Type: application/json

{
  "symbols": ["au0", "lc0", "ps0"],   // 品种代码数组
  "mode": "batch",                     // batch（批量巡检）| single（单品种深度）
  "use_ai": true,                      // 是否调用 AI 多引擎（DeepSeek/百炼/魔搭）
  "payment_code": null                // 首次调用不传或传 null
}

步骤 2：识别 HTTP 402 并触发支付

服务端对未付费请求返回 HTTP 402：

HTTP/1.1 402 Payment Required
WeixinPay-Required: <payment_code>

{
  "data": { "message": "本次期货分析调用需付费 0.50 元" },
  "WeixinPay": {
    "WeixinPay-Required": "<payment_code>",
    "prompt": "本次使用微信支付，请将 WeixinPay-Required 的值作为 paymentCode 交给 weixinpay_pay，以向用户申请支付授权。"
  }
}

Agent 处理动作（必须按此顺序，否则支付不会触发）：

从响应头 WeixinPay-Required 或 body.WeixinPay["WeixinPay-Required"] 取出 payment_code；
将 payment_code 作为 paymentCode 参数，调用 weixinpay_pay 工具，向用户申请微信支付授权；
用户使用 AI 专属卡余额完成付款；微信支付回调服务端，订单被标记为已支付。

步骤 3：携带 payment_code 二次调用

POST https://skill.123claw.fun/analyze
Content-Type: application/json

{
  "symbols": ["au0", "lc0", "ps0"],
  "mode": "batch",
  "use_ai": true,
  "payment_code": "<步骤 2 取出的 payment_code>"
}

若二次调用仍返回 402（支付未完成/已过期），重复步骤 2 重新发起支付。

步骤 4：返回分析结果（HTTP 200）

{
  "status": "success",
  "skill_id": "futures-data-analysis",
  "version": "1.1.0",
  "mode": "batch",
  "analyzed_at": "2026-08-22 23:36:05",
  "results": [
    {
      "symbol": "au0",
      "latest_price": 580.5,
      "data_points": 250,
      "score": { "...": "多空评分明细" },
      "report": "结构化分析文本报告"
    }
  ],
  "disclaimer": "不构成投资建议，期货有风险，入市需谨慎"
}

若 results 中某品种出现 "error" 字段（如"数据不足"），按非阻塞方式单独提示，不影响其他品种。

全市场品种扫描

POST https://skill.123claw.fun/scan
Content-Type: application/json

{ "top_n": 10, "payment_code": null }    // 首次调用，402 流程同上
{ "top_n": 10, "payment_code": "<code>" } // 付款后二次调用

健康检查 / 上线验证

GET https://skill.123claw.fun/health

返回服务状态、版本、价格、微信商户号、活跃订单数等。部署后或调用失败排查时优先访问。

分析能力说明

服务端执行的分析流水线（实现见随包 scripts/，供服务端调用）：

| 能力 | 说明 | |------|------| | 行情数据采集 | AkShare（日线）+ 东方财富 API（实时快照） | | 技术指标 | MA(5/10/20/60)、RSI(14)、MACD(12/26/9)、BOLL(20,2)、KDJ(9,3,3)、ATR(14)、量比 | | 多因子评分 | 均线排列 / MACD 金叉死叉 / RSI 超买超卖 / KDJ 极端值 / 涨跌幅 / 量价关系 | | AI 策略 | DeepSeek / 百炼 / 魔搭三引擎热备，结构化 JSON 交易信号 | | 报告 | 多品种批量 + 单品种深度（开仓点位、止损止盈、平仓计划） |

品种代码（主力连续 = 品种前缀 + 0）：沪金 au0、碳酸锂 lc0、多晶硅 ps0、生猪 lh0、棕榈油 p0、中证500 IC0。

多空评分阈值（综合看多得分 − 看空得分）：

≥ 0.8 强烈看多 / [0.4, 0.8) 偏多 / (−0.3, 0.4) 中性震荡 / (−0.7, −0.3] 偏空 / < −0.7 强烈看空

重要约定

行情展示遵循中国股市红涨绿跌配色（涨红 🔴，跌绿 🟢）。
所有报告必须包含 "不构成投资建议，期货有风险，入市需谨慎" 风险声明。
数据不足 30 条时明确警告；AI 信号 confidence < 0.65 自动降级为 hold。
AI 分析失败回退纯技术面评分并在报告中注明。
错误处理非阻塞：单个品种出错不影响其他品种。
计费提示：每次成功的 /analyze、/scan 调用都会触发一次微信支付扣款，调用前先向用户确认品种与范围。