Búsqueda por palabra clave en tienda JD
Indique un ID de tienda JD, una palabra clave en tienda y una cantidad esperada para recopilar productos coincidentes con títulos, precios y contexto de tienda.
Traducido · es-ESVer texto original
Descripción general
La búsqueda por palabra clave dentro de una tienda JD muestra cómo un comerciante presenta productos para una intención de compra. Artículos oficiales, accesorios y SKU relacionados aparecen juntos en la página de búsqueda de esa tienda, así que la misma consulta puede verse muy distinta de la búsqueda en todo el sitio. Ver esas tarjetas en una tabla facilita juzgar qué títulos, rangos de precio y SKU muestra realmente la tienda, sin abrir los listados uno a uno.
Esta recopilación conserva los títulos de producto originales, los precios JD y originales mostrados, las imágenes y el contexto de tienda de los resultados públicos de búsqueda en tienda. Es útil cuando el surtido por palabra clave de un comerciante y los precios de la página de listado son la entrada para sourcing o revisión competitiva, en lugar de sustituir una comprobación de ficha de producto o una decisión de compra.
Notas sobre los datos
Los datos describen tarjetas de producto recopiladas de la búsqueda pública por palabra clave en tienda de JD para una tienda y una palabra clave. Los resultados se entregan en orden ascendente de hora de recopilación, distinto de la ordenación usada para seleccionar productos durante la recopilación. Los ID de SKU repetidos se consolidan en las páginas entregadas.
El título del producto, el precio JD, el precio original, el número de valoraciones y el recuento de ventas conservan su texto de origen. Los precios no se convierten a otra moneda y no se hacen suposiciones sobre impuestos, promociones o condiciones de compra. El ID de negocio y la palabra clave pueden llevar la misma frase de búsqueda; ninguno es un identificador único de producto. El elemento enviado conserva el contexto de tienda y palabra clave y puede repetirse en muchos productos de la misma tarea. La zona horaria de la hora de recopilación no está especificada. Las direcciones de imagen de producto pueden empezar por // en lugar de un prefijo http completo.
Los valores ausentes de marca, precio, recuento de ventas y estado del listado siguen ausentes y no se infieren. Una vista previa en blanco no afirma que el valor de origen sea una cadena vacía. El indicador sin datos distingue un elemento de tienda y palabra clave enviado que no produjo productos coincidentes de las filas de listado ordinarias. La recopilación no debe tratarse como un catálogo completo de tienda, una instantánea de stock o una oferta verificada para un pedido concreto.
Cómo se ven los resultados
Cada fila representa un listado de resultado de búsqueda en tienda de JD para la tienda y la palabra clave enviadas.
| ID de SKU | Título del producto | Nombre de la tienda | Palabra clave | Hora de recopilación |
|---|---|---|---|---|
| 10106482729387 | ZEEHO极核插画车型主题高透亚克力钥匙扣 ae8 | ZEEHO官方旗舰店 | 钥匙扣 | 2026-10-14T17:02:03 |
| 100007662145 | ZEEHO极核钥匙扣挂件 | ZEEHO官方旗舰店 | 钥匙扣 | 2026-10-14T17:02:03 |
También hay columnas de precio JD, precio original, URL de imagen e indicador sin datos.
Casos de uso
- Comparar el surtido en tienda: agrupe el título del producto por términos recurrentes de producto o accesorio y use el ID de SKU y el nombre de la tienda para separar listados distintos detrás de la misma palabra clave.
- Revisar los precios mostrados: compare el precio JD y el precio original de listados con un título de producto similar, conservando el texto original antes de extraer conclusiones sobre competitividad.
- Preparar una lista corta: combine palabra clave, título del producto, URL de imagen y nombre de la tienda para identificar candidatos, y conserve la hora de recopilación para distinguir instantáneas en revisiones posteriores.
Alcance y límites
Un ID de tienda JD y una palabra clave en tienda por tarea, con una cantidad esperada de productos de 1 a 12.000. La cantidad es un objetivo de recopilación, no un tope estricto, así que pueden devolverse menos o más listados. La protección de obtención es de 12 páginas / 12.000 registros; alcanzar esta capacidad no demuestra integridad. La cobertura se limita a los listados públicos de búsqueda en tienda de JD.
- Adecuada para
- Cuando necesite productos que coincidan con una palabra clave dentro de una tienda JD en lugar de resultados de búsqueda de todo el sitio.
- Cuando quiera una lista estructurada que conecte cada listado coincidente con su título, precios mostrados y contexto de tienda.
- No usar para
- Cuando necesite una página de producto completa, variantes, reseñas o el catálogo completo de la tienda sin filtro de palabra clave.
- Cuando necesite un tope estricto de resultados o una consulta inmediata de un solo registro.
Gestión de fallos
Comportamiento de fallos y reintentos declarado por el desarrollador. Recomendamos incluirlo en tu prompt del sistema al integrar.
- 1Si el envío expira o su resultado es desconocido, revise la ejecución existente antes de volver a enviar: los envíos repetidos pueden crear trabajos distintos.
- 2Si no hay registros coincidentes, compruebe el ID de tienda, pruebe una palabra clave en tienda más corta o más amplia y vuelva a enviar.
- 3Conserve los registros completados tras un éxito parcial; vuelva a enviar la misma entrada tras un fallo o una caducidad.
- 4Reintente más tarde tras un límite de ritmo, una indisponibilidad temporal o un tiempo de espera.
- 5Si falla la autenticación, verifique la API Key configurada en el entorno de ejecución.
Entrada
Parámetros necesarios para llamar a esta App, generados a partir del input.schema del manifest.json.
- ID de tienda JD
shop_idObligatoriostringIntroduzca el ID de la tienda JD cuyos resultados de búsqueda en tienda quiere recopilar. Un ID de tienda por tarea, de 1 a 512 caracteres.Ejemplo11635291 - Palabra clave en tienda
keywordObligatoriostringIntroduzca una palabra clave para buscar dentro de la tienda, de 1 a 512 caracteres.Ejemplo钥匙扣 - Cantidad esperada de productos
target_countObligatoriointegerIntroduzca un entero de 1 a 12.000. Es un objetivo de recopilación, no un tope estricto; la cantidad real sigue lo recopilado y puede ser menor o mayor.Rango1–12000Ejemplo10 - Orden de recopilación
sort_orderObligatoriostring(enum)Elija cómo se seleccionan los productos durante la recopilación: Predeterminado, Ventas, Número de valoraciones, Más reciente, Precio ascendente o Precio descendente. Las filas entregadas siguen el orden ascendente de hora de recopilación.Valores permitidosPredeterminado0Ventas2Número de valoraciones3Más reciente4Precio ascendente51Precio descendente52Ejemplo0
Salida
Estructura de campos de un único registro, generada a partir del output.schema del manifest.json.
- ID de SKU
skuIdstringIdentificador de producto JD usado para distinguir listados.Ejemplo10106482729387 - ID de negocio
bizIdstringPalabra clave de búsqueda retenida en el listado; no es un identificador único de producto.Ejemplo钥匙扣 - Título del producto
productTitlestringTítulo del producto tal como se recopiló, sin traducción.EjemploZEEHO极核插画车型主题高透亚克力钥匙扣 ae8 - Precio JD
jdPricestringPrecio de listado JD como texto recopilado; los valores ausentes no se rellenan. No hay un campo de moneda aparte.
Datos de ejemplo
Generado a partir de output.schema. Los campos sin valor de ejemplo usan marcadores de estructura.
{
"skuId": "10106482729387",
"bizId": "钥匙扣",
"productTitle": "ZEEHO极核插画车型主题高透亚克力钥匙扣 ae8",
"jdPrice": "<jdPrice>",
"originalPrice": "<originalPrice>",
"saleCount": "<saleCount>",
"rateCount": "<rateCount>",
"brandName": "<brandName>",
"imageUrl": "//img12.360buyimg.com/n7/jfs/t1/224484/24/20441/30093/666a9032Fee15908b/1ef4fa11ad6ec0fc.jpg",
"shopId": "11635291",
"shopName": "ZEEHO官方旗舰店",
"keyword": "钥匙扣",
"status": "<status>",
"crawlTime": "2026-10-14T17:02:03",
"taskItem": "{\"keywords\":\"钥匙扣\",\"shop_id\":\"11635291\"}",
"taskNoData": 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. Esta App se ejecuta de forma asíncrona y se puede cancelar a mitad de camino: Tras la cancelación, la ejecución se detiene. Los registros ya entregados se conservan y se facturan.
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": {
"octoparse_datahub": {
"type": "http",
"url": "https://mcp-v2.octoparse.com?pin=super_ig/jd-shop-keyword-search",
"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. Se factura en unidades de 60 registros; cualquier unidad parcial se redondea a 60 registros.
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.