概要
Taobaoの店舗ページは、販売者がいま扱っている商品を見る手がかりですが、商品名、価格、画像、販売表示がページ上で一緒に動き、比較可能なデータとして残しにくいものです。このアプリは1つの店舗IDを商品単位のカタログにまとめ、品ぞろえや価格帯を手作業で転記せずに確認できるようにします。
すでに知っている商品を開くのではなく、店舗そのものに並んでいる品ぞろえを見ます。商品の識別子、掲載上の販売信号、店舗の文脈を同じ行に保つことで、価格帯の把握や掲載の変化確認がしやすくなります。
データについて
各レコードは指定したTaobao店舗の公開掲載商品です。返却データ内では商品IDで重複をまとめます。元アイテムと事業IDは店舗の文脈を保持し、同じタスクの多くの商品で繰り返されることがあります。掲載は安定した収集時刻の昇順で返されます。
価格は通貨フィールドのない文字列です。販売数は表示用の文字列で、省略表記やプラス記号を含むことがあるため、監査済みの取引件数としては扱いません。収集時刻のタイムゾーンは未指定です。作成タイムスタンプは元文字列で、ミリ秒がJSON文字列になっている場合があります。データなしフラグは、該当商品がなかった店舗アイテムと通常の掲載行を区別します。
対象は指定店舗の公開掲載に限られます。他店舗、商品詳細の仕様、レビュー、注文データは含まれません。
結果の例
各行は送信した店舗に紐づくTaobao掲載商品1件、または該当なしの目印です。
| 商品名 | 商品ID | 価格 | 販売数 | 店舗名 | 店舗ID |
|---|---|---|---|---|---|
| 十二烷基苯磺酸 烷基苯磺酸 直链烷基苯磺酸 磺酸 500g/瓶 | 12230885327 | 16 | 9000+ | 优索样品 杨静店 | 35318526 |
| 烷基糖苷,烷基多糖苷,APG0810 APG0814 APG1214 APG10 APG06 | 14370874962 | 12.5 | 7000+ | 优索样品 杨静店 | 35318526 |
商品画像、販売者ID、店舗URL、収集時刻、データなしフラグも、レコードに含まれる場合は利用できます。商品名と店舗名は元の言語のままの場合があります。
活用例
- 品ぞろえを把握するときは、「店舗ID」でまとめ、「商品名」と「価格」を比べて見える商品構成と価格帯を確認します。
- 販売の勢いを見るときは、「販売数」と「商品名」を並べ、監査済みの販売総数とはみなさずに、画面上の需要が強い掲載を探します。
- カタログの変化を追うときは、後の収集で「商品ID」と「店舗ID」を比べ、再登場した商品や一覧から消えた商品を確認します。
適用範囲と境界
1回のタスクでTaobao店舗IDは1件、希望商品件数は1~2,000件です。この件数は収集目標であり結果の上限ではありません。取得保護枠は最大1,000ページ、各ページ最大1,000件です。対象は公開されているTaobao店舗の掲載商品に限られます。
- 適している用途
- 1店舗のTaobao商品カタログのスナップショットが必要な場合。
- 店舗内の商品名、表示価格、公開の販売表示を比較したい場合。
- 適さない用途
- 商品詳細の仕様や顧客レビューが必要な場合。
- バックグラウンド収集ではなく即時の単発照会が必要な場合。
失敗時の処理
開発者が宣言した失敗時と再試行の動作です。連携時にはシステムプロンプトに含めることをおすすめします。
- 1商品が返らない場合は店舗IDを確認して再送信してください。
- 2一部成功の結果は保持し、失敗または期限切れのあとは同じ店舗で再送信してください。
- 3レート制限、一時的な利用不可、タイムアウトのあとは後で再試行してください。
- 4結果件数は希望件数を超えることがあります。希望件数は厳密な上限ではありません。
入力
この App の呼び出しに必要なパラメータで、manifest.json の input.schema から生成されています。
- Taobao店舗ID
shop_id必須string商品一覧を収集するTaobao店舗のIDです。1タスクにつき1件、1~512文字で入力します。例35318526 - 希望商品件数
crawl_count必須integer収集の希望件数を1~2,000の範囲で入力します。これは収集目標であり結果の上限ではないため、実際の件数は上回ることがあります。返却レコードが20件に満たない場合も20件として課金されます。範囲1–2000例25 - 収集時の並び順
sort_order必須string(enum)総合順、販売順、新着順から選びます。返却行は収集時刻順のままです。選択可能な値総合順1販売順2新着順4例1
出力
1 件のレコードのフィールド構造で、manifest.json の output.schema から生成されています。
- 事業ID
biz_idstring掲載に付随する事業グループID。ない場合は空です。例35318526 - ブランド名
brand_namestring掲載に表示されたブランド名。ない場合は空です。 - 収集タイムスタンプ
collect_timestring収集時刻の文字列。ない場合は空です。 - 収集時刻
crawl_timestring掲載を収集した時刻。タイムゾーンは未指定です。例2026-10-13T16:00:32
サンプルデータ
output.schema から生成したサンプルです。サンプル値のないフィールドには構造上のプレースホルダーを使用しています。
{
"biz_id": "35318526",
"brand_name": "<brand_name>",
"collect_time": "<collect_time>",
"crawl_time": "2026-10-13T16:00:32",
"created_at": "{\"$numberLong\":\"1791878432670\"}",
"data_index": 0,
"date_payload": "<date_payload>",
"image_url": "https://img.alicdn.com/imgextra/i1/42083946/O1CN01UBjaXU1f1K1DjfGEC_!!42083946.jpg",
"now_page": "<now_page>",
"price": "16",
"product_title": "十二烷基苯磺酸 烷基苯磺酸 直链烷基苯磺酸 磺酸 500g/瓶",
"rate_count": "<rate_count>",
"root_url": "https://shop35318526.taobao.com",
"sale_count": "9000+",
"seller_id": "42083946",
"shop_id": "35318526",
"shop_name": "优索样品 杨静店",
"sort_value": "<sort_value>",
"spu_id": "12230885327",
"status": "<status>",
"source_item": "35318526",
"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-shop-product-list",
"headers": { "Authorization": "Bearer <YOUR_API_KEY>" }
}
}
}AI に設定を任せる
設定を手作業で編集したくない場合は、インストールプロンプトをコピーして任意の AI クライアントに貼り付けてください。AI が自分のやり方でセットアップを完了します(プロンプトは AI があなたに API Key を尋ねる形になっているため、認証情報がチャット履歴や共有設定に残りません)。
detail.access.mcp.composeHint
料金
返される件数にかかわらず、実行の送信 1 回ごとに課金されます。
正常に返されたレコードの件数に応じて課金されます。失敗した実行には課金されません。 20 件を 1 つの課金単位とし、端数は 20 件に切り上げて課金されます。
複数の課金イベントはそれぞれ独立して累計されます。詳細は各項目をご覧ください。失敗した実行には課金されません。
Credits を確認今すぐ試す
パラメータを入力して実行してください。結果は実際の呼び出しによるものです。