mcpField
L
linkfox-tiktok-shop-product-detail

linkfox-tiktok-shop-product-detail

github.com/linkfox-aiデータ・データベース113104 回インストール2 週間前に更新
リポジトリ

linkfox-tiktok-shop-product-detail について

URLまたは19桁の商品IDから、TikTok Shopの1商品について現在の公開情報を取得するスキルです。地域を指定して価格、SKU、在庫、画像、販売者、レビュー、配送情報などを確認できますが、検索や履歴分析には対応しません。

主な機能

  1. 01URLまたは19桁IDで検索
  2. 02ストア地域の指定
  3. 03価格・SKU・在庫の抽出
  4. 04画像・販売者・レビュー情報の取得
  5. 05必要な項目を読めるJSON保存

活用シーン

  1. 01指定地域の商品価格と在庫の確認
  2. 02商品画像と販売者情報の抽出
  3. 03公開販売数とレビュー概要の確認

インストール

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

$npx skills add https://github.com/linkfox-ai/linkfox-skills --skill linkfox-tiktok-shop-product-detail

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

同梱ファイル

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

references/
api.md
onboarding.md
scripts/
onboarding.py
tiktok_shop_product_detail.py

詳細

TikTok Shop 商品詳細情報の取得

商品 URL または 19 桁の商品 ID を指定して、任意のマーケットプレイス地域における TikTok Shop 商品の最新の公開詳細情報を取得します。

基本概念

  • 1 回の呼び出しにつき 1 商品：productInput は 1 つの商品を指定します。検索やランキングのツールではありません。
  • マーケットプレイスのコンテキスト：region はストアフロントのコンテキストを選択します。デフォルトは US です。
  • 読みやすくグループ化されたデータ：サービスは、安定した読みやすい商品詳細情報のグループを返します。
  • 最新のスナップショット：値はリクエスト時に公開ストアフロントで表示される情報を反映しており、過去の分析データではありません。

データフィールド

data 内の各オブジェクトには、次のトップレベルグループが含まれる場合があります。

フィールド説明
productIdTikTok Shop の商品 ID
statusプラットフォームの商品ステータスコード。このフィールドだけで購入可能かどうかを判断しないでください
title商品名
categoryカテゴリー名と ID
pricing通貨、販売価格、元の価格、割引、価格情報のソースフィールド
sales公開されている販売数と関連する販売表示データ
inventory在庫総数、SKU、バリエーションのプロパティ、価格、デフォルトの選択内容
media商品画像の URL と画像メタデータ
seller販売者 ID、ショップ名、評価、所在地、利用可能なショップデータ
reviews利用可能な場合の公開レビュー概要
shipping利用可能な場合の物流および配送モジュール
actions購入ボタンとお気に入り状態のデータ
additionalその他の読みやすいプロモーション、権利、レビュー投稿、商品モジュール

ネストされたフィールドは商品や地域によって異なります。欠落しているフィールドを推測して追加せず、返された値をそのまま保持してください。

パラメーターガイド

パラメーター必須デフォルト説明
productInputはい-tiktok.com またはそのサブドメイン上の TikTok HTTPS URL。デフォルトの HTTPS ポートを使用し、product/<19-digit-id> を含むパスを指定します。または、文字列として渡す 19 桁の商品 ID
regionいいえUS大文字のストアフロントコード：US、GB、ID、MY、TH、VN、PH、SG、DE、FR、IT、または ES

呼び出し方法

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

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

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

使用例

商品 URL

python scripts/tiktok_shop_product_detail.py '{"productInput":"https://shop.tiktok.com/view/product/1729937400435937604","region":"US"}'

英国ストアフロントの商品 ID

python scripts/tiktok_shop_product_detail.py '{"productInput":"1729937400435937604","region":"GB"}'

表示ルール

  1. 商品タイトル、商品 ID、指定された地域、カテゴリ、返却されたステータスを最初に表示します。
  2. 返却された通貨でセール価格／通常価格を表示します。ユーザーから別途依頼がない限り、通貨を換算しないでください。
  3. SKU バリエーション、各バリエーションの価格、在庫が取得できる場合は、表にまとめて表示します。
  4. 商品画像は必要に応じてインラインで表示します。ただし、すべての画像を並べて表示しないでください。
  5. 販売者、公表されている販売数、レビューの概要、配送情報は、取得できる場合にのみ表示します。
  6. status、在庫、購入ボタンのデータを合わせて確認します。1 つのフィールドだけを根拠に商品を「購入可能」と判断しないでください。
  7. 欠落しているフィールド、空のフィールド、または矛盾するフィールドは、推測せずに取得不可として報告します。
  8. 大きなネストされたセクションは、まず要約し、必要に応じて保存済み JSON から正確なフィールドを読み取ります。

重要な制限事項

  1. 公開されているフィールドは、商品、販売者、地域、ストアフロントのコンテキストによって異なる場合があります。
  2. URL 入力には product/<19-digit-id> のパスセグメントが必要です。別の TikTok URL 形式を利用できない場合は、19 桁の商品 ID を直接使用してください。
  3. 商品が削除済み、購入不可、または在庫切れであっても、構造化メタデータが返される場合があります。
  4. このツールは、過去の価格／在庫の推移、ランキング一覧、または保証された売上分析を提供しません。
  5. このツールは、認証済みの販売者アカウントを管理したり、商品リストを編集したりしません。販売者向けの操作には TikTok Shop ERP の商品スキルを使用してください。
  6. SKU、メディア、配送、追加モジュールにネストされたソースフィールドが含まれるため、読み取り可能な応答が大きくなることがあります。

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

適用可能 — 特定済みの TikTok Shop 商品 1 点：

ユーザーの発言シナリオ
“查这个 TikTok Shop 链接的商品详情”URL による詳細検索
“这个 19 位 TikTok 商品 ID 卖什么？”商品 ID による検索
“看看这个商品的价格、SKU 和库存”現在の商品リストの確認
“提取这个 TikTok 商品的图片和店铺信息”メディアと販売者情報の抽出

適用不可：

  • TikTok の商品検索、ベストセラーランキング、複数商品のスクリーニング
  • 過去の GMV、クリエイター、ライブ配信、動画アトリビューション分析
  • 認証済みショップでの商品リストの作成、編集、価格変更、在庫変更
  • TikTok の動画ページやクリエイタープロフィールの分析

算力消耗规则

算力を 63 消費します。

ユーザーには算力消費に応じた料金が発生します。異なる地域や商品を再度検索すると、それぞれ別途課金されます。続けて呼び出す前に、追加の消費についてユーザーに知らせてください。

フィードバック：

説明されている機能と実際の動作が異なる場合、結果がユーザーの意図に沿わない場合、ユーザーが称賛や不満を表明した場合、またはスキルを改善できる場合は、Feedback API を介してフィードバックを自動検出し、報告してください。ユーザーの操作を中断せずに references/api.md に従ってください。

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

コメント

Markdown 対応