logo
languageJPdown
menu

Rakuten 商品詳細

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

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

概要

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 から生成されています。

フィールド業務名称型必須デフォルト列挙値/制約例説明
items商品ページURLarray<object>はい—最大 200 件[{"item":"https://item.rakuten.co.jp/alice00/19rdv6003/"}]詳細を収集するRakuten商品ページです。各項目は商品ページの完全なURL1件です。1〜200件まで送信できます。

出力

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

フィールド業務名称型例説明
biz_idビジネスIDstringhttps://item.rakuten.co.jp/alice00/19rdv6003/Rakuten商品詳細レコードの業務識別子。通常は商品ページURLです
comment_countレビュー数string0商品ページに表示されるレビュー数のテキスト
crawl_time収集時刻string2026-09-14T11:34:55商品スナップショットの収集時刻テキスト。ソース値にタイムゾーンはありません
created_at作成タイムスタンプinteger1789356895498レコード作成時のUnixミリ秒タイムスタンプ
item送信URLstringhttps://item.rakuten.co.jp/alice00/19rdv6003/この詳細行に対して送信された商品ページURL
job_type収集タイプstringBasicInfo商品詳細レコードに付く収集タイプの原文
main_image_urlメイン画像string—商品メイン画像のURL。ソースに画像がない場合は空です
platform_codeプラットフォームコードstringrakuten商品のマーケットプレイスプラットフォームコード
product_id商品IDstring10005020Rakutenの商品識別子
product_title商品タイトルstringAnker Soundcore Liberty 5 Pro Max 完全ワイヤレスイヤホン Bluetooth 6.1 ノイズキャンセリング LDAC ハイレゾ Dolby Atmos AIボイスレコーダー商品ページに表示される完全なタイトル
product_url商品URLstringhttps://item.rakuten.co.jp/alice00/19rdv6003/商品ページURL
shop_idショップIDstring406191商品を販売するショップの識別子
skusSKU詳細string[{"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": "シャンパンゴールド"}]SKU、価格、選択肢のテキストをソース原文のまま保持したもの
source_nameソース名stringrakuten_detail_202609詳細レコードに付くソースデータセット名
spu_idSPU IDstring19rdv6003出品の標準製品ユニット識別子
status_code掲載ステータスstring在售収集時点でページに表示されていた販売ステータス
task_itemクエリ項目stringhttps://item.rakuten.co.jp/alice00/19rdv6003/この行に対応する送信済み商品ページURL。安定したレコード識別子としても使います
no_data無データフラグbooleanfalseこの商品ページから利用可能な詳細が取れなかったかどうか
updated_at更新タイムスタンプinteger1789356895498レコード更新時のUnixミリ秒タイムスタンプ
url_statusURLステータスstring有效収集時点の商品ページURLの有効ステータス

レコード Schema

出力はレコード単位で 1 件ずつ返されます。 detail.output.idFieldHint

