Búsqueda por palabra clave en 1688
Busque en 1688 por palabra clave y recopile anuncios de productos con precios, ventas y enlaces de origen.
Traducido · es-ESVer texto original
Descripción general
Las búsquedas por palabra clave en 1688 pueden revelar estilos, materiales y variantes de anuncios diferentes para una misma necesidad de compra. Reunir esos anuncios facilita revisar el surtido sin perder los títulos originales ni los enlaces necesarios para examinarlos con más detalle.
Esta recopilación combina los detalles de los anuncios con el contexto de búsqueda que los produjo. Ofrece un punto de partida para investigar el abastecimiento y comparar productos, en lugar de sustituir la revisión de sus páginas o una conversación con el proveedor sobre una posible compra.
Notas sobre los datos
Los datos describen anuncios recopilados de búsquedas por palabra clave en 1688. Los resultados se entregan por Fecha de recopilación ascendente, independientemente del orden empleado para seleccionar los productos durante la recopilación. Los identificadores de producto repetidos se consolidan entre las páginas entregadas.
Título del producto, Estado del anuncio, Precio y Cantidad vendida conservan los valores de origen como texto. Precio y Precio promocional no se convierten a otra moneda, y no se hacen suposiciones sobre impuestos, gastos de envío o condiciones de compra. No se especifican el periodo de ventas ni la zona horaria de Fecha de recopilación.
Los datos ausentes de región, vendedor y tienda no se deducen del título del producto. Una vista previa vacía no afirma que el valor de origen sea una cadena vacía. No debe tratarse esta colección como un directorio de proveedores verificados ni como un presupuesto para un pedido concreto.
Ejemplo de resultados
Cada fila representa un anuncio de producto. Los ejemplos conservan los títulos originales; los valores de Precio y Cantidad vendida entre comillas son texto, no números convertidos.
| ID del producto | Título del producto | Precio | Cantidad vendida | Palabra clave |
|---|---|---|---|---|
| 1065208644543 | Alcantara欧缔兰磁吸手机壳适用苹果iPhone17Pro Air 18ProMax 16 | "85" | "0" | iphone 18 pro max |
| 816387948239 | 适用苹果18promax手机壳插卡包翻盖iPhone17防摔16商务15真皮套14 | "158" | "0" | iphone 18 pro max |
También se incluyen columnas como URL del producto, URL de la imagen, Precio promocional y Fecha de recopilación.
Casos de uso
- Comparar el surtido: agrupe Título del producto por términos recurrentes de material o diseño, y utilice ID del producto y URL del producto para examinar los anuncios de cada grupo.
- Revisar los precios mostrados: compare Precio con Precio promocional en anuncios con Título del producto similar, conserve el texto original y compruebe las condiciones de compra antes de sacar conclusiones.
- Preparar una lista de abastecimiento: combine Palabra clave, Título del producto y URL de la imagen para identificar candidatos relevantes, y conserve Fecha de recopilación para distinguir las observaciones en revisiones posteriores.
Alcance y límites
Una palabra clave por ejecución; el objetivo es de 1 a 2000 productos, no un límite estricto de resultados. La recopilación por páginas completas puede devolver menos o más productos. La protección de recuperación es de 110 páginas / 2200 registros; alcanzar ese límite no demuestra que la recopilación esté completa.
- Adecuada para
- Para buscar anuncios de 1688 con fines de abastecimiento y comparación mediante palabras clave.
- No usar para
- No lo utilice para presupuestos garantizados en tiempo real, perfiles completos de proveedores ni un número de resultados estrictamente limitado.
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 agota el tiempo de espera o su resultado es incierto, revise la ejecución existente antes de volver a enviarlo: los envíos repetidos pueden crear trabajos distintos.
- 2Si se rechazan los datos o las credenciales, corrija la entrada o la configuración de acceso antes de reintentarlo.
- 3Un resultado vacío no significa por sí solo que la fuente haya indicado expresamente que no hay datos. El éxito parcial y el límite de protección requieren comprobar si los resultados están completos.
Entrada
Parámetros necesarios para llamar a esta App, generados a partir del input.schema del manifest.json.
- Palabra clave
keywordObligatoriostringIntroduzca una palabra clave de búsqueda de productos de 1688, de 1 a 512 caracteres.Ejemploiphone 18 pro max - Cantidad de productos deseada
target_countObligatoriostringIntroduzca un entero entre 1 y 2000 utilizando solo dígitos. Es un objetivo de recopilación, no un máximo estricto; las páginas completas pueden producir menos o más resultados.Ejemplo25 - Orden de recopilación
sortOpcionalstring(enum)Elija el orden de los productos durante la recopilación; por defecto se usa la relevancia. Los resultados entregados mantienen el orden ascendente de fecha de recopilación.Valores permitidosRelevanciabidPrecio: de mayor a menorbid2Precio: de menor a mayor_bid2Ventas: de mayor a menorsalePredeterminadobid - Página inicial de recopilación
startPageOpcionalstringIndica el número de página desde el que comienza la recopilación. Introduce un número entero positivo; si lo omites, la recopilación comienza de forma predeterminada en la página 1. Este valor no cambia la cantidad de productos esperada.Predeterminado1Ejemplo2
Salida
Estructura de campos de un único registro, generada a partir del output.schema del manifest.json.
- ID del producto
productIdstringIdentificador del producto en 1688.Ejemplo1065208644543 - Título del producto
productTitlestringTítulo del producto tal como se recopiló, sin traducción.EjemploAlcantara欧缔兰磁吸手机壳适用苹果iPhone17Pro Air 18ProMax 16 - URL del producto
productUrlstringEnlace al anuncio del producto en 1688.Ejemplohttps://detail.1688.com/offer/1065208644543.html - URL de la imagen
imageUrlstringEnlace de la imagen del producto tal como se recopiló.Ejemplohttps://cbu01.alicdn.com/img/ibank/O1CN01zUS1BK23KbTlWHRvp_!!2222667757237-0-cib.jpg
Datos de ejemplo
Generado a partir de output.schema. Los campos sin valor de ejemplo usan marcadores de estructura.
{
"productId": "1065208644543",
"productTitle": "Alcantara欧缔兰磁吸手机壳适用苹果iPhone17Pro Air 18ProMax 16",
"productUrl": "https://detail.1688.com/offer/1065208644543.html",
"imageUrl": "https://cbu01.alicdn.com/img/ibank/O1CN01zUS1BK23KbTlWHRvp_!!2222667757237-0-cib.jpg",
"price": "85",
"promotionPrice": "85",
"saleCount": "0",
"keyword": "iphone 18 pro max",
"sourceItem": "iphone 18 pro max",
"status": "有效",
"tagPercent": "25%",
"area": "<area>",
"pageNum": "<pageNum>",
"sellerName": "<sellerName>",
"shopId": "<shopId>",
"shopName": "<shopName>",
"crawlTime": "2026-10-10T18:07:09",
"createdAt": "1791626829270",
"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/alibaba1688-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 20 registros; cualquier unidad parcial se redondea a 20 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.