Búsqueda por palabra clave de Tmall
Indique una palabra clave de Tmall y una cantidad esperada para obtener fichas de producto con precios, ventas y tienda.
Traducido · es-ESVer texto original
Descripción general
Las búsquedas por palabra clave en Tmall mezclan tiendas insignia, vendedores autorizados y accesorios detrás de la misma intención de compra. Reunir esas tarjetas de resultados facilita ver qué productos, tiendas y rangos de precio aparecen realmente, sin abrir cada ficha.
Esta recogida conserva los títulos originales, los precios mostrados y el texto de ventas de los resultados de Tmall. Sirve cuando el surtido, la posición y los precios de listado alimentan una revisión de aprovisionamiento o de competencia, y no sustituye una comprobación de ficha de producto ni una decisión de compra.
Notas sobre los datos
Los datos describen tarjetas de producto recogidas de resultados públicos de búsqueda por palabra clave de Tmall. Los resultados se entregan en orden ascendente de hora de recogida, distinto de la ordenación usada para seleccionar productos durante la recogida. Los ID de SPU repetidos se consolidan en las páginas entregadas.
Título del producto, Precio y Recuento de ventas conservan su texto de origen. El precio no se convierte a otra moneda y no se asumen impuestos, promociones ni condiciones de compra. ID comercial, Palabra clave y Palabra clave enviada pueden llevar la misma frase de búsqueda; ninguno es un identificador único de producto. Marca de tiempo de recogida y Marca de tiempo de creación se conservan como texto devuelto, incluidas cadenas de marca de tiempo con formato de máquina. La zona horaria de Hora de recogida no está especificada.
Los valores faltantes de marca, plataforma, recuento de reseñas y estado del listado siguen faltando. Una vista previa en blanco no afirma que el valor de origen sea una cadena vacía. No trate esta recogida como un catálogo completo de Tmall, una instantánea de existencias o una oferta verificada para un pedido concreto.
Cómo se ven los resultados
Cada fila representa un listado de resultado de búsqueda de Tmall. Los valores citados de Precio y Recuento de ventas son texto, no números convertidos.
| ID de SPU | Título del producto | Precio | Recuento de ventas | Nombre de la tienda |
|---|---|---|---|---|
| 627049150327 | 闪魔适用iPhone17钢化膜苹果18promax手机膜13/15防摔16pro新款duo折叠14全屏X/XR保护11屏幕12pm官ip贴膜Air | "48.39" | "10万+" | 闪魔旗舰店 |
| 654826062393 | 倍思新无界膜适用苹果iPhone18钢化膜AR抗反射17ProMax保护膜16Pro无尘仓15手机贴膜14全屏13覆盖12防指纹11 | "91.96" | "10万+" | baseus倍思旗舰店 |
Hay columnas adicionales de URL de la imagen, Página de origen, Posición en la lista y Hora de recogida.
Casos de uso
- Comparar el surtido de búsqueda: agrupe Título del producto por términos recurrentes de producto o accesorio y use ID de SPU y Nombre de la tienda para separar fichas distintas detrás de la misma palabra clave.
- Revisar precios mostrados: compare Precio y Recuento de ventas en títulos similares, conservando el texto original antes de concluir sobre competitividad.
- Preparar una lista corta: combine Palabra clave, Título del producto, URL de la imagen y Nombre de la tienda para identificar candidatos, y conserve Hora de recogida para distinguir después las instantáneas de recogida.
Alcance y límites
Una palabra clave de búsqueda de Tmall por tarea, con una cantidad esperada de 1 a 2000; los resultados se recogen en páginas de origen de unos 10 productos y pueden ser menos o más de lo solicitado; la protección de recuperación es de 110 páginas / 2.200 registros; alcanzar esa capacidad no demuestra exhaustividad; solo cubre listados públicos de búsqueda de Tmall.
- Adecuada para
- Cuando necesite productos de resultados de búsqueda de Tmall para una marca, producto o categoría.
- Cuando necesite una lista estructurada que relacione cada ficha encontrada con su tienda, precio, posición y señales públicas de ventas.
- No usar para
- Cuando necesite una ficha de producto completa, variantes, reseñas o historial de precios: esta App solo devuelve información de las tarjetas de resultados.
- 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, pruebe una consulta 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.
- Palabra clave de búsqueda
keywordObligatoriostringIntroduzca una palabra clave de búsqueda de productos de Tmall, de 1 a 512 caracteres.Ejemploiphone 18 pro max - Cantidad esperada de productos
target_countObligatoriostringIntroduzca un entero de 1 a 2000 solo con dígitos. Es un objetivo de recogida, no un tope estricto; las páginas de origen de unos 10 productos pueden devolver menos o más fichas, y las fichas devueltas se facturan en lotes de 10.Ejemplo25 - Orden de recogida
sortObligatoriostring(enum)Elija cómo se ordenan los productos durante la recogida. El valor predeterminado es la clasificación predeterminada de Tmall. Los resultados entregados siguen el orden ascendente del momento de recogida.Valores permitidosPredeterminado0Ventas2Precio: de menor a mayor51Precio: de mayor a menor52Predeterminado0Ejemplo0 - Página inicial de recogida
startPageOpcionalstringIntroduzca un número entero positivo para iniciar la recogida desde esa página. Si lo deja vacío, el servicio ascendente determina la página inicial; se recomienda introducirla explícitamente. Este parámetro no cambia la cantidad esperada de productos.
Salida
Estructura de campos de un único registro, generada a partir del output.schema del manifest.json.
- ID de SPU
spu_idstringIdentificador de producto de Tmall usado para distinguir fichas.Ejemplo627049150327 - ID comercial
biz_idstringPalabra clave de búsqueda retenida en la ficha; no es un identificador único de producto.Ejemploiphone 18 pro max - Título del producto
product_titlestringTítulo del producto tal como se recogió, sin traducción.Ejemplo闪魔适用iPhone17钢化膜苹果18promax手机膜13/15防摔16pro新款duo折叠14全屏X/XR保护11屏幕12pm官ip贴膜Air - Precio
pricestringTexto de precio tal como se recogió; sin conversión de moneda ni numérica.Ejemplo48.39
Datos de ejemplo
Generado a partir de output.schema. Los campos sin valor de ejemplo usan marcadores de estructura.
{
"spu_id": "627049150327",
"biz_id": "iphone 18 pro max",
"product_title": "闪魔适用iPhone17钢化膜苹果18promax手机膜13/15防摔16pro新款duo折叠14全屏X/XR保护11屏幕12pm官ip贴膜Air",
"price": "48.39",
"sale_count": "10万+",
"rate_count": "<rate_count>",
"brand_name": "<brand_name>",
"image_url": "https://g.search.alicdn.com/img/bao/uploaded/i4/i2/793375733/O1CN01VFo3XC93RRC2vH2e_!!4611686018427384821-0-item_pic.jpg",
"shop_id": "793375733",
"shop_name": "闪魔旗舰店",
"keyword": "iphone 18 pro max",
"list_index": "0",
"now_page": "1",
"platform": "<platform>",
"status": "<status>",
"crawl_time": "2026-10-13T16:47:55",
"task_item": "iphone 18 pro max",
"task_no_data": 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/tmall-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 10 registros; cualquier unidad parcial se redondea a 10 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.