logo
JP

Tmallキーワード検索

Tmallの検索キーワードと期待件数を指定すると、価格・売上・ショップ情報付きの商品一覧を取得します。

翻訳済み · ja-JP原文を表示

データ収集E-commerce & RetailTmallProducts
開発者
super_ig
料金
$0.02 / 10 件から
最終更新
2026-10-19

概要

Tmallのキーワード検索では、同じ購買意図の裏に旗艦店、正規販売店、アクセサリー出品が混在します。検索結果カードを一覧にすると、どの商品・ショップ・価格帯が実際に表示されるかを、個別ページを開かずに判断しやすくなります。

このコレクションは、Tmall検索結果の元の商品タイトル、表示価格、売上テキストを残します。品揃え、順位、リストページの価格を調達や競合レビューの入力にする場合に役立ち、商品詳細の確認や購入判断の代わりにはなりません。

データ説明

データは、公開のTmallキーワード検索結果から収集した商品カードです。結果は収集時刻の昇順で配信され、収集時に商品を選ぶ並び順とは別です。重複するSPU IDは配信ページをまたいでまとめられます。

商品タイトル、価格、売上数はソースのテキストを保持します。価格は別通貨へ換算せず、税、プロモーション、購入条件についての仮定もしません。ビジネスID、キーワード、送信キーワードは同じ検索語句を持つことがあり、いずれも一意の商品識別子ではありません。収集タイムスタンプと作成タイムスタンプは返されたテキストのまま保持され、機械的なタイムスタンプ文字列を含む場合があります。収集時刻のタイムゾーンは指定されていません。

ブランド、プラットフォーム、レビュー数、出品ステータスの欠落は推測で埋めません。プレビューが空白でも、ソース値が空文字であることは意味しません。このコレクションを完全なTmallカタログ、在庫スナップショット、特定注文の確定オファーとして扱わないでください。

結果はどのような形か

各行はTmall検索結果の1出品です。引用した価格と売上数はテキストであり、換算した数値ではありません。

SPU ID商品タイトル価格売上数ショップ名
627049150327闪魔适用iPhone17钢化膜苹果18promax手机膜13/15防摔16pro新款duo折叠14全屏X/XR保护11屏幕12pm官ip贴膜Air"48.39""10万+"闪魔旗舰店
654826062393倍思新无界膜适用苹果iPhone18钢化膜AR抗反射17ProMax保护膜16Pro无尘仓15手机贴膜14全屏13覆盖12防指纹11"91.96""10万+"baseus倍思旗舰店

追加列には画像URL、ソースページ、リスト位置、収集時刻があります。

利用シーン

  • 検索の品揃えを比較する: 商品タイトルを繰り返す商品・アクセサリー語でグループ化し、SPU IDとショップ名で同じキーワード裏の別出品を分けます。
  • 表示価格を確認する: 似た商品タイトルの価格と売上数を比べ、競争力を判断する前に元のテキストを残します。
  • 候補リストを作る: キーワード、商品タイトル、画像URL、ショップ名を組み合わせて候補を選び、収集時刻を残して後からスナップショットを区別します。

適用範囲と境界

1回のタスクでTmall検索キーワードは1件、期待件数は1～2000件。結果は約10件のソースページ単位で収集され、指定件数より少ないことも多いこともあります。取得保護は110ページ / 2,200件で、この容量に達しても完全性は保証されません。対象は公開のTmall検索結果のみです。

  • 適している用途
  • ブランド、商品、カテゴリのキーワードに対するTmall検索結果の商品が必要なとき。
  • 一致した出品をショップ、価格、順位、公開の売上シグナルと結び付けた一覧が必要なとき。
  • 適さない用途
  • 商品詳細ページ、バリエーション、レビュー、価格履歴が必要な場合。このAppが返すのは検索結果カードの情報のみです。
  • 件数の厳密な上限や、単一レコードの即時照会が必要な場合。

失敗時の処理

開発者が宣言した失敗時と再試行の動作です。連携時にはシステムプロンプトに含めることをおすすめします。

  1. 1送信がタイムアウトした、または結果が不明な場合は、再送信する前に既存の実行を確認してください。繰り返し送信すると別タスクが作られることがあります。
  2. 2一致する記録が返らない場合は、より短い、または広い検索語句で再送信してください。
  3. 3部分成功後は取得済みの記録を残し、失敗または期限切れのあとは同じ入力で再送信してください。
  4. 4レート制限、一時的な利用不可、タイムアウトのあとは時間をおいて再試行してください。
  5. 5認証に失敗した場合は、実行環境に設定したAPI Keyを確認してください。

入力

