linkfox-temu-ads-global

Temu グローバルサイト — EC 広告（Ads）

このスキル（linkfox-temu-ads-global）は、Partner Platform for Global の Ads／EC 広告（広告プラン、配信、レポートなど）を対象とします。menu_code と各 sub_menu_code は Partner 管理画面に準拠します。詳しくは partner-global-catalog.md を参照してください。

Partner の Ads（temu.searchrec.ad.*）インターフェースを 7 件接続済みです。一覧は partner-global-catalog.md を参照してください。

ゲートウェイ（本スキルに組み込み済み）：

機能	メソッド	パス
広告 OpenAPI（global_ads_*、temu_global_proxy）	POST	https://tool-gateway.linkfox.com/temu/proxy
署名付きファイルのダウンロード	POST	https://tool-gateway.linkfox.com/temu/fileDownload

関連スキル

用途	スキル
広告 Ads（本スキル）	linkfox-temu-ads-global
商品一覧／詳細／編集／在庫／出品・出品停止	linkfox-temu-manage-product-global
プロモーション／マーケティングキャンペーン	linkfox-temu-promotion-global
商品登録	linkfox-temu-add-product-us
価格／供給価格、価格設定シート	linkfox-temu-price-global
注文一覧／詳細	linkfox-temu-order-global
返品・返金	linkfox-temu-returns-refunds-global
ゲートウェイと 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-ads-global-<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／プラン期限切れ／チャージが必要／チャージしてください」、または類似の内容が含まれている場合。

デフォルトパラメーター

フィールド	デフォルト値	説明
site	global	Partner Global
managementType	semi-managed	半委託管理（具体的なインターフェースについては Partner のドキュメントに準拠します）
tokenPurpose	product-inventory	セラーアシスタントのデフォルト値（Partner の Ads インターフェースで別の tokenPurpose が必要な場合は、そのインターフェースのドキュメントに準拠します）

認証

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_ads_searchrec_ad_roas_pred.py	temu.searchrec.ad.roas.pred
global_ads_searchrec_ad_reports_mall_query.py	temu.searchrec.ad.reports.mall.query
global_ads_searchrec_ad_create.py	temu.searchrec.ad.create
global_ads_searchrec_ad_detail_query.py	temu.searchrec.ad.detail.query
global_ads_searchrec_ad_log_query.py	temu.searchrec.ad.log.query
global_ads_searchrec_ad_goods_create_query.py	temu.searchrec.ad.goods.create.query
global_ads_searchrec_ad_modify.py	temu.searchrec.ad.modify

新しいインターフェースの接続（取り決め）

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

1. references/apis/<type-slug>.md を追加する（入出力パラメーターの階層をすべて記載）
2. scripts/global_ads_<slug>.py を追加する（_global_ads_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-ads-global

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

スクリプト	説明
check_linkfox_token.py	LinkFox ユーザー Token の検証
temu_token_guide.py	Temu 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

計算リソース消費ルール

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