mcpField
L
linkfox-temu-promotion-global

linkfox-temu-promotion-global

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

linkfox-temu-promotion-global について

Temuグローバルサイトの販売者向けに、Partner Promotion APIを操作するスキルです。キャンペーンや商品を照会し、商品登録や登録商品の更新を行えます。

主な機能

  1. 01Promotion API 6種に対応
  2. 02キャンペーンの照会
  3. 03候補商品と登録商品の確認
  4. 04キャンペーンへの商品登録
  5. 05登録商品の更新
  6. 06署名付きファイルのダウンロード

活用シーン

  1. 01登録可能なキャンペーンの検索
  2. 02候補商品と登録商品の確認
  3. 03キャンペーン商品の登録・更新

MCP 対応

Agent向けのスキルで、Temu Partner PlatformのPromotion APIを呼び出します。組み込みゲートウェイとPythonスクリプトが操作窓口です。

インストール

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

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

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

同梱ファイル

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

references/
access-token.md
api.md
authorization-flow.md
onboarding.md
partner-global-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/
_global_promotion_script.py
_temu_auth_guide.py
_temu_common.py
_temu_global_common.py
_temu_token_store.py
check_linkfox_token.py
get_temu_access_token.py
global_promotion_activity_candidate_goods_query.py
global_promotion_activity_goods_enroll.py
global_promotion_activity_goods_operation_query.py
global_promotion_activity_goods_query.py
global_promotion_activity_goods_update.py
global_promotion_activity_query.py
list_temu_access_tokens.py
onboarding.py
save_temu_access_token.py
temu_file_download.py
temu_global_file_download.py

詳細

Temu グローバルサイト — EC プロモーション（Promotion）

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

Partner の Promotion インターフェース 6 件に対応しています。一覧は partner-global-catalog.md を参照してください。

ゲートウェイ（この skill に組み込み済み）：

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

関連する skill

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

呼び出し方法

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

出力ポリシー（スクリプトのデフォルト動作）：

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

デフォルトパラメーター

フィールドデフォルト説明
siteglobalPartner Global
managementTypesemi-managed半管理（詳細は各インターフェースの Partner ドキュメントに従います）
tokenPurposeproduct-inventory商品／プロモーションのシナリオに合わせます（access-token.md を参照）

認証

  1. LinkFox：LINKFOXAGENT_API_KEY → Header Authorization + Token
  2. Temu：accessToken または storeKey（storeKey の場合は tokenPurpose=product-inventory の指定を推奨）

Scripts

スクリプト説明
temu_global_proxy.py任意の type
temu_global_file_download.py署名付きダウンロード
global_promotion_activity_query.pybg.promotion.activity.query
global_promotion_activity_candidate_goods_query.pybg.promotion.activity.candidate.goods.query
global_promotion_activity_goods_query.pybg.promotion.activity.goods.query
global_promotion_activity_goods_enroll.pybg.promotion.activity.goods.enroll
global_promotion_activity_goods_operation_query.pybg.promotion.activity.goods.operation.query
global_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/global_promotion_<slug>.py を追加（_global_promotion_script.run_cli を呼び出す）
  3. partner-global-catalog.md、apis/README.md、およびこの表を更新

例（汎用プロキシ）

export LINKFOXAGENT_API_KEY="<key>"

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

フィードバック： skillName：linkfox-temu-promotion-global

网关与授权脚本

脚本说明
check_linkfox_token.py校验 LinkFox 用户 Token
temu_token_guide.pyTemu accessToken 后台授权步骤
save_temu_access_token.py保存 accessToken 到本地
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 対応