linkfox-lanjing-mercado-product-selection

Lanjing Mercado Libre 商品選定

このスキルは、LinkFox ゲートウェイを通じて Mercado Libre の商品、カタログ、キーワード、カテゴリー、トレンド、販売者、レビュー、為替レート、プラン利用状況のデータを照会します。ゲートウェイが公開する統一ルートは POST /lingdong/call のみで、このスキルは対応する arguments とともに、サポートされている24個の toolName のうち1つを選択します。

基本概念

• ${LINKFOX_TOOL_GATEWAY}/lingdong/call のみを呼び出してください。上流の Lanjing XP-MCP サーバーを直接呼び出してはいけません。また、上流の secret-key / X-API-Key をユーザーに尋ねないでください。上流の認証情報はバックエンドが管理しています。
• リクエストボディは常に {"toolName":"...","arguments":{...}} です。スクリプトはこのオブジェクト全体を1つの JSON 引数として受け取ります。
• arguments 内のフィールド名は、references/lanjing-mercado-tool-reference.md の記載と完全に一致させてください。siteId、itemId、productId、categoryId、runDate、runMonth、pageNo、pageSize などのキャメルケースの名前も含みます。
• 結果を提示するときは、まず data を確認してください。data がテキスト、または内容が不明確な場合は contentText を確認してください。rawResponse は、ユーザーから生の診断情報を求められた場合にのみ表示してください。
• 有料ツールの現在の料金は1回の呼び出しあたり 16000 トークンで、無料ツールの料金は 0 です。バックエンドの costToken フィールドを優先してください。

参照ファイル

• references/api.md：LinkFox ゲートウェイの仕様、リクエスト／レスポンスの構造、エラーコード、curl の例、Feedback API。
• references/lanjing-mercado-tool-reference.md：24個の Mercado Libre ツールの詳細な中国語のリファレンス。パラメーター、サイト ID、ページネーション、並べ替え、課金状況について記載されています。

ツールの選択

ユーザーの意図	使用するツール
商品詳細、商品販売履歴、商品検索	itemInfo、itemHistory、itemSearch
カタログ／商品ページの詳細、カタログ販売履歴、カタログ検索	catalogInfo、catalogHistory、catalogSearch
日次／月次の人気キーワード、逆引きトラフィックキーワード	keywordDateSearch、keywordMonthSearch、keywordReverse
有料分析の前のカテゴリー検索	categorySearch、categorySmallSearch
カテゴリー別ブランド、商品、販売者、新商品、価格、販売数、販売履歴、統計、倉庫分布	trendBrandTopBrand、trendBrandTopItem、trendBrandTopSeller、trendNewItems、trendPrice、trendSale、trendSoldHis、trendStatistical、trendStoreInventoryType
販売者検索	sellerSearch
商品レビュー	reviewSearch
為替レートとパッケージ利用状況	rateInfo、myUsage

無料ツール：categorySearch、categorySmallSearch、reviewSearch、rateInfo、myUsage。それ以外はすべて有料です。

パラメーターガイド

• toolName（string、必須）：上記24個のツールのいずれか。
• arguments（object、必須）：ツールのパラメーターオブジェクトです。配列、文字列、数値ではなく、JSON オブジェクトでなければなりません。バックエンドは uId／uid／memberId を除去し、空の値をトリミングします。
• サイト：MLM（メキシコ）、MLB（ブラジル）、MLA（アルゼンチン）、MLC（チリ）、MCO（コロンビア。リファレンスに明記されているツールのみ）。
• ユーザーが categoryId ではなくカテゴリー名を指定した場合は、まず categorySearch または categorySmallSearch を呼び出し、返されたカテゴリー ID を有料のトレンド／商品／カタログツールで使用してください。
• reviewSearch が受け取るのは itemId のみです（siteId は不要）。myUsage が受け取るのは {} です。
• 幅広い調査の質問では、サイト、カテゴリー、キーワード、日付／月、ページネーション、価格、販売数、並べ替えのフィルターを使って、有料呼び出しの範囲を絞ってください。ユーザーの目的に結び付かない探索的な有料呼び出しは避けてください。

呼び出し方法

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

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

• 常に完全なレスポンスを <cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-lanjing-mercado-product-selection-<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/套餐到期/需充值/请充值」または同様の意味の内容が含まれています。