この App の呼び出しに必要なパラメータで、manifest.json の input.schema から生成されています。

  • 検索キーワードkeyword必須string
    Tmall商品検索キーワードを1つ、1～512文字で入力します。
    例iphone 18 pro max
  • 期待商品数target_count必須string
    1～2000の整数を数字のみで入力します。これは収集目標であり厳密な上限ではありません。約10件のソースページ単位で収集されるため、実際の件数は指定より少ないことも多いこともあります。返却分は10件単位で課金されます。
    例25
  • 収集時の並び順sort必須string(enum)
    収集時に商品をどの順で選ぶかを指定します。デフォルトはTmallの標準順位です。配信結果は収集時刻の昇順のままです。
    選択可能な値デフォルト0売上2価格の安い順51価格の高い順52デフォルト0例0
  • 収集開始ページstartPage任意string
    このページから収集を開始する正の整数を入力します。空欄の場合は上流サービスが開始ページを決定するため、明示的な入力を推奨します。このパラメーターは期待する商品数を変更しません。

出力

1 件のレコードのフィールド構造で、manifest.json の output.schema から生成されています。

  • SPU IDspu_idstring
    出品を区別するためのTmall商品識別子。
    例627049150327
  • ビジネスIDbiz_idstring
    出品に残る検索キーワードであり、一意の商品識別子ではありません。
    例iphone 18 pro max
  • 商品タイトルproduct_titlestring
    収集されたままの商品タイトル（翻訳なし）。
    例闪魔适用iPhone17钢化膜苹果18promax手机膜13/15防摔16pro新款duo折叠14全屏X/XR保护11屏幕12pm官ip贴膜Air
  • 価格pricestring
    収集されたままの価格テキスト。通貨換算や数値変換はしません。
    例48.39

サンプルデータ

output.schema から生成したサンプルです。サンプル値のないフィールドには構造上のプレースホルダーを使用しています。

output.example
{
  "spu_id": "627049150327",
  "biz_id": "iphone 18 pro max",
  "product_title": "闪魔适用iPhone17钢化膜苹果18promax手机膜13/15防摔16pro新款duo折叠14全屏X/XR保护11屏幕12pm官ip贴膜Air",
  "price": "48.39",
  "sale_count": "10万+",
  "rate_count": "<rate_count>",
  "brand_name": "<brand_name>",
  "image_url": "https://g.search.alicdn.com/img/bao/uploaded/i4/i2/793375733/O1CN01VFo3XC93RRC2vH2e_!!4611686018427384821-0-item_pic.jpg",
  "shop_id": "793375733",
  "shop_name": "闪魔旗舰店",
  "keyword": "iphone 18 pro max",
  "list_index": "0",
  "now_page": "1",
  "platform": "<platform>",
  "status": "<status>",
  "crawl_time": "2026-10-13T16:47:55",
  "task_item": "iphone 18 pro max",
  "task_no_data": false
}

連携方法

この App は MCP、API、SDK、ファイルエクスポートのいずれでも連携でき、どのチャネルも同じ能力と料金を共有します。すべてのリクエストは Authorization: Bearer ヘッダーで認証し、認証情報には API Key（長期有効。Data Hub コンソールで作成）を使用します。MCP クライアントは OAuth によるキー不要のログインにも対応しています。CLI や Skill など、さらに多くの連携方法も準備中です。 この App は非同期で実行され、途中でキャンセルできます：キャンセル後、実行は停止します。納品済みのレコードは保持され、課金対象になります。

MCP（Model Context Protocol）を使うと、Claude や Cursor などの AI クライアントからこの App を直接呼び出せます。クライアントと認証方式を選び、下の設定をコピーしてください。

クライアント設定

Bearer の後の値を長期有効な API Key に置き換えてください。あらゆるクライアント、CI、ヘッドレス環境で利用できます。

mcpServers config
{
  "mcpServers": {
    "octoparse_datahub": {
      "type": "http",
      "url": "https://mcp-v2.octoparse.com?pin=super_ig/tmall-keyword-search",
      "headers": { "Authorization": "Bearer <YOUR_API_KEY>" }
    }
  }
}
自分の API Keys を表示 →

AI に設定を任せる

設定を手作業で編集したくない場合は、インストールプロンプトをコピーして任意の AI クライアントに貼り付けてください。AI が自分のやり方でセットアップを完了します（プロンプトは AI があなたに API Key を尋ねる形になっているため、認証情報がチャット履歴や共有設定に残りません）。

detail.access.mcp.composeHint

料金

タスク送信

返される件数にかかわらず、実行の送信 1 回ごとに課金されます。

$0.0001/ 回
返却10件

正常に返されたレコードの件数に応じて課金されます。失敗した実行には課金されません。 10 件を 1 つの課金単位とし、端数は 10 件に切り上げて課金されます。

$0.02/ 10 件

複数の課金イベントはそれぞれ独立して累計されます。詳細は各項目をご覧ください。失敗した実行には課金されません。

Credits を確認

今すぐ試す

パラメータを入力して実行してください。結果は実際の呼び出しによるものです。

サンプル
パラメータは送信前に input.schema で検証されます
$0.02 / 10 件から