mcpField
O
online-shopping

online-shopping

github.com/davidondrej生産性4.2k216 回インストール今日更新
リポジトリ

online-shopping について

online-shoppingは、オンライン購入の価格や販売店を調査し、チェックアウト時に適用できる税務上の節約策を確認するスキルです。DeepAPIで調査し、注文や支払い・住所情報の取り扱いは行いません。

主な機能

  1. 01DeepAPIで店舗、価格、セール、レビューを調査
  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"}'

status: running の場合は、next.afterSecs の後に GET /v1/requests/{requestId} をポーリングしてください。HTTP 402 の場合は、https://deepapi.co/credits でクレジットを追加するようユーザーに依頼してください。

VAT と売上税

決済画面、サブスクリプション画面、SaaS プラン画面、特に Stripe または VAT／GST／税の項目がある場合は、支払い前にユーザーに次のことを伝えてください。

  • 会社をお持ちの場合は、法人として購入し、VAT ID（EU VAT 番号、ポーランドの NIP、GSTIN、または現地の同等の番号）を入力してください。条件を満たす EU 域内 B2B のデジタル購入では、リバースチャージにより決済時の VAT が免除される場合があります。
  • 「法人として購入」、「VAT 番号」、「税務 ID」、「請求先情報を追加」などの項目を探してください。通貨を変更しても VAT は免除されません。
  • VAT ID を入力した状態ですでに税額が $0 の場合は、注意喚起を省略してください。税額が残る場合は、法人のステータスと VAT ID を確認してください。適用条件を確認せずに免除されると約束してはいけません。
  • VPN、偽の住所、借りたカードを提案しないでください。

税を合法的な節約の可能性として扱い、適法な法人向け VAT の選択肢を「避けられない税」として退けないでください。

調べ方

  1. 調べ始める前に、まず第一印象を伝えます。価格にかかわらず、スクリーンショット、リンク、説明を見て、価値がありそうか、販売者の評判、またはおおよその価格帯について、1～2文で感想を伝えます。あくまで暫定的な見解であることを明示します。VAT がかかる購入画面では、税額がすでに $0 でない限り、会社の VAT ID に関する注意書きを添えます。
  2. 商品と購入目的を正確に特定します。用途、対象者、価格・品質・配送のうち何を最も重視するかを確認します。文脈から推測し、推奨内容が変わるほど不明な点がある場合に限り、短い質問を1つだけします。
  3. 価格に応じて調査の規模を調整します。
    • 判断が明らかな場合： スクリーンショットや会話だけで判断できるなら、検索やスクレイピングは行わず、すぐに回答します。
    • 安価な商品（おおむね $50 未満）： 既存の知識をもとに回答します。不確かな場合に限り、手早くウェブ検索を1回まで行います。スクレイピングや詳しい調査は行わず、特に簡潔にまとめます。
    • 中価格帯： 数回検索し、商品ページと競合上位1～2件をスクレイピングします。
    • 高額商品（$1,000 以上）： 複数の検索語句を使って詳しく調査し、複数のショップと購入者レビューをスクレイピングします。

以下の範囲内で、状況に応じて判断します。価格帯に応じて必要な場合は、次の点を確認します。

  • 配送先の国を推測します。不明な場合は確認します。適切な送料で配送できる、その国または近隣のショップを探します。
  • ブランドグッズの場合は、まず公式ストアを確認します。公式ストアがなければ、信頼できるオンデマンド印刷ショップを提案し、非公式商品であることを明記します。
  • 詐欺の疑いがあるショップやドロップシッピングショップは避けます。知られていないショップは、推奨する前に確認します。不自然に安い価格、会社情報の欠如、偽の緊急性、「現地の」ショップをうたうのに配送に数週間かかる、といった点に注意します。

回答の仕方

以下の形式に沿って下書きし、確認して修正します。

  • 画面1枚に収まるようにします。短い文を使い、平易な英語で、読みやすい 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 対応