CRITICAL — 开始前 必须用 Read 工具读取 ../fx-base/SKILL.md，其中包含 fenxiang-ai API 认证和请求规范。
fx-base 未安装？执行 npx skills install fangshan101-coder/fx-base 安装到同目录下。
省钱购物助手
一次 convert 调用 → 同时拿到商品信息 + 比价 + 历史价 → 直接按模板渲染输出。
前置条件
- - 环境变量
FX_AI_API_KEY：从 fenxiang-ai 开放平台 登录获取。未设置时脚本会返回 missing_api_key 错误 - 数据流向：用户提供的商品链接会被发送到
https://api-ai-brain.fenxianglife.com 进行解析，请确保信任该服务后再使用
快速开始
CODEBLOCK0
返回 JSON 包含：商品详情 + comparePriceData（比价） + historyPriceData（历史价）。
服务端 includeComparePrice 和 includeHistoryPrice 默认 true，无需额外传参。
路由决策
| 用户意图 | 快捷命令 | 标准调用 | 渲染模板 |
|---|
| 发链接、问值不值得买、问优惠券、没说意图 | INLINECODE11 | INLINECODE12 | Read INLINECODE13 |
| 明确说"比价"、"哪家便宜" |
compare-price "<链接>" |
call compare-price --productIdentifier "<链接>" | Read
{baseDir}/references/compare-price-output.md |
| 明确说"历史价"、"价格走势" | — |
call convert --tpwd "<链接>" --includeComparePrice false | Read
{baseDir}/references/convert-output.md |
所有命令前缀： INLINECODE19
默认用 convert，它一次返回商品信息 + 比价 + 历史价全部数据。美团链接（click.meituan.com、dpurl.cn、meituan.com、imeituan:// 等）同样走 convert 路径，数据结构与电商一致。convert 支持两个可选参数控制返回内容：
- -
--includeComparePrice true/false（默认 true） - INLINECODE28 （默认 true）
历史价路径走 convert 而非独立接口，是因为购买建议需要到手价（finalPrice）与历史价比较，而独立的历史价接口不返回到手价。
输出格式：所有接口支持 --format json（默认）或 --format table。如果下游 Agent 需要结构化数据而非 Markdown 渲染，直接用 --format json 跳过模板渲染。
工作流
CODEBLOCK1
没有链接时先问用户要。
错误处理
接口返回错误时，告知用户具体原因并给建议，不要返回原始 JSON：
| 现象 | 用户可见提示 |
|---|
| INLINECODE34 | 请发一下商品链接或淘口令 |
| INLINECODE35 |
没找到商品信息，请检查链接是否正确 |
|
topLowestItems 为空 | 暂无比价数据 |
|
historyPriceData 不存在 | 暂无历史价格数据 |
|
missing_api_key | 请设置环境变量
FX_AI_API_KEY，从
fenxiang-ai 开放平台 登录获取 |
|
api_unavailable / HTTP 错误 | 服务暂时不可用，请稍后再试 |
不适用场景
以下情况不要调用本 Skill：
- - 快递物流查询
- 汇率换算、天气查询
- 闲鱼/二手交易（无标准价格体系）
- 没有具体商品链接的购物讨论
环境依赖
关键 — 开始前 必须用 Read 工具读取 ../fx-base/SKILL.md，其中包含 fenxiang-ai API 认证和请求规范。
fx-base 未安装？执行 npx skills install fangshan101-coder/fx-base 安装到同目录下。
省钱购物助手
一次 convert 调用 → 同时拿到商品信息 + 比价 + 历史价 → 直接按模板渲染输出。
前置条件
- - 环境变量 FXAIAPIKEY：从 fenxiang-ai 开放平台 登录获取。未设置时脚本会返回 missingapikey 错误
- 数据流向：用户提供的商品链接会被发送到 https://api-ai-brain.fenxianglife.com 进行解析，请确保信任该服务后再使用
快速开始
bash
快捷命令（推荐）
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
apikey | 请设置环境变量 FX
AIAPI
KEY，从 fenxiang-ai 开放平台 登录获取 |
| api_unavailable / HTTP 错误 | 服务暂时不可用，请稍后再试 |
不适用场景
以下情况不要调用本 Skill：
- - 快递物流查询
- 汇率换算、天气查询
- 闲鱼/二手交易（无标准价格体系）
- 没有具体商品链接的购物讨论
环境依赖
