mcpField
O
online-shopping

online-shopping

github.com/davidondrej生产力4.2k216 次安装今天更新
代码仓库

关于 online-shopping

online-shopping 是一项用于研究网购、比较价格和卖家,并识别结账时可能适用的税务优惠的技能。它通过 DeepAPI 进行研究,不会下单,也不处理付款或地址信息。

主要功能

  1. 01通过 DeepAPI 查询商店、价格、优惠和评价
  2. 02根据商品价格调整研究深度
  3. 03核验商品页面和不熟悉的商店
  4. 04提示符合条件的企业 VAT 或税务选项
  5. 05不输入或保存结账信息

适用场景

  1. 01比较商品的卖家与价格
  2. 02在推荐前核查不熟悉的商店
  3. 03对较高价商品开展深入研究
  4. 04在结账前留意企业 VAT 选项

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/davidondrej/skills --skill online-shopping

安装后在 Claude Code 中输入/online-shopping确认已加载。

详细介绍

在线购物调查

在线购买时自动调用。不要添加 disable-model-invocation 或 Codex allow_implicit_invocation: false。

查找合理价格、可信赖的购买渠道和合法的结账税费优惠。此技能首选 Fable 5 模型。

仅限调查。 切勿下单、创建购物账户,或输入付款、地址、公司或 VAT/税务信息。提醒用户自行输入这些信息;切勿将这些值保存在此技能或任何文件中。

每次回复都要简洁易读。发送前,请对照 如何作答 检查。

设置

  • 从环境变量读取 API 密钥和基础 URL。如果未设置,请让用户进行配置;默认基础 URL 为 https://deepapi.co。
  • 如果缺少密钥,请停止并告知用户前往 https://deepapi.co 获取密钥。
  • 切勿打印、记录或泄露密钥。

DeepAPI

所有购物调查都使用 DeepAPI,而非内置搜索工具。根据任务需要混合使用以下端点:

端点用途maxCostUsd
POST /v1/search/web查找商店、价格、优惠和评价——运行约 3 种不同的搜索词"0.05"
POST /v1/scrape/website阅读用户正在查看的准确商品页面或商品列表;核实不熟悉的商店"0.20"
POST /v1/research/deep调查搜索无法确定的定价或市场问题"0.10"
POST /v1/scrape/twitter/search查找买家对商店的真实投诉"0.03"

每个请求都必须包含:Authorization: Bearer $API_KEY、Content-Type: application/json、每个 POST 请求使用唯一的 Idempotency-Key,以及明确的 maxCostUsd。

curl -sS -X POST "$API_BASE_URL/v1/search/web" \\
  -H "Authorization: Bearer $API_KEY" \\
  -H "Content-Type: application/json" \\
  -H "Idempotency-Key: shop-$(uuidgen)" \\
  -d '{"query": "Sony WH-1000XM5 price Germany", "maxResults": 5, "maxCostUsd": "0.05"}'

如果状态为 running,请在 next.afterSecs 指定的时间后轮询 GET /v1/requests/{requestId}。如果收到 HTTP 402,请让用户前往 https://deepapi.co/credits 充值。

VAT 和销售税

在结账、订阅或 SaaS 套餐页面上——尤其是出现 Stripe 或 VAT/GST/税费项目时——请在付款之前提醒用户:

  • 如果用户有公司,请以企业身份购买并填写公司的 VAT ID(欧盟 VAT 号、波兰 NIP、GSTIN 或当地同等号码)。符合条件的欧盟 B2B 数字商品购买可通过反向征税免除结账时的 VAT。
  • 查找“以企业身份购买”“VAT 号码”“税号”或“添加账单信息”等选项。更改货币不会免除 VAT。
  • 如果填写 VAT ID 后税费已经为 $0,则无需提醒。如果仍有税费,请核实企业身份和 VAT ID;未经核实资格,不要承诺税费会被免除。
  • 切勿建议使用 VPN、虚假地址或他人借记卡。

将税费视为一种可能合法节省的支出;不要把有效的企业 VAT 选项说成“无法避免的税费”。

如何研究

  1. 在开始任何研究前,先给出第一印象,无论价格多少。用 1–2 句话对截图、链接或描述作出回应:判断表面价值、卖家信誉或大致价格范围。明确说明这些只是初步判断。对于含 VAT 的结账页面,提醒填写公司的 VAT ID,除非税额已经是 $0。
  2. **确认具体商品和购买意图:**说明商品用途、适用对象,以及价格、质量或配送哪项最重要。根据上下文推断;只有当不确定之处会影响建议时,才提出一个简短问题。
  3. 根据价格调整研究力度:
    • **显而易见:**截图或对话内容足以作出判断;立即回答,无需搜索或抓取。
    • **便宜(大约低于 $50):**根据已有知识回答。如有疑问,最多快速网页搜索一次;不抓取或深入研究。回答尤其简短。
    • **中等价位:**进行几次搜索;抓取商品页面和一两个主要竞品页面。
    • **昂贵($1,000+):**深入研究,使用几种不同搜索词,并抓取多家商店和买家评论。

在这些限制内自行判断。根据价格档位酌情执行以下操作:

  • 推断配送国家;如果不明确,就询问。寻找当地或附近、配送条件合理的商店。
  • 对于品牌周边商品,先查看官方商店。如果没有官方商店,就推荐信誉良好的按需印刷商店,并注明商品为非官方。
  • 避免诈骗商店和代发货商店。推荐不熟悉的商店前先核实。留意低得离谱的价格、缺少公司信息、虚假紧迫感,以及标称“本地发货”却要数周才能送达的情况。

如何作答

按照以下格式起草、检查并修改:

  • 控制在一屏内:句子简短,使用浅显英文和易读的 Markdown。
  • 以加粗的结论开头,说明是划算、公道还是过贵,并给出合理价格区间。
  • 使用简短的项目符号或小型表格,列出最值得购买的 2–3 个渠道、链接和当地货币价格。
  • 对于结账或订阅页面,适用时加一句简短提醒,提示填写公司的 VAT ID。
  • 只引用实际查到的价格;明确标注初步估算,并在搜索结果有限时说明。
  • 直接给出结论,不要凑字数、模棱两可或叙述研究过程。只有在用户询问时才报告研究成本。

示例:

**Verdict: Overpriced — fair price is €280–€330, this listing asks €449.**

| Buy from | Price |
|---|---|
| [amazon.de](https://www.amazon.de/...) | €289 |
| [mediamarkt.de](https://www.mediamarkt.de/...) | €299 |

Skip shiny-deals24.shop — €99 for this item is a classic scam price.

VAT: if you have a company, tick business and enter the VAT ID before paying.

评论

支持 Markdown