ClawHub

Cashback

Other

海外品牌官方商城返利（cashback）助手。通过多麦联盟渠道，为指定海外商家的购物订单提供返利查询与转链服务，三个能力：粘贴商品链接生成返利短链、查询商家返利比例、查看个人返利订单。当前仅支持 Adidas、Space NK NL（荷兰站）、designwebstore DE（德国站）三家，不在清单中的海外商家暂未开通。当用户发来这三家商家的商品链接，或提到"Adidas/阿迪达斯返利"、"Space NK 返利"、"designwebstore 返利"、"cashback"、"海淘返利"、"我的返利订单"时使用。不适用于：清单外的任何商家（包括 Amazon/Nike/iHerb/eBay/Shein 等）、快递查询、汇率换算。

Install

openclaw skills install cashback

CRITICAL — 开始前 必须用 Read 工具读取 ../fx-base/SKILL.md，其中包含 feima-lab API 认证和请求规范。

fx-base 未安装？执行 npx skills install fangshan101-coder/fx-base 安装到同目录下。

海外购物返利助手

3 个能力覆盖海外购物返利全流程：粘贴链接转链 → 搜商家问返利 → 查返利订单。

当前支持商家

商家名（--store 参数必须用此值）支持地区域名匹配用户可能的叫法
Adidas全球/中国*.adidas.com / *.adidas.cn / *.adidas.de / *.adidas.co.uk 等所有 adidas 官方域名阿迪达斯 / 阿迪 / adidas / Adidas
Space NK NL荷兰*.spacenk.com（通常含 /nl/ 或 /en_NL/ 路径）space nk / spacenk / Space NK 荷兰站
designwebstore DE德国designwebstore.dedesignwebstore / design web store / designwebstore 德国站

重要：商家清单由多麦联盟后端决定，不在上表中的商家一律不支持（包括 Amazon、Nike、iHerb、eBay、Shein 等）。用户问清单外商家时直接告知暂不支持，不要调 API 硬查。

商家名映射：用户口头叫法（如"阿迪达斯"）必须先映射到左列的精确值（Adidas）再传给 --store 参数，否则 API 会返回 store_not_found。

前置条件

  • 环境变量 FX_AI_API_KEY：从 feima-lab 开放平台 登录获取。未设置时脚本会返回 missing_api_key 错误
  • 数据流向：用户提供的链接和查询会被发送到 https://api-ai-brain.fenxianglife.com 处理，请确保信任该服务后再使用

快速开始

# 快捷命令（推荐，Claude 默认用这组）
node {baseDir}/scripts/run.mjs convert "https://www.adidas.com/us/ultraboost-5-shoes/ID8841.html"
node {baseDir}/scripts/run.mjs store "Adidas"
node {baseDir}/scripts/run.mjs orders

# 等价的标准调用（开发者调试用）
node {baseDir}/scripts/run.mjs call link-convert --url "<URL>"
node {baseDir}/scripts/run.mjs call store-rebate --store "Space NK NL"
node {baseDir}/scripts/run.mjs call order-query --days 30

路由决策

用户意图命令渲染模板
发商品链接、要返利链接run.mjs convert "<URL>"Read {baseDir}/references/link-convert-output.md
问某商家有没有返利、返利多少run.mjs store "<精确商家名>"Read {baseDir}/references/store-rebate-output.md
查我的返利、我的订单run.mjs orders 或 run.mjs orders --days NRead {baseDir}/references/order-query-output.md

链接归属判断

调用接口前，必须先用域名/商家名判断是否在服务范围，避免无效 API 调用：

输入类型判断依据动作
商品链接域名匹配「支持商家表」的"域名匹配"列调用 convert
商品链接域名不匹配表中任何商家不调 API，告知"该商家暂未开通返利，目前仅支持 Adidas、Space NK NL、designwebstore DE 三家"
商家名对照"用户可能的叫法"列，能映射到精确商家名用映射后的值调用 store
商家名无法映射到上表任何商家不调 API，告知同上
查订单直接调用，无需判断调用 orders

工作流

多接口 skill 必须渐进式输出——先告诉用户"正在查询"，不要等到 API 返回才出声：

Step 1 立即输出："正在查询 {商家名/订单/链接}..."（不等 API 返回）
  ↓
Step 2 判断链接/商家是否在服务范围（见"链接归属判断"）
  ↓  不在  → 告知不支持并结束
  ↓  在    → 继续
Step 3 调用对应接口（见"路由决策"）
  ↓
Step 4 拿到 JSON，Read 对应渲染模板，输出结果
  ↓
Step 5 用户继续追问 → 回到 Step 1

没有链接时先问用户要。

错误处理

现象用户可见提示兜底动作
用户发清单外商家的链接或名字"该商家暂未开通返利，目前仅支持 Adidas、Space NK NL、designwebstore DE 三家"不调 API，直接回复
store_not_found（清单内商家名拼错）"没找到该商家，商家名应为：Adidas / Space NK NL / designwebstore DE"用精确名称重试；若用户同时给了链接，改走 convert
no_available_plan"该商家暂无可用返利计划"告知可能是临时下线，建议稍后重试
no_orders"近 {days} 天暂无返利订单"提示"通过返利链接购物后，订单通常需要 1-3 天才会出现"
api_unavailable / HTTP 错误"服务暂时不可用，请稍后重试"建议 1 分钟后重试
missing_api_key"请设置环境变量 FX_AI_API_KEY"给出 feima-lab 开放平台 链接
missing_parameter"请发一下商品链接 / 请告诉我要查哪个商家"引导用户补充参数

不适用场景

以下情况不要调用本 Skill：

  • 清单外的任何海外商家（Amazon/Nike/iHerb/eBay/Shein 等）
  • 国内电商（淘宝/京东/拼多多/抖音/唯品会/美团等）
  • 快递物流查询
  • 汇率换算、天气查询

兼容性

  • Claude Code / Claude.ai / OpenClaw 本地节点
  • Node.js 18+（内置 fetch，无额外依赖）
  • 脚本路径解析基于 import.meta.url，支持 symlink 安装

环境依赖