JP

Rakuten 商品詳細

Rakuten の商品ページURLの一覧を渡すと、タイトル、商品ID、ショップ、掲載ステータス、SKU詳細を取得します

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

開発者
料金
$0.004 / 件から
最終更新
2026-09-18

概要

Rakuten Product Details は、すでに分かっている日本の商品ページを1件1行のスナップショットにします。タイトル、商品ID、ショップ、掲載ステータス、SKUテキスト、ページURLをそろえ、カタログ担当や競合調査チームは各ページを開かずに楽天の出品を比較できます。

価値は商品ページそのもののスナップショットです。タイトル、掲載ステータス、SKUテキストはソース言語のまま残り、SKU詳細内の価格文字列は元の数字を保ち、送信したURLは無データフラグと同じ行にあるため、どの対象が取れたかを確認できます。

データ説明

各レコードは、公開されている楽天商品ページを収集時点で撮った商品詳細スナップショットです。行は送信した商品URLで重複排除されます。掲載ステータスとURLステータスは収集時点のページ値であり、ライブの決済状態ではありません。SKU詳細は価格文字列を含むソース原文のまま残り、通貨はソースに示されていません。収集時刻はソース提供の表記で、タイムゾーンはありません。作成タイムスタンプと更新タイムスタンプはUnixミリ秒です。

対象は、完全な楽天商品URLから到達できる公開商品ページだけです。利用できない、または無効なページでも無データフラグ付きの行として残ることがあります。検索結果、レビュー、販売履歴、ライブ在庫は含まれません。

結果の形

各レコードは、収集時点の楽天商品スナップショット1件です。

商品IDショップID掲載ステータス商品URLSPU ID
10005020406191在售https://item.rakuten.co.jp/alice00/19rdv6003/19rdv6003
10000405346082在售https://item.rakuten.co.jp/store-ecovacs-japan/dkx55-12ee/dkx55-12ee

結果にはビジネスID、送信URL、商品タイトル、メイン画像、SKU詳細、収集時刻、更新タイムスタンプ、URLステータス、無データフラグも含まれます。

利用シーン

  • カタログ作成では、商品ID、商品タイトル、ショップIDを台帳にし、収集時刻でスナップショットの新しさを判断します。
  • 競合確認では、ショップIDでまとめ、商品タイトル、掲載ステータス、URLステータスを比較します。
  • 仕様と価格の抽出では、SKU詳細を読み、送信URLと無データフラグでどのページが取れたかを確認します。

適用範囲と境界

1回の実行で最大200件のRakuten商品ページURLを送信できます。各URLは詳細1行または無データフラグを返します。結果は収集時刻順で安定して返り、業務フィールドの絞り込み、集計、独自ソートは行いません。

  • 適している用途
  • 既知のRakuten商品ページのタイトル、商品ID、ショップ、掲載ステータス、SKU詳細をまとめて必要なとき
  • 後のカタログや競合分析のために商品URL、メイン画像、SKUテキストを残しておきたいとき
  • 適さない用途
  • キーワードで商品を発見したいとき — このアプリは既知の商品ページURLの詳細だけを返します
  • レビュー、販売履歴、過去価格が必要なとき — このアプリは商品詳細のスナップショットだけを返します
  • ライブの決済価格や在庫が必要なとき — 掲載ステータスとSKU価格は収集時点のページ値です

失敗時の処理

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

  1. 1行が無データとマークされた場合は、商品ページURLが完全で、いまも公開されているかを確認してください
  2. 2レート制限、リクエストタイムアウト、一時的なサービスエラーのときは、同じURL一覧で後から再試行してください
  3. 3認証失敗、タスクコンテキスト不一致、タスク期限切れのときはそのまま再試行せず、実行資格情報を確認するか新しく送信してください
  4. 4一部成功の場合、完了した商品行は返されます。失敗件数と無データ件数はタスクステータスから確認できます

入力

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

  • 商品ページURLitems必須array<object>
    詳細を収集するRakuten商品ページです。各項目は商品ページの完全なURL1件です。1〜200件まで送信できます。
    件数最大 200 件例[{"item":"https://item.rakuten.co.jp/alice00/19rdv6003/"}]

出力

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

  • ビジネスIDbiz_idstring
    Rakuten商品詳細レコードの業務識別子。通常は商品ページURLです
    例https://item.rakuten.co.jp/alice00/19rdv6003/
  • レビュー数comment_countstring
    商品ページに表示されるレビュー数のテキスト
    例0
  • 収集時刻crawl_timestring
    商品スナップショットの収集時刻テキスト。ソース値にタイムゾーンはありません
    例2026-09-14T11:34:55
  • 作成タイムスタンプcreated_atinteger
    レコード作成時のUnixミリ秒タイムスタンプ
    例1789356895498

サンプルデータ

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

output.example
{
  "biz_id": "https://item.rakuten.co.jp/alice00/19rdv6003/",
  "comment_count": "0",
  "crawl_time": "2026-09-14T11:34:55",
  "created_at": 1789356895498,
  "item": "https://item.rakuten.co.jp/alice00/19rdv6003/",
  "job_type": "BasicInfo",
  "main_image_url": "<main_image_url>",
  "platform_code": "rakuten",
  "product_id": "10005020",
  "product_title": "Anker Soundcore Liberty 5 Pro Max 完全ワイヤレスイヤホン Bluetooth 6.1 ノイズキャンセリング LDAC ハイレゾ Dolby Atmos AIボイスレコーダー",
  "product_url": "https://item.rakuten.co.jp/alice00/19rdv6003/",
  "shop_id": "406191",
  "skus": "[{\"discount\": null, \"images\": null, \"originalPrice\": \"34500.0\", \"price\": \"34500.0\", \"skuId\": \"19rdv6003-00\", \"skuName\": \"ミッドナイトブラック\"}, {\"discount\": null, \"images\": null, \"originalPrice\": \"34500.0\", \"price\": \"34500.0\", \"skuId\": \"19rdv6003-01\", \"skuName\": \"シャンパンゴールド\"}]",
  "source_name": "rakuten_detail_202609",
  "spu_id": "19rdv6003",
  "status_code": "在售",
  "task_item": "https://item.rakuten.co.jp/alice00/19rdv6003/",
  "no_data": false,
  "updated_at": 1789356895498,
  "url_status": "有效"
}

連携方法

この 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/rakuten-product-detail",
      "headers": { "Authorization": "Bearer <YOUR_API_KEY>" }
    }
  }
}

AI に設定を任せる

設定を手作業で編集したくない場合は、インストールプロンプトをコピーして任意の AI クライアントに貼り付けてください。AI が自分のやり方でセットアップを完了します(デフォルトではログインを案内し、API Key をチャットに送るよう求めることはありません)。

detail.access.mcp.composeHint

料金

商品詳細タスクを1件開始

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

$0.0001/ 回
商品詳細レコードを1件返す

正常に返されたレコードの件数に応じて課金されます。失敗した実行には課金されません。

$0.004/ 件

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

Credits を確認

今すぐ試す

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

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