概要
Rakuten Product Details は、すでに分かっている日本の商品ページを1件1行のスナップショットにします。タイトル、商品ID、ショップ、掲載ステータス、SKUテキスト、ページURLをそろえ、カタログ担当や競合調査チームは各ページを開かずに楽天の出品を比較できます。
価値は商品ページそのもののスナップショットです。タイトル、掲載ステータス、SKUテキストはソース言語のまま残り、SKU詳細内の価格文字列は元の数字を保ち、送信したURLは無データフラグと同じ行にあるため、どの対象が取れたかを確認できます。
データ説明
各レコードは、公開されている楽天商品ページを収集時点で撮った商品詳細スナップショットです。行は送信した商品URLで重複排除されます。掲載ステータスとURLステータスは収集時点のページ値であり、ライブの決済状態ではありません。SKU詳細は価格文字列を含むソース原文のまま残り、通貨はソースに示されていません。収集時刻はソース提供の表記で、タイムゾーンはありません。作成タイムスタンプと更新タイムスタンプはUnixミリ秒です。
対象は、完全な楽天商品URLから到達できる公開商品ページだけです。利用できない、または無効なページでも無データフラグ付きの行として残ることがあります。検索結果、レビュー、販売履歴、ライブ在庫は含まれません。
結果の形
各レコードは、収集時点の楽天商品スナップショット1件です。
| 商品ID | ショップID | 掲載ステータス | 商品URL | SPU ID |
|---|---|---|---|---|
| 10005020 | 406191 | 在售 | https://item.rakuten.co.jp/alice00/19rdv6003/ | 19rdv6003 |
| 10000405 | 346082 | 在售 | 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行が無データとマークされた場合は、商品ページURLが完全で、いまも公開されているかを確認してください
- 2レート制限、リクエストタイムアウト、一時的なサービスエラーのときは、同じURL一覧で後から再試行してください
- 3認証失敗、タスクコンテキスト不一致、タスク期限切れのときはそのまま再試行せず、実行資格情報を確認するか新しく送信してください
- 4一部成功の場合、完了した商品行は返されます。失敗件数と無データ件数はタスクステータスから確認できます
入力
この App の呼び出しに必要なパラメータで、manifest.json の input.schema から生成されています。
| フィールド | 業務名称 | 型 | 必須 | デフォルト | 列挙値/制約 | 例 | 説明 |
|---|---|---|---|---|---|---|---|
| items | 商品ページURL | array<object> | はい | — | 最大 200 件 | [{"item":"https://item.rakuten.co.jp/alice00/19rdv6003/"}] | 詳細を収集するRakuten商品ページです。各項目は商品ページの完全なURL1件です。1〜200件まで送信できます。 |
出力
1 件のレコードのフィールド構造で、manifest.json の output.schema から生成されています。
| フィールド | 業務名称 | 型 | 例 | 説明 |
|---|---|---|---|---|
| biz_id | ビジネスID | string | https://item.rakuten.co.jp/alice00/19rdv6003/ | Rakuten商品詳細レコードの業務識別子。通常は商品ページURLです |
| comment_count | レビュー数 | string | 0 | 商品ページに表示されるレビュー数のテキスト |
| crawl_time | 収集時刻 | string | 2026-09-14T11:34:55 | 商品スナップショットの収集時刻テキスト。ソース値にタイムゾーンはありません |
| created_at | 作成タイムスタンプ | integer | 1789356895498 | レコード作成時のUnixミリ秒タイムスタンプ |
| item | 送信URL | string | https://item.rakuten.co.jp/alice00/19rdv6003/ | この詳細行に対して送信された商品ページURL |
| job_type | 収集タイプ | string | BasicInfo | 商品詳細レコードに付く収集タイプの原文 |
| main_image_url | メイン画像 | string | — | 商品メイン画像のURL。ソースに画像がない場合は空です |
| platform_code | プラットフォームコード | string | rakuten | 商品のマーケットプレイスプラットフォームコード |
| product_id | 商品ID | string | 10005020 | Rakutenの商品識別子 |
| product_title | 商品タイトル | string | Anker Soundcore Liberty 5 Pro Max 完全ワイヤレスイヤホン Bluetooth 6.1 ノイズキャンセリング LDAC ハイレゾ Dolby Atmos AIボイスレコーダー | 商品ページに表示される完全なタイトル |
| product_url | 商品URL | string | https://item.rakuten.co.jp/alice00/19rdv6003/ | 商品ページURL |
| shop_id | ショップID | string | 406191 | 商品を販売するショップの識別子 |
| skus | SKU詳細 | 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 | ソース名 | string | rakuten_detail_202609 | 詳細レコードに付くソースデータセット名 |
| spu_id | SPU ID | string | 19rdv6003 | 出品の標準製品ユニット識別子 |
| status_code | 掲載ステータス | string | 在售 | 収集時点でページに表示されていた販売ステータス |
| task_item | クエリ項目 | string | https://item.rakuten.co.jp/alice00/19rdv6003/ | この行に対応する送信済み商品ページURL。安定したレコード識別子としても使います |
| no_data | 無データフラグ | boolean | false | この商品ページから利用可能な詳細が取れなかったかどうか |
| updated_at | 更新タイムスタンプ | integer | 1789356895498 | レコード更新時のUnixミリ秒タイムスタンプ |
| url_status | URLステータス | string | 有效 | 収集時点の商品ページURLの有効ステータス |
レコード Schema
出力はレコード単位で 1 件ずつ返されます。 detail.output.idFieldHint
{
"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": {
"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 回ごとに課金されます。
正常に返されたレコードの件数に応じて課金されます。失敗した実行には課金されません。
複数の課金イベントはそれぞれ独立して累計されます。詳細は各項目をご覧ください。失敗した実行には課金されません。
Credits を確認今すぐ試す
パラメータを入力して実行してください。結果は実際の呼び出しによるものです。