Tmall Keyword Search Advanced

Search Tmall by keyword and collect product listings with prices, sales text, shops, and images.

原文 · en-US訳文に戻す

データ収集 E-commerce & Retail Tmall Products

開発者

super_ig

料金

$0.12 / 48 件から

最終更新

2026-10-19

概要

Keyword searches on Tmall often mix official products, accessories, and lookalike listings behind the same buying intent. Collecting those search cards in one place makes it easier to review the visible assortment without losing the titles, shops, and images needed for a closer look.

This collection keeps listing details together with the search keyword that produced them. It is a starting point for assortment research and price-text comparison, not a replacement for opening a product page or confirming purchase conditions with a shop.

Data notes

The data describes product cards collected from Tmall keyword search. Results are delivered in ascending collection-time order, which is separate from the sorting used to select products during collection. Repeated product identifiers are consolidated across the delivered pages. You can start collection from a specified page; if omitted, collection starts from page 1.

Product titles, price text, sales count text, and shop names retain their source values. Price is not converted into another currency, and no assumptions are made about taxes, delivery charges, or promotional conditions. The sales measurement period and the time zone of Collection time are not specified.

Missing brand, review count, platform, or listing status values remain missing rather than being inferred from a product title. A blank preview does not assert that the corresponding source value is an empty string. The collection should not be treated as a verified catalog of official Tmall products or a quotation for a particular order.

What the results look like

Each row represents a product card from Tmall keyword search. Quoted Price and Sales count values are text, not converted numbers.

Product ID	Product title	Price	Sales count	Shop name	Keyword
627049150327	闪魔适用iPhone17钢化膜苹果18promax手机膜13/15防摔16pro新款duo折叠14全屏X/XR保护11屏幕12pm官ip贴膜Air	"48.39"	"10万+"	闪魔旗舰店	iphone 18 pro max
654826062393	倍思新无界膜适用苹果iPhone18钢化膜AR抗反射17ProMax保护膜16Pro无尘仓15手机贴膜14全屏13覆盖12防指纹11	"91.96"	"10万+"	baseus倍思旗舰店	iphone 18 pro max

Additional columns include Image URL, Shop ID, Collection time, and List position.

Use cases

Compare an assortment: group Product title by recurring product or accessory terms, then use Product ID and Shop name to inspect the distinct listings behind each group.
Review displayed pricing: compare Price for listings with similar Product title wording, keeping the original price text and checking purchase conditions before drawing conclusions.
Prepare a research shortlist: combine Keyword, Product title, Image URL, and Shop name to identify relevant candidates, and retain Collection time so later reviews can distinguish collection snapshots.

適用範囲と境界

One keyword per run; the requested collection target is 1-2,000 products, not a strict result limit. Results are returned in complete source pages of about 48 products and may include fewer or more than requested. Fetch protection is 110 pages / 2,200 records; reaching this capacity does not establish completeness.

適している用途
Find Tmall search listings for keyword-based product research and assortment comparison.

適さない用途
Do not use this for product-page details, reviews, guaranteed real-time quotes, or a strictly capped result count.

失敗時の処理

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

1If submission times out or its outcome is unknown, check the existing run before submitting again: repeated submissions can create separate jobs.
2For rejected input or credentials, correct the input or access configuration before retrying.
3An empty result does not by itself mean that the source explicitly reported no data. Partial success may yield an incomplete collection; reaching the fetch protection capacity also requires a completeness check.

入力

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

Search keywordkeyword必須string
Enter one Tmall product search keyword, from 1 to 512 characters.
例iphone 18 pro max
Expected product counttarget_count必須string
Enter a whole number from 1 to 2000 as digits only. This is a collection target, not a strict cap; results are returned in complete source pages of about 48 products, so the actual count can be lower or higher.
例25
Collection sort ordersort任意string(enum)
Choose how products are ordered during collection; the default is Default. Delivered results remain in ascending collection-time order.
選択可能な値Default0Sales: high to low2Price: low to high51Price: high to low52デフォルト0
Starting pagestartPage任意string
Enter a positive integer page number to start collection from; if omitted, collection starts from page 1.
デフォルト1例1

出力

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

Product IDspu_idstring
Tmall product identifier.
例627049150327
Product titleproduct_titlestring
Product title as collected, without translation.
例闪魔适用iPhone17钢化膜苹果18promax手机膜13/15防摔16pro新款duo折叠14全屏X/XR保护11屏幕12pm官ip贴膜Air
Pricepricestring
Price text as collected; no currency or numeric conversion is applied.
例48.39
Sales countsale_countstring
Sales count text as collected; the measurement period is not specified.
例10万+

サンプルデータ

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

output.example

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

自分の API Keys を表示 →

AI に設定を任せる

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

detail.access.mcp.composeHint

料金

48 returned records

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

$0.12/ 48 件

Per task submitted

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

$0.0001/ 回

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

Credits を確認

今すぐ試す

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

サンプル

パラメータは送信前に input.schema で検証されます

Search keywordkeyword*Enter one Tmall product search keyword, from 1 to 512 characters.

Expected product counttarget_count*Enter a whole number from 1 to 2000 as digits only. This is a collection target, not a strict cap; results are returned in complete source pages of about 48 products, so the actual count can be lower or higher.

Collection sort ordersort（任意）Choose how products are ordered during collection; the default is Default. Delivered results remain in ascending collection-time order.

Starting pagestartPage（任意）Enter a positive integer page number to start collection from; if omitted, collection starts from page 1.