Fanli

Other

将商品链接或淘口令转为带优惠券的推广链接，跨平台比价（淘宝/天猫/京东/拼多多/抖音/唯品会/美团），查询历史价格走势并给出购买建议。当用户发来商品链接、淘口令、美团链接，或提到"转链"、"比价"、"历史价"、 "全网最低价"、"有没有优惠券"、"值不值得买"、"价格走势"、"优惠"、"便宜"、"划算"、"打折"、 "降价"、"满减"、"省钱"、"买不买"、"该不该入手"、"美团"、"外卖"、"团购"、"到店"、"美团红包"时使用。不适用于：快递查询、汇率换算、天气查询、闲鱼二手交易等非购物比价场景。

Install

openclaw skills install fanli

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

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

省钱购物助手

一次 convert 调用 → 同时拿到商品信息 + 比价 + 历史价 → 直接按模板渲染输出。

前置条件

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

快速开始

# 快捷命令（推荐）
node {baseDir}/scripts/run.mjs convert "<链接或口令>"

# 美团链接转链
node {baseDir}/scripts/run.mjs convert "https://click.meituan.com/t?t=1&c=2&p=xxx"

# 等价的标准调用
node {baseDir}/scripts/run.mjs call convert --tpwd "<链接或口令>"

# 查看接口帮助
node {baseDir}/scripts/run.mjs call convert --help

返回 JSON 包含：商品详情 + comparePriceData（比价） + historyPriceData（历史价）。服务端 includeComparePrice 和 includeHistoryPrice 默认 true，无需额外传参。

路由决策

用户意图	快捷命令	标准调用	渲染模板
发链接、问值不值得买、问优惠券、没说意图	`convert "<链接>"`	`call convert --tpwd "<链接>"`	Read `{baseDir}/references/convert-output.md`
明确说"比价"、"哪家便宜"	`compare-price "<链接>"`	`call compare-price --productIdentifier "<链接>"`	Read `{baseDir}/references/compare-price-output.md`
明确说"历史价"、"价格走势"	—	`call convert --tpwd "<链接>" --includeComparePrice false`	Read `{baseDir}/references/convert-output.md`

所有命令前缀：node {baseDir}/scripts/run.mjs

默认用 convert，它一次返回商品信息 + 比价 + 历史价全部数据。美团链接（click.meituan.com、dpurl.cn、meituan.com、imeituan:// 等）同样走 convert 路径，数据结构与电商一致。convert 支持两个可选参数控制返回内容：

--includeComparePrice true/false（默认 true）
--includeHistoryPrice true/false（默认 true）

历史价路径走 convert 而非独立接口，是因为购买建议需要到手价（finalPrice）与历史价比较，而独立的历史价接口不返回到手价。

输出格式：所有接口支持 --format json（默认）或 --format table。如果下游 Agent 需要结构化数据而非 Markdown 渲染，直接用 --format json 跳过模板渲染。

工作流

收到链接/口令
  → 输出"正在查询商品信息..."
  → 根据上方路由表调用对应接口
  → 拿到 JSON
  → Read 路由表中对应的渲染模板，按模板输出

没有链接时先问用户要。

错误处理

接口返回错误时，告知用户具体原因并给建议，不要返回原始 JSON：

现象	用户可见提示
`missing_parameter`	请发一下商品链接或淘口令
`errorMessage: "未找到相关商品"`	没找到商品信息，请检查链接是否正确
`topLowestItems` 为空	暂无比价数据
`historyPriceData` 不存在	暂无历史价格数据
`missing_api_key`	请设置环境变量 `FX_AI_API_KEY`，从 feima-lab 开放平台登录获取
`api_unavailable` / HTTP 错误	服务暂时不可用，请稍后再试

不适用场景

以下情况不要调用本 Skill：

快递物流查询
汇率换算、天气查询
闲鱼/二手交易（无标准价格体系）
没有具体商品链接的购物讨论

环境依赖

Node.js 18+（内置 fetch，无需额外依赖）
环境变量 FX_AI_API_KEY：从 feima-lab 开放平台登录获取