logo
JP

Taobao店舗の商品一覧

Taobaoの店舗IDと希望商品件数を指定すると、その店舗の掲載商品を商品名、価格、販売表示、画像付きで収集します。

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

開発者
super_ig
料金
$0.08 / 20 件から
最終更新
2026-10-13

概要

Taobaoの店舗ページは、販売者がいま扱っている商品を見る手がかりですが、商品名、価格、画像、販売表示がページ上で一緒に動き、比較可能なデータとして残しにくいものです。このアプリは1つの店舗IDを商品単位のカタログにまとめ、品ぞろえや価格帯を手作業で転記せずに確認できるようにします。

すでに知っている商品を開くのではなく、店舗そのものに並んでいる品ぞろえを見ます。商品の識別子、掲載上の販売信号、店舗の文脈を同じ行に保つことで、価格帯の把握や掲載の変化確認がしやすくなります。

データについて

各レコードは指定したTaobao店舗の公開掲載商品です。返却データ内では商品IDで重複をまとめます。元アイテムと事業IDは店舗の文脈を保持し、同じタスクの多くの商品で繰り返されることがあります。掲載は安定した収集時刻の昇順で返されます。

価格は通貨フィールドのない文字列です。販売数は表示用の文字列で、省略表記やプラス記号を含むことがあるため、監査済みの取引件数としては扱いません。収集時刻のタイムゾーンは未指定です。作成タイムスタンプは元文字列で、ミリ秒がJSON文字列になっている場合があります。データなしフラグは、該当商品がなかった店舗アイテムと通常の掲載行を区別します。

対象は指定店舗の公開掲載に限られます。他店舗、商品詳細の仕様、レビュー、注文データは含まれません。

結果の例

各行は送信した店舗に紐づくTaobao掲載商品1件、または該当なしの目印です。

商品名商品ID価格販売数店舗名店舗ID
十二烷基苯磺酸 烷基苯磺酸 直链烷基苯磺酸 磺酸 500g/瓶12230885327169000+优索样品 杨静店35318526
烷基糖苷,烷基多糖苷,APG0810 APG0814 APG1214 APG10 APG061437087496212.57000+优索样品 杨静店35318526

商品画像、販売者ID、店舗URL、収集時刻、データなしフラグも、レコードに含まれる場合は利用できます。商品名と店舗名は元の言語のままの場合があります。

活用例

  • 品ぞろえを把握するときは、「店舗ID」でまとめ、「商品名」と「価格」を比べて見える商品構成と価格帯を確認します。
  • 販売の勢いを見るときは、「販売数」と「商品名」を並べ、監査済みの販売総数とはみなさずに、画面上の需要が強い掲載を探します。
  • カタログの変化を追うときは、後の収集で「商品ID」と「店舗ID」を比べ、再登場した商品や一覧から消えた商品を確認します。

適用範囲と境界

1回のタスクでTaobao店舗IDは1件、希望商品件数は1~2,000件です。この件数は収集目標であり結果の上限ではありません。取得保護枠は最大1,000ページ、各ページ最大1,000件です。対象は公開されているTaobao店舗の掲載商品に限られます。

  • 適している用途
  • 1店舗のTaobao商品カタログのスナップショットが必要な場合。
  • 店舗内の商品名、表示価格、公開の販売表示を比較したい場合。
  • 適さない用途
  • 商品詳細の仕様や顧客レビューが必要な場合。
  • バックグラウンド収集ではなく即時の単発照会が必要な場合。

失敗時の処理

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

  1. 1商品が返らない場合は店舗IDを確認して再送信してください。
  2. 2一部成功の結果は保持し、失敗または期限切れのあとは同じ店舗で再送信してください。
  3. 3レート制限、一時的な利用不可、タイムアウトのあとは後で再試行してください。
  4. 4結果件数は希望件数を超えることがあります。希望件数は厳密な上限ではありません。

入力

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

  • Taobao店舗IDshop_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 から生成されています。

  • 事業IDbiz_idstring
    掲載に付随する事業グループID。ない場合は空です。
    例35318526
  • ブランド名brand_namestring
    掲載に表示されたブランド名。ない場合は空です。
  • 収集タイムスタンプcollect_timestring
    収集時刻の文字列。ない場合は空です。
  • 収集時刻crawl_timestring
    掲載を収集した時刻。タイムゾーンは未指定です。
    例2026-10-13T16:00:32

サンプルデータ

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

output.example
{
  "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 config
{
  "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回あたり

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

$0.0001/ 回
返却レコード20件

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

$0.08/ 20 件

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

Credits を確認

今すぐ試す

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

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