linkfox-wallysmarter-product-detail

WallySmarter の商品詳細

このスキルは、WallySmarter 経由で Walmart の詳細な商品情報を取得します。価格履歴や販売数量の推移も含まれます。

主な概念

WallySmarter の商品詳細は、ItemId を指定して Walmart の商品を1件検索し、包括的な商品属性に加えて、過去の価格や販売データを返します。検索・商品一覧レベルで動作する、より広範な linkfox-walmart-search スキルを補完する、商品レベルの詳細調査ツールです。

データの範囲：現在の商品属性（タイトル、価格、ブランド、評価、フルフィルメントの種類など）を返します。includeStats が有効な場合（デフォルト）、過去の統計情報も含まれます。

非構造化出力：このツールは、構造化データと非構造化データが混在した結果を返します。@智能数据查询 による二次分析には対応していません。

パラメーターガイド

パラメーター	型	必須	デフォルト	説明
productId	integer	はい	—	Walmart の Item ID。商品 URL（https://www.walmart.com/ip/<productId>）で確認できます
includeStats	boolean	いいえ	true	過去の価格と販売データを含めるかどうか

商品データのフィールド

フィールド	説明
title	商品タイトル
description	商品の説明
price	現在の販売価格（USD）
wasPrice	取り消し線付き価格（USD）
minPrice	最低価格（USD）
brand	ブランド名
rating	平均評価（0.0～5.0）
reviews	レビューの合計数
salesEstimate	推定販売数量（個）
revenue	推定売上高（USD）
sellerName	販売者名
fulfillmentType	フルフィルメント：MARKETPLACE または WFS
productPageUrl	商品ページの URL
imageUrl	商品画像の URL
departmentName	部門カテゴリ名
departmentId	部門 ID
listingScore	商品リスティングの品質スコア
contentScore	コンテンツの品質スコア
outOfStock	在庫状況：0＝在庫あり、1＝在庫切れ
sponsored	広告フラグ：0＝オーガニック、1＝スポンサー付き
isBranded	ブランドフラグ：0＝いいえ、1＝はい
multipleOptionsAvailable	バリエーションフラグ：0＝いいえ、1＝はい
usItemId	内部 US Item ID
createdAt	商品の作成日時
updatedAt	最終更新日時
stats	過去の価格と販売動向データのオブジェクト

使用例

1. 基本的な商品検索（履歴あり） 価格や販売動向を含む、Walmart 商品の詳細情報を取得します：

{"productId": 5177343351}

2. 商品詳細のみ（履歴なし） 過去のデータを除いて商品属性を取得し、応答を速めます：

{"productId": 5169493923, "includeStats": false}

表示ルール

1. データをわかりやすく提示する：商品詳細を構造化された形式で表示します。依頼がない限り、主観的なビジネス上の提案は追加しないでください。
2. 価格の表示形式：値下げをわかりやすく示すため、利用可能な場合は現在価格と wasPrice を併記します。必ず USD の通貨記号を表示してください。
3. 動向の要約：stats データがある場合は、価格と販売の動向を要約します（例：「過去30日間で価格が15％下落しました」）。
4. スコアの説明：listingScore と contentScore の意味を説明します（数値が高いほど、リスティングの品質が高いことを示します）。
5. 在庫とフルフィルメント：在庫切れの商品とフルフィルメントの種類（WFS または Marketplace）を明確に示します。
6. 商品は1件ずつ：このツールで一度に検索できる商品は1件です。複数の商品が必要な場合は、ItemId ごとにツールを呼び出してください。

重要な制限事項

• Walmart の ItemId（商品 URL 内の数値 ID）による検索のみ対応しています
• 非構造化データを返すため、二次分析を行う @智能数据查询 には対応していません
• 1回の呼び出しにつき ItemId は1件です。一括検索には複数回の呼び出しが必要です
• 過去データを利用できるかどうかは、WallySmarter の追跡範囲によって異なります

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

該当するケース — Walmart の単一商品の詳細調査：

ユーザーの発言	シナリオ
"查一下这个Walmart商品的详情"	基本的な商品情報の検索
"这个沃尔玛产品最近价格走势如何"	価格動向の分析
"WallySmarter查Walmart商品5177343351"	ID による直接検索
"沃尔玛这个产品销量怎么样"	販売数の推定確認
"Walmart product detail for item XX"	英語での表現
"这个Walmart产品最近有没有降价"	価格変更の検出

該当しないケース — 単一商品の詳細を超える内容が必要な場合：

• キーワードによる Walmart 商品検索（linkfox-walmart-search を使用）
• 複数商品の一括比較
• Walmart の出品者アカウントや広告指標
• リアルタイムの在庫状況や配送予定
• カテゴリーレベルの市場分析

適用範囲の判断：ユーザーが特定の Walmart 商品 ID または URL を指定し、詳細な属性、価格履歴、販売動向を知りたい場合は、このスキルが該当します。キーワードやカテゴリーで商品を検索・閲覧したい場合は、代わりに linkfox-walmart-search を使用してください。

認証とコンピューティングリソースの問題を解決する

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

異常な状況

• API Key が未設定：環境変数 LINKFOX_AGENT_API_KEY も LINKFOXAGENT_API_KEY も設定されていません。
• 401 または 402 のステータスコードが返される
• コンピューティングリソースまたは残高不足のメッセージが返される：メッセージに「算力余额不足/计费不足/余额不足/quota exceeded/insufficient balance/套餐到期/需充值/请充值」または類似の意味の内容が含まれている場合。

コンピューティングリソースの消費ルール

動的ルールに基づいて課金されます：コンピューティングリソースの消費量 = tokens × 10.5。商品詳細のみを検索し、履歴統計を含めない場合、tokens = 1 です。過去 90 日間の履歴統計もあわせて検索する場合、商品詳細 1 件あたりの tokens = 2 です。

重要：このスキルのサービスでは倍率に応じて動的に計算されるため、一度に大量のコンピューティングリソースを消費する可能性があります。必ずユーザーに知らせ、続行するかどうかをユーザーに判断してもらってください。

フィードバック：

以下のいずれかに該当する場合は、Feedback API を通じてフィードバックを自動検出して報告してください。

1. このスキルで説明されている機能や目的が実際の動作と一致しない
2. スキルの結果がユーザーの意図と一致しない
3. ユーザーがこのスキルへの不満や称賛を表明する
4. 改善できると思われることがある

references/api.md に記載されているとおりに Feedback API を呼び出してください。ユーザーの作業を中断しないでください。

---

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