mcpField
L
linkfox-temu-promotion-us

linkfox-temu-promotion-us

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

linkfox-temu-promotion-us について

Temu米国の出店者向けに、LinkFoxゲートウェイ経由でPartnerのプロモーションAPIを呼び出すスキルです。活動や候補商品の照会、商品登録、更新に対応します。

主な機能

  1. 016種類のプロモーションAPI呼び出し
  2. 02活動と候補商品の照会
  3. 03活動商品の照会と更新
  4. 04商品をプロモーションに登録
  5. 05汎用プロキシと署名付きファイルのダウンロード

活用シーン

  1. 01参加可能なプロモーション活動の確認
  2. 02活動の候補商品の検索
  3. 03商品の登録または活動内容の更新
  4. 04プロモーション関連ファイルのダウンロード

インストール

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

$npx skills add https://github.com/linkfox-ai/linkfox-skills --skill linkfox-temu-promotion-us

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

同梱ファイル

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

references/
access-token.md
api.md
authorization-flow.md
onboarding.md
partner-us-catalog.md
references/apis/
bg-promotion-activity-candidate-goods-query.md
bg-promotion-activity-goods-enroll.md
bg-promotion-activity-goods-operation-query.md
bg-promotion-activity-goods-query.md
bg-promotion-activity-goods-update.md
bg-promotion-activity-query.md
README.md
scripts/
_temu_auth_guide.py
_temu_common.py
_temu_token_store.py
_temu_us_common.py
_us_promotion_script.py
check_linkfox_token.py
get_temu_access_token.py
list_temu_access_tokens.py
onboarding.py
save_temu_access_token.py
temu_file_download.py
temu_proxy.py
temu_token_guide.py
temu_us_file_download.py
temu_us_proxy.py
us_promotion_activity_candidate_goods_query.py
us_promotion_activity_goods_enroll.py
us_promotion_activity_goods_operation_query.py

詳細

Temu 米国サイト — EC プロモーション（Promotion）

このスキル（linkfox-temu-promotion-us）は、Partner Platform for US の Promotion / EC プロモーション（プロモーションキャンペーン、クーポン、キャンペーンへの参加申請など。Partner 管理画面のメニュー名は Marketing/Promotion と表示される場合があります）に関連する bg.* / temu.* インターフェースを対象とします（menu_code と各 sub_menu_code は Partner 管理画面に準じます。partner-us-catalog.md を参照してください）。

Partner の Promotion インターフェース 6 件を接続済みです。一覧は partner-us-catalog.md を参照してください。

ゲートウェイ（このスキルに内蔵）：

機能メソッドパス
プロモーション OpenAPI（us_promotion_*、temu_us_proxy）POSThttps://tool-gateway.linkfox.com/temu/proxy
署名付きファイルのダウンロードPOSThttps://tool-gateway.linkfox.com/temu/fileDownload

関連スキル

シナリオスキル
プロモーション／マーケティングキャンペーン（このスキル）linkfox-temu-promotion-us
広告 Adslinkfox-temu-ads-us
商品リスト／詳細／編集／在庫／出品・出品停止linkfox-temu-manage-product-us
商品登録linkfox-temu-add-product-us
価格／仕入れ価格、価格設定シートlinkfox-temu-price-us
注文リスト／詳細linkfox-temu-order-us
返品と返金linkfox-temu-returns-refunds-us
ゲートウェイと Temu tokenこのスキルの scripts/

呼び出し方法

  • API エンドポイント：POST /temu/proxy（操作ごとにリクエストボディで区別します。完全なパラメーター／レスポンス／エラーコードは references/api.md を参照してください）
  • Python スクリプト：python scripts/<脚本名>.py '<JSON 参数>' [--inline]（利用可能なスクリプトは上記のスクリプト一覧を参照してください）
  • コストに関する制約：このツールは計算リソースを消費します。失敗した場合や結果が空の場合に、キーワードの変更、ページ送り、連続した試行を自動で行ってはいけません。検索を続ける必要がある場合は、追加の消費が発生することを事前にユーザーに伝えてください。

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

  • 常に完全なレスポンスを <cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-temu-promotion-us-<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／プランの有効期限切れ／チャージが必要／チャージしてください」または類似の意味の内容が含まれています。

デフォルトパラメーター

フィールドデフォルト値説明
siteusPartner US
managementTypesemi-managedセミマネージド（具体的なインターフェースは Partner のドキュメントに準じます）
tokenPurposeproduct-inventory商品／プロモーションのシナリオに準じます（access-token.md を参照してください）

認証

  1. LinkFox：LINKFOXAGENT_API_KEY → Header Authorization + Token
  2. Temu：accessToken または storeKey（storeKey の場合は tokenPurpose=product-inventory を付けることを推奨します）

スクリプト

スクリプト説明
temu_us_proxy.py任意の type
temu_us_file_download.py署名付きダウンロード
us_promotion_activity_query.pybg.promotion.activity.query
us_promotion_activity_candidate_goods_query.pybg.promotion.activity.candidate.goods.query
us_promotion_activity_goods_query.pybg.promotion.activity.goods.query
us_promotion_activity_goods_enroll.pybg.promotion.activity.goods.enroll
us_promotion_activity_goods_operation_query.pybg.promotion.activity.goods.operation.query
us_promotion_activity_goods_update.pybg.promotion.activity.goods.update

新しいインターフェースの接続（規約）

Partner のドキュメント（type + sub_menu_code + URL + Request/Response パラメーターテーブル）を 1 件提供するたびに、以下を行います。

  1. references/apis/<type-slug>.md を追加する（完全な入力／出力の階層）
  2. scripts/us_promotion_<slug>.py を追加する（_us_promotion_script.run_cli を呼び出します）
  3. partner-us-catalog.md、apis/README.md、およびこの表を更新する

例（汎用プロキシ）

export LINKFOXAGENT_API_KEY="<key>"

python scripts/temu_us_proxy.py '{
  "accessToken": "TOKEN",
  "tokenPurpose": "product-inventory",
  "type": "<TEMU_API_TYPE>",
  "params": {
    "request": {}
  }
}'

Feedback： skillName：linkfox-temu-promotion-us

ゲートウェイと認証スクリプト

スクリプト説明
check_linkfox_token.pyLinkFox ユーザー Token を検証します
temu_token_guide.pyTemu accessToken の管理画面での認証手順
save_temu_access_token.pyaccessToken をローカルに保存します
list_temu_access_tokens.py保存済み token の一覧を表示します
get_temu_access_token.py保存済み token を読み取ります
temu_proxy.py汎用ゲートウェイ転送（複数 site）
temu_file_download.py署名付きファイルのダウンロード（複数 site）

認証について：references/access-token.md

計算リソースの消費ルール

計算リソースを消費しません。

コメント

Markdown 対応