output.schema
{
  "type": "object",
  "properties": {
    "biz_id": {
      "type": "string",
      "title": "ビジネスID",
      "description": "Rakuten商品詳細レコードの業務識別子。通常は商品ページURLです",
      "prefill": "https://item.rakuten.co.jp/alice00/19rdv6003/"
    },
    "comment_count": {
      "type": "string",
      "title": "レビュー数",
      "description": "商品ページに表示されるレビュー数のテキスト",
      "prefill": "0"
    },
    "crawl_time": {
      "type": "string",
      "title": "収集時刻",
      "description": "商品スナップショットの収集時刻テキスト。ソース値にタイムゾーンはありません",
      "prefill": "2026-09-14T11:34:55"
    },
    "created_at": {
      "type": "integer",
      "title": "作成タイムスタンプ",
      "description": "レコード作成時のUnixミリ秒タイムスタンプ",
      "prefill": 1789356895498
    },
    "item": {
      "type": "string",
      "title": "送信URL",
      "description": "この詳細行に対して送信された商品ページURL",
      "prefill": "https://item.rakuten.co.jp/alice00/19rdv6003/"
    },
    "job_type": {
      "type": "string",
      "title": "収集タイプ",
      "description": "商品詳細レコードに付く収集タイプの原文",
      "prefill": "BasicInfo"
    },
    "main_image_url": {
      "type": "string",
      "title": "メイン画像",
      "description": "商品メイン画像のURL。ソースに画像がない場合は空です"
    },
    "platform_code": {
      "type": "string",
      "title": "プラットフォームコード",
      "description": "商品のマーケットプレイスプラットフォームコード",
      "prefill": "rakuten"
    },
    "product_id": {
      "type": "string",
      "title": "商品ID",
      "description": "Rakutenの商品識別子",
      "prefill": "10005020"
    },
    "product_title": {
      "type": "string",
      "title": "商品タイトル",
      "description": "商品ページに表示される完全なタイトル",
      "prefill": "Anker Soundcore Liberty 5 Pro Max 完全ワイヤレスイヤホン Bluetooth 6.1 ノイズキャンセリング LDAC ハイレゾ Dolby Atmos AIボイスレコーダー"
    },
    "product_url": {
      "type": "string",
      "title": "商品URL",
      "description": "商品ページURL",
      "prefill": "https://item.rakuten.co.jp/alice00/19rdv6003/"
    },
    "shop_id": {
      "type": "string",
      "title": "ショップID",
      "description": "商品を販売するショップの識別子",
      "prefill": "406191"
    },
    "skus": {
      "type": "string",
      "title": "SKU詳細",
      "description": "SKU、価格、選択肢のテキストをソース原文のまま保持したもの",
      "prefill": "[{\"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": {
      "type": "string",
      "title": "ソース名",
      "description": "詳細レコードに付くソースデータセット名",
      "prefill": "rakuten_detail_202609"
    },
    "spu_id": {
      "type": "string",
      "title": "SPU ID",
      "description": "出品の標準製品ユニット識別子",
      "prefill": "19rdv6003"
    },
    "status_code": {
      "type": "string",
      "title": "掲載ステータス",
      "description": "収集時点でページに表示されていた販売ステータス",
      "prefill": "在售"
    },
    "task_item": {
      "type": "string",
      "title": "クエリ項目",
      "description": "この行に対応する送信済み商品ページURL。安定したレコード識別子としても使います",
      "prefill": "https://item.rakuten.co.jp/alice00/19rdv6003/"
    },
    "no_data": {
      "type": "boolean",
      "title": "無データフラグ",
      "description": "この商品ページから利用可能な詳細が取れなかったかどうか",
      "prefill": false
    },
    "updated_at": {
      "type": "integer",
      "title": "更新タイムスタンプ",
      "description": "レコード更新時のUnixミリ秒タイムスタンプ",
      "prefill": 1789356895498
    },
    "url_status": {
      "type": "string",
      "title": "URLステータス",
      "description": "収集時点の商品ページURLの有効ステータス",
      "prefill": "有效"
    }
  },
  "required": [],
  "additionalProperties": false
}

連携方法

この App は MCP、API、SDK、ファイルエクスポートのいずれでも連携でき、どのチャネルも同じ能力と料金を共有します。すべてのリクエストは Authorization: Bearer ヘッダーで認証し、認証情報には API Key(長期有効。Data Hub コンソールで作成)を使用します。MCP クライアントは OAuth によるキー不要のログインにも対応しています。CLI や Skill など、さらに多くの連携方法も準備中です。

MCP(Model Context Protocol)を使うと、Claude や Cursor などの AI クライアントからこの App を直接呼び出せます。クライアントと認証方式を選び、下の設定をコピーしてください。

クライアント設定

Bearer の後の値を長期有効な API Key に置き換えてください。あらゆるクライアント、CI、ヘッドレス環境で利用できます。

mcpServers config
{
  "mcpServers": {
    "super_ig__rakuten-product-detail": {
      "type": "http",
      "url": "https://mcp-v2.octoparse.com?pin=super_ig/rakuten-product-detail",
      "headers": { "Authorization": "Bearer <YOUR_API_KEY>" }
    }
  }
}

AI に設定を任せる

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

detail.access.mcp.composeHint

料金

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

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

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

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

$0.004/ 件

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

Credits を確認

今すぐ試す

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

サンプル
パラメータは送信前に input.schema で検証されます
まず必須パラメータを入力してください
$0.004 / 件から