mcpField
L
linkfox-sorftime-walmart-product-analysis

linkfox-sorftime-walmart-product-analysis

github.com/linkfox-aiマーケティング・グロース113101 回インストール2 週間前に更新
リポジトリ

linkfox-sorftime-walmart-product-analysis について

Sorftimeを使い、商品名または商品IDからWalmart USの商品データを調べるスキルです。詳細、過去の推移、日付別販売行を扱い、操作の選択とコストを意識した利用を案内します。

主な機能

  1. 01商品名による関連商品の検索
  2. 02現在の商品詳細の取得
  3. 03商品の過去の推移の確認
  4. 04日付別販売行の取得
  5. 0524時間キャッシュとコスト案内

活用シーン

  1. 01商品名に関連するWalmart US商品を探す
  2. 02既知商品の現在の詳細を確認する
  3. 03商品の履歴や日付別販売データを調べる

MCP 対応

LinkFoxのサードパーティデータサービスMCPが利用できる場合、SorftimeのWalmart商品分析APIへのリクエストを案内します。

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/linkfox-ai/linkfox-skills --skill linkfox-sorftime-walmart-product-analysis

インストール後、Claude Code で/linkfox-sorftime-walmart-product-analysisを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

references/
api.md
onboarding.md
scripts/
onboarding.py
sorftime_walmart_product_analysis.py

詳細

Walmart 製品分析

Sorftime を使用して、自然言語の名前から Walmart US の製品を検索したり、1 つの製品の詳細、過去の推移、日別販売数量のデータを確認したりできます。

主な概念

  • リクエストごとに operation を 1 つだけ指定してください。デフォルトのワークフローとして、4 つの操作すべてを呼び出すことは避けてください。
  • 関連製品の検索には searchByName、現在の製品概要には detail、製品の過去の変化には trend、日付付きの販売データには salesVolume を使用してください。
  • すべてのリクエストでフラットな JSON ボディを使用します。searchByName では name が必須で、その他の操作では文字列の productId が必須です。operation の値は大文字と小文字を区別します。
  • 後続の操作や別の日付範囲の指定は、追加の有料呼び出しになります。同一の JSON には 24 時間のキャッシュを再利用してください。

操作の振り分け

意図operationパラメーターSorftime リクエスト
名前から関連製品を検索searchByNamename、任意の pageIndex2
現在の製品詳細detailproductId1
製品の過去の推移trendproductId2
日別／バリエーション別の販売データsalesVolumeproductId、任意の日付／ページ1

呼び出す前に references/api.md を読み、日付とページネーションの正確なルールを確認してください。

パラメーターガイド

  • productId は、数字のみで構成されている場合でも、常に文字列として扱ってください。
  • searchByName は自然言語の製品名を受け付け、1 ページあたり最大 100 件の関連製品を返します。pageIndex のデフォルトは 1 です。
  • salesVolume は、任意の queryDate と queryEndDate を yyyy-MM-dd 形式で受け付けます。どちらも指定しない場合は直近 30 日間が返され、queryDate のみを指定した場合は終了日が当日になります。
  • pageIndex は searchByName と salesVolume に適用され、1 から始まり、デフォルトは 1 です。
  • 現在利用できる過去の期間は Sorftime によって決まります。固定の開始日を約束しないでください。

呼び出し方法

  • API エンドポイント：POST /sorftime/walmart/productAnalysis（パラメーター／レスポンス／エラーコードの詳細は references/api.md を参照）
  • Python スクリプト：python scripts/sorftime_walmart_product_analysis.py '<JSON 参数>' [--inline]
  • コスト制約：このツールは計算リソースを消費します。同じセッションで同じパラメーターの組み合わせを指定する場合、デフォルトでは 1 回だけ呼び出します。スクリプトには 24 時間のローカルキャッシュがあります。失敗または空の結果が返っても、キーワードを変えたり、ページを進めたり、郵便番号を変更したりして自動的に続けて試行しないでください。検索を続ける必要がある場合は、追加のコストが発生することを事前にユーザーに伝えてください。

出力方針（スクリプトのデフォルト動作）：

  • 常に完全なレスポンスを <cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-sorftime-walmart-product-analysis-<timestamp>.json に保存します（<cwd> はスクリプト実行時の作業ディレクトリです。Claude Code では現在のプロジェクトディレクトリを指します。<session> は環境変数 SESSION_ID から取得され、ユーザーのタスクごとに自動でまとめられます。/tmp への書き込みは禁止です。現在のディレクトリに書き込めない場合はエラーを報告してください）
  • レスポンスボディが 8 KB 以下の場合：保存後、完全な JSON を stdout に出力します
  • レスポンスボディが 8 KB を超える場合：保存後、stdout には要約のみを出力します（トップレベルのフィールド、total／costToken などの一般的な件数、最大のリストフィールドの長さと先頭 3 件のサンプル）
  • --inline を追加すると、stdout への全量出力を強制します（同様にファイルにも保存されます）

