功能描述

海外品牌官方商城返利（cashback）助手。通过多麦联盟渠道，为指定海外商家的购物订单提供返利查询与转链服务，三个能力：粘贴商品链接生成返利短链、查询商家返利比例、查看个人返利订单。当前仅支持 Adidas、Space NK NL（荷兰站）、designwebstore DE（德国站）三家，不在清单中的海外商家...

使用说明 (SKILL.md)

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

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

海外购物返利助手

Name: Cashback
Author: fangshan101-coder

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.de`	designwebstore / 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 "\x3CURL>"
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 "\x3CURL>"`	Read `{baseDir}/references/link-convert-output.md`
问某商家有没有返利、返利多少	`run.mjs store "\x3C精确商家名>"`	Read `{baseDir}/references/store-rebate-output.md`
查我的返利、我的订单	`run.mjs orders` 或 `run.mjs orders --days N`	Read `{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 安装

环境依赖

Node.js 18+
环境变量 FX_AI_API_KEY：从 feima-lab 开放平台登录获取

安全使用建议

This skill appears to do what it claims: convert product links, query store rebate plans, and fetch your rebate orders. Before installing, note: (1) you must install the companion fx-base skill as instructed; (2) the skill sends the links and order queries to an external backend (api-ai-brain.fenxianglife.com) — do not use it with sensitive personal data unless you trust that service; (3) it only supports the three listed stores and will explicitly avoid calling the API for unsupported stores; and (4) the only required secret is FX_AI_API_KEY — verify which service (feima-lab vs fenxianglife) will receive/authorize requests if you need stronger assurance.

功能分析

Type: OpenClaw Skill Name: cashback Version: 1.2.2 The cashback skill bundle is a legitimate utility designed to generate affiliate links and query order rewards for specific overseas retailers (Adidas, Space NK, etc.). It operates by sending user-provided URLs and queries to a dedicated backend API (api-ai-brain.fenxianglife.com) using a required API key (FX_AI_API_KEY). The code logic in scripts like link-convert.mjs and run.mjs is straightforward, utilizing standard Node.js child_process.spawn for internal dispatching without evidence of shell injection or unauthorized data exfiltration. The instructions in SKILL.md are well-structured to guide the AI agent in routing user requests to the appropriate local scripts.

能力标签

requires-sensitive-credentials

能力评估

✓ Purpose & Capability

Name/description (cashback for specific overseas stores) match the included scripts (link conversion, store rebate lookup, order query). The single required env var FX_AI_API_KEY is appropriate for calling the external API via the shared fx-base library. No unrelated binaries or unrelated credentials are requested.

ℹ Instruction Scope

Instructions require reading ../fx-base/SKILL.md and call a backend (https://api-ai-brain.fenxianglife.com) with user-supplied links and order queries. That is coherent for this skill, but it means user-provided links and order data are transmitted off-device to a third-party service — the README/SKILL.md explicitly says so and instructs to install fx-base first. The runtime instructions do not attempt to read other unrelated local files or extra environment variables.

✓ Install Mechanism

No network download/install spec is included; provided code is local scripts that import a sibling fx-base module. The scripts check for the fx-base dependency and fail with a clear message if missing. No remote archives, URL shorteners, or suspicious installers are used.

ℹ Credentials

Only one env var (FX_AI_API_KEY) is required — proportional for an API-backed cashback service. Minor potential confusion: the env var name and SKILL.md reference the feima-lab platform while the API host shown in code/comments is api-ai-brain.fenxianglife.com; this is likely an implementation detail (fx-base probably maps the API key to requests), but you may want to confirm which service will actually receive your key and data.

✓ Persistence & Privilege

Skill does not request always:true and does not modify other skills or system configs. It can be invoked autonomously (the platform default), which is expected for helper skills; nothing in the package indicates it persists beyond its own scripts.

版本历史

v1.2.2

清理 fenxiang-ai 品牌描述残留，统一为 feima-lab

v1.2.1

品牌域名迁移：platform.fenxiang-ai.com → platform.feima.ai

v1.2.0

新增海外购物返利 skill：3 能力（链接转链/商家返利查询/订单查询），支持 Adidas、Space NK NL、designwebstore DE

v0.1.0

初始发布

元数据

Slug cashback

版本 1.2.2

许可证 MIT-0

累计安装 0

当前安装数 0

历史版本数 4

常见问题

Cashback 是什么？

海外品牌官方商城返利（cashback）助手。通过多麦联盟渠道，为指定海外商家的购物订单提供返利查询与转链服务，三个能力：粘贴商品链接生成返利短链、查询商家返利比例、查看个人返利订单。当前仅支持 Adidas、Space NK NL（荷兰站）、designwebstore DE（德国站）三家，不在清单中的海外商家... 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件，目前累计下载 184 次。

如何安装 Cashback？

在 OpenClaw 或 Claude Code 对话框中运行命令「/install cashback」即可一键安装，无需额外配置。

Cashback 是免费的吗？

是的，Cashback 完全免费，采用 MIT-0 许可证，可自由下载、安装和使用。

Cashback 支持哪些平台？

Cashback 跨平台运行，可在任意部署了 OpenClaw / Claude Code 的环境中使用（cross-platform）。

谁开发了 Cashback？

由 fangshan101-coder（@fangshan101-coder）开发并维护，当前版本 v1.2.2。

Cashback