mcpField
L
linkfox-sorftime-walmart-category-market

linkfox-sorftime-walmart-category-market

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

linkfox-sorftime-walmart-category-market について

この LinkFox スキルは Sorftime のデータを使い、Walmart US のカテゴリ階層取得、自然言語によるカテゴリ照合、既知カテゴリの市場レポートと返却された Best Seller 商品の確認を行います。1 回のリクエストで実行する操作は 1 つで、商品やキーワードのデータは対象外です。

主な機能

  1. 01カテゴリ階層全体の取得
  2. 02自然言語のカテゴリ名を照合
  3. 03既知のパスでカテゴリレポートを取得
  4. 04レポート内の Best Seller 商品を確認

活用シーン

  1. 01Walmart US のカテゴリ階層を閲覧
  2. 02カテゴリの説明から関連カテゴリを照合
  3. 03既知カテゴリの市場指標と売れ筋商品を確認

MCP 対応

入力には MCP インターフェースや MCP 関連機能の説明がありません。

インストール

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

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

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

同梱ファイル

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

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

詳細

Walmart カテゴリ市場調査

Sorftime のデータを使って、Walmart US のカテゴリ階層を取得したり、自然言語のカテゴリ名を照合したり、特定カテゴリの市場レポートと返された Best Seller 商品を確認したりできます。

主な概念

  • リクエストごとに operation を必ず 1 つだけ指定してください。操作を自動で連続実行しないでください。呼び出しごとに Sorftime Requests を消費します。
  • tree はカテゴリ階層全体を返し、その他の業務パラメーターは必要ありません。
  • searchByName は自然言語のカテゴリ名を受け取り、関連するカテゴリの一致候補を最大 3 件返します。
  • marketReport には既知の nodePath が必要です。カテゴリ名からパスを推測してはいけません。
  • すべてのフィールドは JSON ボディのトップレベルにフラットに配置します。operation の値は大文字と小文字を区別します。

操作の振り分け

意図operationその他のパラメーターSorftime Request
カテゴリツリーをダウンロードするtreeなし5
自然言語のカテゴリ名を照合するsearchByNamename1
カテゴリ市場レポートを照会するmarketReportnodePath5

パラメーターとレスポンスの詳細は references/api.md に記載されています。

呼び出し方法

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

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

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

データの読み取りに関する推奨事項：まず概要を見て十分か判断してください。具体的なフィールドが必要な場合は、保存された json ファイルから jq または ConvertFrom-Json を使って必要なデータだけを抽出し、JSON 全体がコンテキストに入るのを避けてください。

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

以下の異常が発生した場合は、references/onboarding.md の手順に従って問題を解決してください。

  • API Key が未設定：環境変数 LINKFOX_AGENT_API_KEY も LINKFOXAGENT_API_KEY も設定されていない
  • レスポンスのステータスコードが 401 または 402
  • レスポンスに計算リソースまたは残高の不足が示されている：メッセージに「算力余额不足／计费不足／余额不足／quota exceeded／insufficient balance／套餐到期／需充值／请充值」または類似の意味が含まれている

使用例

python scripts/sorftime_walmart_category_market.py '{"operation":"tree"}'
python scripts/sorftime_walmart_category_market.py '{"operation":"searchByName","name":"patio furniture"}'
python scripts/sorftime_walmart_category_market.py '{"operation":"marketReport","nodePath":"4044_623679_1032619_5842891_9823303"}'

ユーザーが自然言語のカテゴリ名を指定した場合は、searchByName を優先してください。tree は階層全体をたどる必要がある場合にのみ使用してください。ツリーのレスポンスは約 10 MB になることがあるため、通常は --inline を使わず、保存した JSON から必要なデータだけを確認してください。

表示ルール

  1. 選択した操作を明記し、返された場合は requestConsumed、costCredit、costToken を表示してください。_cache.hit=true の場合、キャッシュされた値は元のライブリクエストを示し、新たな本番環境での課金は発生していないことを明確にしてください。
  2. tree では、一致したカテゴリ名、その ID 階層、そこから導出された nodePath を表示してください。ツリー全体を会話に出力してはいけません。
  3. searchByName では、返された NodeId と CategoryName のペアを最大 3 件まで表示し、完全一致ではなく関連する候補として示してください。
  4. marketReport では、返された指標のみを要約し、Best Seller 商品は簡潔に表示してください。
  5. 実際に返された Best Seller 商品の件数を明記し、カテゴリ全体の商品カタログであるかのように示してはいけません。
  6. 上流のフィールドの意味を保持し、欠落しているカテゴリの関係や指標を捏造してはいけません。

重要な制限事項

  • 3 つの操作はいずれも Walmart US を対象とします（domain=21 はバックエンドで適用されます）。
  • Sorftime はサードパーティセラーに適さないカテゴリを省略することがあります。カテゴリが見当たらないからといって、Walmart にそのカテゴリが存在しないとは限りません。
  • marketReport が受け付けるのは、アンダースコアで区切られた数値の nodePath であり、自由形式のカテゴリ名ではありません。
  • searchByName が返す関連カテゴリは最大 3 件で、完全一致は保証されません。
  • tree と marketReport はそれぞれ上流リクエストを 5 件、searchByName は 1 件消費します。ユーザーの許可なく再試行したり、別の操作を実行したりしてはいけません。
  • このスキルは商品データやキーワードデータには対応していません。

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

適用対象：Walmart のカテゴリー階層ツリー、自然言語によるカテゴリー照合、カテゴリーの NodeId／パス、カテゴリー市場、カテゴリーのベストセラーに関するリクエスト。

適用対象外：商品詳細／トレンド／売上、キーワード指標、保存済みキーワードの管理。

境界の判断：主な対象が Walmart の商品 ID の場合は、商品分析を使用してください。カテゴリー名には searchByName、階層の探索には tree、既知のカテゴリー パスには marketReport を使用してください。

計算リソース消費ルール

動的ルールに基づいて課金されます。単一の Sorftime Request は現在 6 計算リソースとして表示されます。複数の Request を行う操作は、ゲートウェイが操作全体に対して計算して端数を丸めます。最終的には、エントリースクリプトが返す costCredit を基準としてください。requestConsumed × 6 で実際の請求額を単純に代用しないでください。

ユーザーは計算リソースの消費に対して料金を支払います。別の operation を実行する前に、必ずユーザーに知らせ、続行するかどうかをユーザーに判断してもらってください。

フィードバック：

スキルの動作や結果が意図と一致しない場合、ユーザーが称賛や不満を表明した場合、または改善の余地がある場合は、Feedback API を通じてフィードバックを自動検出し、報告してください。ユーザーの操作を中断することなく、references/api.md に記載された方法で呼び出してください。

高品質でプロフェッショナルな越境 EC スキルについては、LinkFox Skills をご覧ください。

コメント

Markdown 対応