データの読み取りに関する推奨事項：まず要約を確認し、十分かどうかを判断してください。特定のフィールドが必要な場合は、JSON 全体をコンテキストに読み込むのではなく、保存した json ファイルから jq または ConvertFrom-Json を使って必要なデータを抽出してください。

認証と計算リソースの問題の解決

次の問題が発生した場合は、references/onboarding.md の案内に従って解決してください。

  • API Key が未設定：環境変数 LINKFOX_AGENT_API_KEY も LINKFOXAGENT_API_KEY も設定されていない
  • レスポンスのステータスコードが 401 または 402
  • 計算リソースまたは残高不足を示すレスポンス：メッセージに「計算リソースの残高不足／料金不足／残高不足／quota exceeded／insufficient balance／プラン期限切れ／チャージが必要／チャージしてください」など、同様の意味を含む

使用例

python scripts/sorftime_walmart_product_analysis.py '{"operation":"searchByName","name":"wireless earbuds","pageIndex":1}'
python scripts/sorftime_walmart_product_analysis.py '{"operation":"detail","productId":"5169493923"}'
python scripts/sorftime_walmart_product_analysis.py '{"operation":"trend","productId":"5169493923"}'
python scripts/sorftime_walmart_product_analysis.py '{"operation":"salesVolume","productId":"5169493923","queryDate":"2026-07-01","queryEndDate":"2026-07-31","pageIndex":1}'

表示ルール

  1. 操作と、指定された製品名または製品 ID を示し、返された requestConsumed、costCredit、costToken を表示してください。_cache.hit=true の場合は、キャッシュされた値が元のライブリクエストを表し、新たな本番環境での課金は発生していないことを明確にしてください。
  2. searchByName では、結果を完全一致ではなく関連製品として示し、リクエストしたページを報告してください。
  3. detail では、ProductSummeryObject から返されたフィールドのみを表示し、欠落している属性を推測しないでください。
  4. trend では、変化を要約する前に、レスポンス内の時間フィールドと単位を特定してください。
  5. salesVolume では、行を [date, sales, type] として解釈してください。type=2 は前日の販売記録を示します。
  6. 推定値や観測値は正確に区別して表示し、Walmart の取引が確実に発生したかのように示さないでください。

重要な制限事項

  • この連携は Walmart US のみを対象としています。
  • API は、1 回の呼び出しにつき 1 つの商品名または 1 つの Product ID と 1 つの操作を受け付けます。
  • 過去データの対象期間とデータの利用可否は Sorftime が管理しています。
  • ページネーションまたは 2 回目の操作を行うと、追加の有料呼び出しが発生し、ユーザーの承認が必要です。
  • searchByName は自然言語による関連商品の検索であり、複数のフィルターを使った商品データベース検索やカテゴリー市場検索ではありません。

ユーザーの表現とシナリオのクイックリファレンス

適用対象：自然言語の商品名から Walmart の商品を見つける場合、または既知の ProductId とその詳細、トレンド、販売履歴を中心としたクエリ。

適用対象外：カテゴリー市場調査、キーワード指標／逆引き検索、複数条件による商品フィルタリング。

判断基準：ユーザーが商品名から関連商品を探している場合にのみ searchByName を使用してください。現在のスナップショットには detail、過去の属性には trend、日付付きの販売データには salesVolume のみを使用してください。

算力消耗ルール

動的ルールに基づいて課金されます。Sorftime Request 1 件あたりの現在の表示は 6 算力です。複数の Request を伴う操作では、ゲートウェイが注文全体に対して計算し、端数を切り上げます。最終的には、入口スクリプトが返す costCredit を確認してください。実際の請求額を requestConsumed × 6 で単純に代用しないでください。

ユーザーには算力消耗に応じた費用が発生します。確認を得ずに、別の operation や次のページを追加で呼び出さないでください。

フィードバック：

動作または結果がユーザーの意図と一致しない場合、ユーザーが称賛または不満を示した場合、あるいは改善の余地がある場合は、フィードバックを自動検出し、Feedback API を通じて報告してください。ユーザーの操作を中断せず、references/api.md に従ってください。

高品質でプロフェッショナルな越境 EC スキルをお探しの場合は、LinkFox Skills をご覧ください。

コメント

Markdown 対応