Detalles de producto Rakuten
Entregue una lista de URL de páginas de producto Rakuten y obtenga título, ID de producto, tienda, estado del anuncio y detalles SKU
Traducido · es-ESVer texto original
Descripción general
Rakuten Product Details convierte páginas de producto japonesas ya conocidas en una fila de instantánea por ficha: título, ID de producto, tienda, estado del anuncio, texto SKU y URL de la página. Los equipos de catálogo e inteligencia competitiva pueden comparar listados de Rakuten sin abrir cada página.
El valor es la instantánea de la propia página de producto. El título, el estado del anuncio y el texto SKU se quedan en el idioma de origen, las cadenas de precio de los detalles SKU conservan los números originales, y la URL enviada aparece en la misma fila que el indicador sin datos para ver qué destinos se resolvieron.
Notas sobre los datos
Cada registro es una instantánea de ficha de producto tomada de la página pública de Rakuten en el momento de la recolección. Las filas se deduplican por la URL de producto enviada. El estado del anuncio y el estado de la URL son los valores de la página en el momento de la recolección, no un estado de pago en vivo. Los detalles SKU se quedan como texto original de origen, incluidas las cadenas de precio; el origen no indica moneda. La hora de recolección se guarda tal como la entrega el origen, sin zona horaria. La marca de tiempo de creación y la de actualización son milisegundos Unix.
Solo se cubren las páginas de producto públicas alcanzables con una URL completa de producto Rakuten. Las páginas no disponibles o inválidas pueden aparecer igual como filas con el indicador Sin datos. No se incluyen resultados de búsqueda, reseñas, historial de ventas ni inventario en vivo.
Cómo se ven los resultados
Cada registro es una instantánea de un producto Rakuten en el momento de la recolección:
| ID de producto | ID de tienda | Estado del anuncio | URL del producto | ID de SPU |
|---|---|---|---|---|
| 10005020 | 406191 | 在售 | https://item.rakuten.co.jp/alice00/19rdv6003/ | 19rdv6003 |
| 10000405 | 346082 | 在售 | https://item.rakuten.co.jp/store-ecovacs-japan/dkx55-12ee/ | dkx55-12ee |
El resultado también incluye ID de negocio, URL enviada, título del producto, imagen principal, detalles SKU, hora de recolección, marca de tiempo de actualización, estado de la URL e indicador Sin datos.
Casos de uso
- Para armar un catálogo, archive ID de producto, título del producto e ID de tienda, y use la hora de recolección para juzgar la frescura de la instantánea.
- Para una revisión competitiva, agrupe por ID de tienda y compare título del producto, estado del anuncio y estado de la URL.
- Para extraer especificaciones y precios, lea los detalles SKU y compruebe la URL enviada con el indicador Sin datos para ver qué páginas se resolvieron.
Alcance y límites
Envíe como máximo 200 URL de páginas de producto Rakuten por ejecución. Cada URL devuelve una fila de detalle o un indicador sin datos. Los resultados vuelven en un orden estable de hora de recolección. La aplicación no filtra, agrega ni ordena a medida los campos de negocio.
- Adecuada para
- Cuando necesite títulos, ID de producto, tiendas, estado del anuncio y detalles SKU de un lote de páginas de producto Rakuten ya conocidas
- Cuando quiera conservar URL de producto, imágenes principales y texto SKU para un catálogo o análisis competitivo posterior
- No usar para
- Cuando necesite descubrir productos por palabra clave — esta aplicación solo devuelve detalles de URL de páginas de producto ya conocidas
- Cuando necesite reseñas, historial de ventas o precios históricos — esta aplicación solo devuelve una instantánea de ficha de producto
- Cuando necesite precios de pago en vivo o inventario en vivo — el estado del anuncio y los precios SKU son los valores de la página en el momento de la recolección
Gestión de fallos
Comportamiento de fallos y reintentos declarado por el autor. Recomendamos incluirlo en tu prompt del sistema al integrar.
- 1Si una fila está marcada como sin datos, compruebe que la URL de la página de producto esté completa y siga siendo de acceso público
- 2Si hay límite de ritmo, tiempo de espera de solicitud o error temporal del servicio, reintente más tarde con la misma lista de URL
- 3Si falla la autenticación, el contexto de la tarea no coincide o la tarea ha caducado, no reintente tal cual; revise las credenciales de ejecución o envíe una ejecución nueva
- 4Si la tarea tiene éxito parcial, las filas de producto completadas se siguen devolviendo; los recuentos de error y sin datos se ven en el estado de la tarea
Entrada
Parámetros necesarios para llamar a esta App, generados a partir del input.schema del manifest.json.
| Campo | Nombre de negocio | Tipo | Obligatorio | Predeterminado | Enum / Restricciones | Ejemplo | Descripción |
|---|---|---|---|---|---|---|---|
| items | URL de páginas de producto | array<object> | Sí | — | hasta 200 elementos | [{"item":"https://item.rakuten.co.jp/alice00/19rdv6003/"}] | Páginas de producto Rakuten de las que recoger detalles. Cada entrada es una URL completa de página de producto. Puede enviar de 1 a 200 elementos. |
Salida
Estructura de campos de un único registro, generada a partir del output.schema del manifest.json.
| Campo | Nombre de negocio | Tipo | Ejemplo | Descripción |
|---|---|---|---|---|
| biz_id | ID de negocio | string | https://item.rakuten.co.jp/alice00/19rdv6003/ | Identificador de negocio del registro de detalle de producto Rakuten, normalmente la URL de la página de producto |
| comment_count | Recuento de reseñas | string | 0 | Texto del recuento de reseñas mostrado en la página de producto |
| crawl_time | Hora de recolección | string | 2026-09-14T11:34:55 | Texto de hora de recolección de la instantánea de producto; el valor de origen no tiene zona horaria |
| created_at | Marca de tiempo de creación | integer | 1789356895498 | Marca de tiempo Unix en milisegundos de creación del registro |
| item | URL enviada | string | https://item.rakuten.co.jp/alice00/19rdv6003/ | URL de página de producto enviada para esta fila de detalle |
| job_type | Tipo de recolección | string | BasicInfo | Texto del tipo de recolección que lleva el registro de detalle de producto |
| main_image_url | Imagen principal | string | — | URL de la imagen principal del producto; vacía cuando el origen no tiene imagen |
| platform_code | Código de plataforma | string | rakuten | Código de la plataforma de mercado del producto |
| product_id | ID de producto | string | 10005020 | Identificador de producto Rakuten |
| product_title | Título del producto | string | Anker Soundcore Liberty 5 Pro Max 完全ワイヤレスイヤホン Bluetooth 6.1 ノイズキャンセリング LDAC ハイレゾ Dolby Atmos AIボイスレコーダー | Título completo mostrado en la página de producto |
| product_url | URL del producto | string | https://item.rakuten.co.jp/alice00/19rdv6003/ | URL de la página de producto |
| shop_id | ID de tienda | string | 406191 | Identificador de la tienda que vende el producto |
| skus | Detalles 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": "シャンパンゴールド"}] | Texto de SKU, precio y opciones conservado en la forma original de origen |
| source_name | Nombre de origen | string | rakuten_detail_202609 | Nombre del conjunto de datos de origen que lleva el registro de detalle |
| spu_id | ID de SPU | string | 19rdv6003 | Identificador de unidad de producto estándar del anuncio |
| status_code | Estado del anuncio | string | 在售 | Estado de venta mostrado en la página en el momento de la recolección |
| task_item | Elemento de consulta | string | https://item.rakuten.co.jp/alice00/19rdv6003/ | URL de página de producto enviada de esta fila, usada también como identificador estable del registro |
| no_data | Indicador sin datos | boolean | false | Si esta página de producto no produjo detalles utilizables |
| updated_at | Marca de tiempo de actualización | integer | 1789356895498 | Marca de tiempo Unix en milisegundos de actualización del registro |
| url_status | Estado de la URL | string | 有效 | Estado de validez de la URL de la página de producto en el momento de la recolección |
Schema del registro
La salida se devuelve registro a registro. detail.output.idFieldHint
{
"type": "object",
"properties": {
"biz_id": {
"type": "string",
"title": "ID de negocio",
"description": "Identificador de negocio del registro de detalle de producto Rakuten, normalmente la URL de la página de producto",
"prefill": "https://item.rakuten.co.jp/alice00/19rdv6003/"
},
"comment_count": {
"type": "string",
"title": "Recuento de reseñas",
"description": "Texto del recuento de reseñas mostrado en la página de producto",
"prefill": "0"
},
"crawl_time": {
"type": "string",
"title": "Hora de recolección",
"description": "Texto de hora de recolección de la instantánea de producto; el valor de origen no tiene zona horaria",
"prefill": "2026-09-14T11:34:55"
},
"created_at": {
"type": "integer",
"title": "Marca de tiempo de creación",
"description": "Marca de tiempo Unix en milisegundos de creación del registro",
"prefill": 1789356895498
},
"item": {
"type": "string",
"title": "URL enviada",
"description": "URL de página de producto enviada para esta fila de detalle",
"prefill": "https://item.rakuten.co.jp/alice00/19rdv6003/"
},
"job_type": {
"type": "string",
"title": "Tipo de recolección",
"description": "Texto del tipo de recolección que lleva el registro de detalle de producto",
"prefill": "BasicInfo"
},
"main_image_url": {
"type": "string",
"title": "Imagen principal",
"description": "URL de la imagen principal del producto; vacía cuando el origen no tiene imagen"
},
"platform_code": {
"type": "string",
"title": "Código de plataforma",
"description": "Código de la plataforma de mercado del producto",
"prefill": "rakuten"
},
"product_id": {
"type": "string",
"title": "ID de producto",
"description": "Identificador de producto Rakuten",
"prefill": "10005020"
},
"product_title": {
"type": "string",
"title": "Título del producto",
"description": "Título completo mostrado en la página de producto",
"prefill": "Anker Soundcore Liberty 5 Pro Max 完全ワイヤレスイヤホン Bluetooth 6.1 ノイズキャンセリング LDAC ハイレゾ Dolby Atmos AIボイスレコーダー"
},
"product_url": {
"type": "string",
"title": "URL del producto",
"description": "URL de la página de producto",
"prefill": "https://item.rakuten.co.jp/alice00/19rdv6003/"
},
"shop_id": {
"type": "string",
"title": "ID de tienda",
"description": "Identificador de la tienda que vende el producto",
"prefill": "406191"
},
"skus": {
"type": "string",
"title": "Detalles SKU",
"description": "Texto de SKU, precio y opciones conservado en la forma original de origen",
"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": "Nombre de origen",
"description": "Nombre del conjunto de datos de origen que lleva el registro de detalle",
"prefill": "rakuten_detail_202609"
},
"spu_id": {
"type": "string",
"title": "ID de SPU",
"description": "Identificador de unidad de producto estándar del anuncio",
"prefill": "19rdv6003"
},
"status_code": {
"type": "string",
"title": "Estado del anuncio",
"description": "Estado de venta mostrado en la página en el momento de la recolección",
"prefill": "在售"
},
"task_item": {
"type": "string",
"title": "Elemento de consulta",
"description": "URL de página de producto enviada de esta fila, usada también como identificador estable del registro",
"prefill": "https://item.rakuten.co.jp/alice00/19rdv6003/"
},
"no_data": {
"type": "boolean",
"title": "Indicador sin datos",
"description": "Si esta página de producto no produjo detalles utilizables",
"prefill": false
},
"updated_at": {
"type": "integer",
"title": "Marca de tiempo de actualización",
"description": "Marca de tiempo Unix en milisegundos de actualización del registro",
"prefill": 1789356895498
},
"url_status": {
"type": "string",
"title": "Estado de la URL",
"description": "Estado de validez de la URL de la página de producto en el momento de la recolección",
"prefill": "有效"
}
},
"required": [],
"additionalProperties": false
}Integración
Esta App se puede integrar mediante MCP, API, SDK o exportación de archivos — todos los canales comparten las mismas capacidades y precios. Cada solicitud se autentica con la cabecera Authorization: Bearer usando una API Key (de larga duración, creada en la consola de Data Hub); los clientes MCP también pueden iniciar sesión con OAuth sin clave. Más opciones como CLI y Skill están en camino.
Con MCP (Model Context Protocol) puedes llamar a esta App directamente desde clientes de IA como Claude y Cursor. Elige tu cliente y el modo de autenticación, y copia la configuración de abajo.
Configuración del cliente
Sustituye el valor tras Bearer por tu API Key de larga duración. Funciona en cualquier cliente, CI o entorno sin interfaz.
{
"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>" }
}
}
}Deja que la IA lo configure por ti
¿No quieres editar configuraciones a mano? Copia el prompt de instalación y pégalo en cualquier cliente de IA: completará la configuración a su manera. (El prompt le pide a la IA que te solicite tu API Key, de modo que las credenciales nunca queden en el historial de chat ni en configuraciones compartidas.)
detail.access.mcp.composeHint
Precios
Se cobra una vez por cada ejecución enviada, independientemente del número de registros devueltos.
Se cobra según el número de registros devueltos correctamente. Las ejecuciones fallidas no se cobran.
Los distintos eventos de facturación se acumulan de forma independiente. Consulta cada elemento para más detalles. Las ejecuciones fallidas no se cobran.
Ver créditosPruébalo ahora
Rellena los parámetros y ejecuta — los resultados provienen de una llamada real.