使用例

単一の JSON 引数は、完全なペイロード {"toolName":...,"arguments":{...}} です。

# Free: search Mexico categories by name
python scripts/linkfox_lanjing_mercado_product_selection.py '{"toolName":"categorySearch","arguments":{"siteId":"MLM","searchText":"Auriculares"}}'

# Paid: product detail for a real MLM item
python scripts/linkfox_lanjing_mercado_product_selection.py '{"toolName":"itemInfo","arguments":{"siteId":"MLM","itemId":"MLM4979447466"}}'

# Free: my plan usage (no arguments)
python scripts/linkfox_lanjing_mercado_product_selection.py '{"toolName":"myUsage","arguments":{}}'

# Paid: monthly hot keywords for Brazil, 2026-06
python scripts/linkfox_lanjing_mercado_product_selection.py '{"toolName":"keywordMonthSearch","arguments":{"siteId":"MLB","runMonth":"202606"}}'

PowerShell では、同様に JSON をシングルクォートで囲んでください。引用符の扱いが難しい場合は、ペイロードをファイルに書き込み、読み込んだ後に --inline で渡すか、ConvertTo-Json を使って引数を作成してください。

表示ルール

1. サポートされていないビジネス上の結論を作り出さず、返されたデータを明確に提示してください。
2. 結果の意味と重要なフィールド名を保持してください。読みやすさが向上する場合に限り、ラベルを翻訳してください。
3. 大きな配列や時系列データについては、表示されている範囲を要約し、保存された JSON ファイルから必要なフィールドのみを読み取ってください。
4. 「データなし」やビジネスレベルの失敗メッセージについては、上流の Mercado データプロバイダーがその結果を返したことを説明してください。ラッパーのレスポンスに実際のエラーが含まれていない限り、システム障害とみなしてはいけません。
5. 内部の LinkFox API キー、上流のシークレット、または機微な生データの全内容を、ユーザー向けの出力に含めてはいけません。

重要な制限事項

• LinkFox のルートは統合バックエンドゲートウェイです。このスキルは toolName ごとに個別の HTTP エンドポイントを公開していません。
• 必須フィールドの検証はバックエンドで行われ、references/lanjing-mercado-tool-reference.md にも記載されています。
• 有料ツールは、上流のビジネス上の結果が空であっても、バックエンドの呼び出しごとに課金されます。
• レスポンスの形式はツールによって異なります。ほとんどのツールは data にビジネス上の結果をテキストとして返します。単一のテーブルスキーマを無理に適用せず、実際のレスポンスと references/api.md を正確な情報源として使用してください。

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

ユーザーの発言	想定されるアクション
「この美客多の商品を調べて」「商品詳細」「販売履歴」	itemInfo または itemHistory を使用します
「メキシコサイトでイヤホンを検索」「商品を絞り込む」	itemSearch を使用します。カテゴリのテキストしかわからない場合は、最初に categorySearch を使用します
「公式リンク」「catalog」「カタログリンク」	catalog* ツールを使用します
「キーワードの人気検索」「月間キーワード」「トラフィックキーワードの逆引き」	keywordDateSearch、keywordMonthSearch、または keywordReverse を使用します
「カテゴリのトレンド」「新商品機会」「販売分布」「ブランドランキング」	categoryId を特定してから、trend* ツールを使用します
「店舗」「seller」	sellerSearch を使用します
「レビュー」「reviews」	reviewSearch を使用します
「為替レート」「プランの使用量」	rateInfo または myUsage を使用します

ポイント消費ルール

12ポイントを消費します。

ユーザーはポイントの消費に対して料金を支払います。十分に検討してください。このスキルを高頻度で呼び出す必要がある場合や、ユーザーがポイントの消費量を十分に把握していない場合は、必ずユーザーに注意を促し、続行するかどうかはユーザーに判断してもらってください。

フィードバック

スキルの動作、ドキュメント、または結果の提示がユーザーの意図と一致しない場合、ユーザーが称賛や不満を表明した場合、または具体的な改善点が見つかった場合は、Feedback API を通じてフィードバックを自動検出して報告してください。references/api.md に従ってください。ユーザーのタスクを中断せず、シークレット、個人データ、大量のレスポンス全体を報告してはいけません。

---

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