概要
タオバオのキーワード検索では、同じ購買意図の裏に正規品、アクセサリー、類似商品が混在することがよくあります。検索カードを一箇所に集めると、詳しく見るために必要な商品名、ショップ、画像を残したまま、見える品ぞろえを確認しやすくなります。
このデータは掲載情報と、それを生んだ検索キーワードをセットで残します。品ぞろえ調査や価格テキスト比較の出発点であり、商品ページを開くことや、ショップで購入条件を確認することを置き換えるものではありません。
データについて
データはタオバオのキーワード検索から収集した商品カードです。結果は収集時刻の昇順で提供され、収集対象を選ぶ際の並び順とは異なります。複数ページに同じ商品IDがある場合はまとめられます。 指定したページから収集を開始できます。指定しない場合は1ページ目から始まります。
商品名、価格テキスト、販売数テキスト、ショップ名は元の値を保持します。価格は別通貨に換算せず、税金、送料、販促条件も推測しません。販売数の集計期間と収集時刻のタイムゾーンは指定されていません。
ブランド、レビュー数、プラットフォーム、掲載状態が欠けている場合、商品名から推測して補完しません。プレビューの空欄は、取得元の値が空文字列であることを意味しません。正規のタオバオ商品カタログや、特定注文の見積もりとして扱わないでください。
結果の例
各行はタオバオキーワード検索の商品カード1件です。引用符付きの価格と販売数は、数値変換していないテキストです。
| 商品ID | 商品名 | 価格 | 販売数 | ショップ名 | キーワード |
|---|---|---|---|---|---|
| 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 |
追加列には画像URL、ショップID、収集時刻、リスト位置があります。
利用シーン
- 品ぞろえ比較:商品名を繰り返し現れる商品・アクセサリー表現でグループ化し、商品IDとショップ名で各グループの掲載を確認する。
- 表示価格の確認:似た商品名の掲載で価格を比べ、元の価格テキストを保ったまま、結論を出す前に購入条件を確認する。
- 調査ショートリスト:キーワード、商品名、画像URL、ショップ名を組み合わせて候補を洗い、収集時刻を残して後からスナップショットを区別する。
適用範囲と境界
1回につき1キーワード。収集目標は1~2,000件で、結果件数の厳密な上限ではありません。結果は約48件のソースページ単位で返り、目標を下回る場合も上回る場合もあります。取得保護上限は110ページ/2,200件で、この上限への到達は完全性を保証しません。
- 適している用途
- キーワード調査や品ぞろえ比較のために、タオバオの検索掲載情報を取得するとき。
- 適さない用途
- 商品詳細ページ、レビュー、リアルタイムの確定見積、または結果件数の厳密な上限が必要な場合は使わないでください。
失敗時の処理
開発者が宣言した失敗時と再試行の動作です。連携時にはシステムプロンプトに含めることをおすすめします。
- 1送信がタイムアウトした、または結果が不明な場合は、再送信する前に既存の実行を確認してください。繰り返し送信すると別ジョブが作られることがあります。
- 2入力や認証情報が拒否された場合は、再試行前に入力またはアクセス設定を修正してください。
- 3空の結果だけでは、ソースがデータなしと明示したことにはなりません。部分成功では収集が不完全なことがあり、取得保護上限に達した場合も完全性の確認が必要です。
入力
この App の呼び出しに必要なパラメータで、manifest.json の input.schema から生成されています。
- 検索キーワード
keyword必須stringタオバオの商品検索キーワードを1つ、1~512文字で入力します。例iphone 18 pro max - 期待する商品数
target_count必須string1から2000までの整数を数字のみで入力します。これは収集目標であり厳密な上限ではありません。結果は約48件のソースページ単位で返るため、実際の件数は目標より少ないことも多いこともあります。例25 - 収集時の並び順
sort任意string(enum)収集対象を選ぶ際の並び順を選びます。デフォルトは「デフォルト」です。納品結果は収集時刻の昇順のままです。選択可能な値デフォルト0売上の高い順2価格の安い順51価格の高い順52デフォルト0 - 開始ページ
startPage任意string収集を開始するページ番号を正の整数で入力します。指定しない場合は1ページ目から開始します。デフォルト1例1
出力
1 件のレコードのフィールド構造で、manifest.json の output.schema から生成されています。
- 商品ID
spu_idstringタオバオの商品識別子です。例627049150327 - 商品名
product_titlestring収集された商品名で、翻訳しません。例闪魔适用iPhone17钢化膜苹果18promax手机膜13/15防摔16pro新款duo折叠14全屏X/XR保护11屏幕12pm官ip贴膜Air - 価格
pricestring収集された価格テキストで、通貨換算や数値変換は行いません。例48.39 - 販売数
sale_countstring収集された販売数テキストで、集計期間は指定されていません。例10万+
サンプルデータ
output.schema から生成したサンプルです。サンプル値のないフィールドには構造上のプレースホルダーを使用しています。
{
"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": {
"octoparse_datahub": {
"type": "http",
"url": "https://mcp-v2.octoparse.com?pin=super_ig/taobao-keyword-search-advanced",
"headers": { "Authorization": "Bearer <YOUR_API_KEY>" }
}
}
}AI に設定を任せる
設定を手作業で編集したくない場合は、インストールプロンプトをコピーして任意の AI クライアントに貼り付けてください。AI が自分のやり方でセットアップを完了します(プロンプトは AI があなたに API Key を尋ねる形になっているため、認証情報がチャット履歴や共有設定に残りません)。
detail.access.mcp.composeHint
料金
正常に返されたレコードの件数に応じて課金されます。失敗した実行には課金されません。 45 件を 1 つの課金単位とし、端数は 45 件に切り上げて課金されます。
返される件数にかかわらず、実行の送信 1 回ごとに課金されます。
複数の課金イベントはそれぞれ独立して累計されます。詳細は各項目をご覧ください。失敗した実行には課金されません。
Credits を確認今すぐ試す
パラメータを入力して実行してください。結果は実際の呼び出しによるものです。