← Back to Skills Marketplace
Cashback
by
fangshan101-coder
· GitHub ↗
· v1.2.2
· MIT-0
184
Downloads
0
Stars
0
Active Installs
4
Versions
Install in OpenClaw
/install cashback
Description
海外品牌官方商城返利（cashback）助手。通过多麦联盟渠道，为指定海外商家的购物订单提供返利查询与转链服务，三个能力：粘贴商品链接生成返利短链、查询商家返利比例、查看个人返利订单。当前仅支持 Adidas、Space NK NL（荷兰站）、designwebstore DE（德国站）三家，不在清单中的海外商家...
README (SKILL.md)
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.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 开放平台 登录获取
Usage Guidance
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.
Capability Analysis
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.
Capability Tags
Capability Assessment
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.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install cashback - After installation, invoke the skill by name or use
/cashback - Provide required inputs per the skill's parameter spec and get structured output
Version History
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
初始发布
Metadata
Frequently Asked Questions
What is Cashback?
海外品牌官方商城返利（cashback）助手。通过多麦联盟渠道，为指定海外商家的购物订单提供返利查询与转链服务，三个能力：粘贴商品链接生成返利短链、查询商家返利比例、查看个人返利订单。当前仅支持 Adidas、Space NK NL（荷兰站）、designwebstore DE（德国站）三家，不在清单中的海外商家... It is an AI Agent Skill for Claude Code / OpenClaw, with 184 downloads so far.
How do I install Cashback?
Run "/install cashback" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Cashback free?
Yes, Cashback is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Cashback support?
Cashback is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Cashback?
It is built and maintained by fangshan101-coder (@fangshan101-coder); the current version is v1.2.2.
More Skills