mcpField
L
linkfox-temu-add-product-us

linkfox-temu-add-product-us

github.com/linkfox-aiその他113333 回インストール2 週間前に更新
リポジトリ

linkfox-temu-add-product-us について

Temu 米国サイトの販売者向けに、Partner US APIを使った商品登録・管理を行うスキルです。V2登録APIとPythonスクリプトを備え、検索、編集、カテゴリ、在庫、価格を扱い、応答をJSONに保存します。

主な機能

  1. 01商品APIを19種類収録
  2. 02推奨V2商品登録に対応
  3. 03商品とカテゴリの検索・編集
  4. 04在庫と価格の取得・更新
  5. 05Pythonスクリプトと汎用プロキシ

活用シーン

  1. 01Temu米国サイトへの商品登録
  2. 02商品一覧や詳細の取得
  3. 03商品属性・在庫・価格の変更

インストール

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

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

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

同梱ファイル

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

references/
access-token.md
api.md
authorization-flow.md
category-spec-apis.md
onboarding.md
partner-us-catalog.md
product-edit-apis.md
product-publish-apis.md
product-query-apis.md
stock-price-apis.md
scripts/
_temu_auth_guide.py
_temu_common.py
_temu_token_store.py
_temu_us_common.py
_us_product_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_goods_add_legacy.py
us_goods_add.py
us_goods_attrs_bg.py
us_goods_attrs.py
us_goods_brand.py

詳細

Temu 米国サイト商品登録 API（Partner US）

この skill（linkfox-temu-add-product-us）は、Partner Platform for US の Product メニュー（menu_code=fb16b05f7a904765aac4af3a24b87d4a）にある 19 個の商品 API をカバーします。内訳は、V2 推奨商品登録 API が 4 個、標準商品 API が 15 個（照会、編集、カテゴリー、在庫、価格など）です。

ゲートウェイ（この skill に内蔵）：

機能メソッドゲートウェイパス
商品 OpenAPI（すべての us_goods_*、temu_us_proxy）POSThttps://tool-gateway.linkfox.com/temu/proxy
署名付きファイルのダウンロード（temu_us_file_download）POSThttps://tool-gateway.linkfox.com/temu/fileDownload

商品の type は Body に記述します。URL パスではありません。

注文用の skill ではありません：注文、発送、物流については、linkfox-temu-order-us またはその他のフルフィルメント系 skill をご覧ください。

呼び出し方法

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

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

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

デフォルトパラメーター

フィールドデフォルト説明
siteusPartner US
managementTypesemi-managedセミマネージド
tokenPurpose（storeKey）product-inventory酷鳥販売者アシスタントの token

認証

  1. LinkFox：LINKFOXAGENT_API_KEY → Header Authorization + Token
  2. Temu：accessToken または storeKey

Scripts

V2 推奨商品登録
スクリプトtype
us_goods_attrs.pytemu.local.product.attributes.get
us_goods_variation.pytemu.local.product.variation.get
us_goods_image_upload.pytemu.local.goods.image.v2.upload
us_goods_add.pytemu.local.goods.v2.add
照会／編集／カテゴリー／在庫
スクリプトtype
us_goods_list.pytemu.goods.list.get
us_goods_detail.pytemu.goods.detail.get
us_goods_update.pytemu.goods.update
us_goods_edit_property.pytemu.goods.edit.property
us_goods_edit_sensitive.pytemu.goods.edit.sensitive.attr
us_goods_migrate.pytemu.goods.migrate
us_goods_cats.pybg.goods.cats.get
us_goods_attrs_bg.pybg.goods.attrs.get
us_goods_parent_spec.pybg.glo.goods.parentspec.get
us_goods_brand.pybg.glo.goods.brand.get
us_goods_category_mapping.pybg.goods.category.mapping
us_goods_stock_get.pybg.btg.goods.stock.quantity.get
us_goods_stock_update.pybg.btg.goods.stock.quantity.update
us_goods_price_list.pytemu.goods.price.list.get
us_goods_add_legacy.pytemu.goods.add
temu_us_proxy.py任意の type
temu_us_file_download.py署名付きファイルのダウンロード

例

export LINKFOXAGENT_API_KEY="<key>"

# 商品列表
python scripts/us_goods_list.py '{"accessToken":"TOKEN","page":1,"pageSize":20}'

# 类目映射
python scripts/us_goods_category_mapping.py '{
  "accessToken":"TOKEN",
  "goodsName":"测试商品",
  "goodsNameEn":"Test Product"
}'

# V2 发品流程
python scripts/us_goods_attrs.py '{"accessToken":"TOKEN","params":{"catId":12345}}'
python scripts/us_goods_image_upload.py '{"accessToken":"TOKEN","params":{"image":"<BASE64>"}}'
python scripts/us_goods_add.py '{"accessToken":"TOKEN","params":{"..."}}'

フィードバック： skillName：linkfox-temu-add-product-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 対応