Nuestras estadísticas de visitas propias están siempre activas. Google Analytics, que nos ayuda a entender cómo se usan nuestras páginas públicas (no tu espacio de trabajo con sesión iniciada), solo se activa con tu permiso. Consulta nuestra Política de privacidad.

API de 1688 en Claude Code: un agente que calcula el margen frente a Yandex Market

Agente de compras con la API de 1688 en Claude Code: 15 de 25 resultados por imagen coincidieron y un termo dejó un 36 % de margen. Datos: $0,0083.

Ilustración. A la izquierda, unas estanterías de almacén con muchos termos de acero inoxidable iguales y cajas de cartón, que representan el stock de fábrica en 1688. A la derecha, el mostrador de una tienda pequeña con uno de esos termos, que representa la ficha de producto en un marketplace ruso. En el centro, un portátil y una balanza unen con finas líneas verde azulado un termo de la estantería y el del mostrador, como un programa que pone lado a lado el precio de compra y el precio de venta.

El 8 de noviembre de 2026, entre las 00:15 y las 00:46 hora de Singapur, hicimos una revisión de compras completa con tres capacidades de datos de EveryInfra. Primero tomamos el producto más popular de 5 categorías en Yandex Market, en Moscú. Después enviamos la foto de cada producto a la búsqueda por imagen de 1688. Luego leímos la ficha de 1688 para obtener el precio por SKU, el pedido mínimo y el peso. Por último calculamos el margen con las tarifas públicas de Yandex Market y el tipo oficial del Banco de Rusia del 7 de noviembre de 2026.

El resultado tiene dos caras. Las 5 búsquedas por imagen devolvieron 25 candidatos y revisamos cada foto a ojo: 15 eran el mismo producto, 6 eran parecidos y 4 no tenían nada que ver. Solo en 2 de las 5 búsquedas el primer resultado era el mismo producto. La mejor fila completa fue un termo de coche que se vende a 3.500 rublos (unos 37,96 €) en Yandex Market. El mismo termo cuesta 8,17 yuanes (unos 1,09 €) en 1688.

Después de una comisión de categoría del 50 % y de las tarifas de envío, al vendedor le quedan unos 1.266 rublos (unos 13,73 €). Es un margen del 36,2 %. Pero 5 vendedores ofrecen ese mismo termo en Yandex Market, y el precio más bajo es de 1.227 rublos. A ese precio, el margen cae al 19,8 %. El coste de datos de toda la revisión fue de $0,008334 por producto.

Este artículo es para quien compra mercancía en China para venderla en marketplaces rusos, o en cualquier otro mercado, y para quien le desarrolla herramientas. Al terminar sabrás montar en Claude Code un agente que recibe un producto que se vende y devuelve una fila: precio del mismo producto en 1688, pedido mínimo, flete y lo que queda tras las comisiones de Yandex Market.

Ilustración. A la izquierda, un recuadro grande con un organizador giratorio blanco y redondo con tres patas doradas en forma de bola. A la derecha, cinco recuadros pequeños en fila: los tres primeros muestran el mismo organizador con borde verde azulado; el cuarto, un pequeño ventilador blanco de pinza, y el quinto, una bandeja gris de rejilla, ambos con borde gris que indica un resultado erróneo. Una línea discontinua une la foto grande con los cinco candidatos.
Lo que de verdad devuelve una búsqueda por imagen: algunos candidatos son el mismo producto, otros solo se parecen y otros no tienen relación.

La pregunta que responde el agente: ¿merece la pena traer este producto?

Los vendedores de los mercados de habla rusa suelen seguir un método: primero miran el marketplace y después la fábrica. Buscan un producto que se venda bien en Rusia y anotan su precio, el número de valoraciones y las ventas. Luego buscan el mismo producto en 1688. Al final calculan la economía unitaria, que en ruso llaman «юнит-экономика».

La economía unitaria suma el precio de compra, el flete internacional, la aduana y los impuestos, la comisión de la plataforma, la entrega final y las devoluciones. En el mundo del código abierto ya hay herramientas para esto. Un proyecto de GitHub es una calculadora de beneficio para vendedores de Wildberries que da economía unitaria, margen y ROI (wb-calculator). Otro es un plugin de Wildberries para Codex y Claude que convierte la economía unitaria, el punto de equilibrio y la reposición en herramientas (wildberries-agent-integration).

Estas herramientas trabajan con los datos de la propia tienda del vendedor. Dan por hecho que ya tienes mercancía y una cuenta de vendedor. Nuestro agente trabaja un paso antes. Usa datos públicos para decidir si un producto merece un primer pedido. Es otro trabajo y necesita otros datos.

Por eso el agente recibe una sola palabra clave en ruso, por ejemplo «термокружка» (termo de viaje). Devuelve una fila con tres bloques. El primero es el título, el precio y las valoraciones en Yandex Market. El segundo es el enlace de 1688, el precio por SKU, el pedido mínimo, el peso unitario y el tamaño de la caja del mismo producto. El tercero es la comisión de la plataforma, las tarifas de envío, el flete y el margen.

Hay un paso intermedio que necesita un modelo: decidir si cada candidato de la búsqueda por imagen es el mismo producto. Es el paso con más errores y el que mejor encaja con un modelo multimodal. Los resultados reales de más abajo muestran por qué.

Elegimos 5 categorías que aparecen arriba en el orden por popularidad de Yandex Market en Moscú: un termo de coche, un organizador giratorio de cosméticos, un soporte magnético de móvil para el coche, un proyector de estrellas con forma de astronauta y una mochila urbana. El termo y el organizador son productos estándar con muchas fábricas. El soporte es ligero y barato. El proyector lleva electrónica y tiene muchas variantes. La mochila tiene muchos productos que se parecen por fuera y cambian mucho por dentro.

Diagrama de flujo titulado «Cinco pasos por artículo: 3 llamadas, 1 revisión de imágenes, 1 cálculo local». Cinco recuadros de izquierda a derecha. 1, yandex/market: una palabra en ruso da el precio y la foto. 2, alibaba1688/image_search: da 5 candidatos. 3, Claude lee 6 fotos en un mosaico y las marca como igual, parecido o erróneo. 4, alibaba1688/product_detail: da precio por SKU, pedido mínimo y peso. 5, margin.py: tarifas, tipo de cambio y flete dan la tabla de margen. Los pasos 1, 2 y 4 son verde azulado, que marca las llamadas de pago; los pasos 3 y 5 son grises. Una línea discontinua vuelve del paso 5 al 1 con la etiqueta «siguiente artículo».

API de 1688 y Yandex Market: qué hace cada capacidad

Los campos marcan hasta dónde puede calcular el agente, así que empezamos por ellos. Todos los precios, parámetros y campos de la tabla salen del catálogo gratuito de EveryInfra (catálogo de datos), leído a las 00:13 hora de Singapur del 8 de noviembre de 2026. También puedes leer solo la parte de 1688 o la parte de Yandex. Ese día, las cuatro capacidades tenían available: true.

CapacidadParámetro obligatorioPrecio por llamadaDevuelveCampos que usa este artículo
yandex/marketkeyword$0,00138920 por defecto, hasta 100title, price, currency, rating, rating_count, review_count, purchase_count, shop_name, category, image_url
alibaba1688/image_searchimage_url$0,005556hasta 5rank, title, price, min_order_quantity, order_count, id, image_url
alibaba1688/product_detailurl (enlace o offerId)$0,0013891 productoprice_min, price_max, price_tiers, min_order_quantity, skus (con weight_g, length_cm y más), specs, supplier_type
alibaba1688/searchkeyword$0,00277820 por defecto, hasta 100price_min, min_order_quantity, order_count

yandex/market tiene dos parámetros opcionales que importan aquí. city admite 16 ciudades, entre ellas Moscú, San Petersburgo y Kazán. sort solo admite popular y top_rated. El catálogo aclara además que yandex/market y yandex/search no consultan los mismos datos: search busca negocios en el mapa y market busca productos de la tienda. Es un aviso importante, porque un modelo que ve «Yandex» y «precio» puede elegir la acción equivocada con facilidad.

alibaba1688/image_search cuesta 4 veces más que las otras dos llamadas. Cada llamada busca una sola foto y devuelve hasta 5 candidatos. No devuelve los SKU completos, el stock ni los datos del proveedor, y el catálogo lo dice tal cual. Por eso la búsqueda por imagen funciona como un filtro: sirve para encontrar candidatos. Después se llama a alibaba1688/product_detail solo para el candidato elegido.

La ficha de product_detail trae otra nota fácil de pasar por alto. En modo síncrono, el peso, las medidas, el stock, la provincia y algunos campos más pueden llegar vacíos; para obtenerlos hay que usar el modo asíncrono. Nuestra prueba lo confirmó. También mostró que el modo asíncrono no rellena todos los campos.

Cada página de capacidad tiene la lista completa de parámetros y ejemplos. Empieza por la API de datos de 1688, la búsqueda por imagen de 1688 y la ficha de producto de 1688. Las demás son la búsqueda por palabra clave de 1688, la API de datos de Yandex y la búsqueda de productos de Yandex Market. Para conseguir tu primera clave, lee la guía de inicio rápido.

1688 API integration: conectar el servidor MCP remoto en Claude Code

La forma más sencilla de dar datos externos a Claude Code es un servidor MCP remoto. La documentación de Claude Code recomienda HTTP para los servidores MCP remotos. El comando es claude mcp add --transport http <nombre> <url>, y si el servidor pide una clave de API se añade con --header. En .mcp.json hay que poner type en http, porque una entrada con solo url se interpreta como un servidor local stdio y falla (documentación MCP de Claude Code). La especificación MCP llama a este transporte Streamable HTTP (transportes MCP, 2025-06-18).

Una aclaración de método: lo que decimos de Claude Code sale de su documentación oficial y del registro de cambios. No ejecutamos el agente completo dentro de Claude Code, así que esa parte va como «ejemplo de configuración». Cada cifra de datos sale de una respuesta real de la API y de un script que puedes volver a ejecutar.

bash
# Ejemplo de configuración: añadir el servidor MCP remoto de EveryInfra a este proyecto (.mcp.json)
export EVERYINFRA_API_KEY=...   # clave creada en la consola; guárdala solo en una variable de entorno
claude mcp add --transport http everyinfra https://api.everyinfra.com/mcp \
  --scope project --header "Authorization: Bearer ${EVERYINFRA_API_KEY}"

Una vez conectado, tools/list muestra 12 herramientas. Leímos la lista una vez a las 00:37 hora de Singapur, y esa lectura no tiene coste. El agente de compras solo necesita dos. everyinfra_call_api llama a cualquier capacidad de datos con platform, action y params, y tiene un campo mode que admite sync o async. everyinfra_get_job lee el resultado de una tarea asíncrona.

everyinfra_call_api lleva las anotaciones readOnlyHint: false y destructiveHint: true, porque cada llamada cuesta dinero. La especificación MCP dice que estas anotaciones son pistas para el cliente (especificación de herramientas MCP). Claude Code las usa para pedirte permiso. Para ejecuciones por lotes, permite solo estas dos herramientas en la configuración del proyecto (documentación de permisos, documentación de ajustes), no todas las herramientas MCP.

También puedes llamar a la API REST POST /api/v1/social con Bash, sin MCP; el cobro es el mismo, pero el formato de la petición va en la Skill o en el prompt (guía de configuración de MCP remoto; comparativa en subagentes de Claude Code con cuentas de marca de TikTok).

Paso 1: encontrar productos que se venden en Yandex Market

El paso 1 llama a yandex/market con una palabra clave en ruso, city: moscow, sort: popular y limit: 10. Lanzamos 5 palabras clave a las 00:15, 00:18 y 00:26 hora de Singapur. Cada llamada costó $0,001389. Abajo está la petición real del termo y los campos principales del primer resultado; quitamos campos internos como el saldo.

bash
curl -s https://api.everyinfra.com/api/v1/social \
  -H "Authorization: Bearer $EVERYINFRA_API_KEY" -H "Content-Type: application/json" \
  -d '{"platform":"yandex","action":"market",
       "params":{"keyword":"термокружка","limit":10,"city":"moscow","sort":"popular"}}'
# Respuesta (extracto, 2026-11-08 00:15:05 hora de Singapur)
# "count": 10, "charged_usd": 0.001389
# {"id":"5953869335","title":"Термокружка (термос) для кофе и чая автомобильная 510 мл кружка-термос",
#  "price":3500,"currency":"RUR","rating":4.6,"rating_count":349,"review_count":140,
#  "shop_name":"BASQA","category":"Термокружки дорожные","is_available":true,
#  "image_url":"https://avatars.mds.yandex.net/get-mpic/18061612/.../orig"}

Los 10 termos cuestan entre 440 y 4.900 rublos. El primero es un termo de coche de 510 ml a 3.500 rublos con 349 valoraciones. La tabla muestra el producto que elegimos en cada categoría. En el soporte y en la mochila saltamos resultados más altos porque eran productos de marca o packs, que no sirven para comparar el mismo artículo.

CategoríaPalabra clave (ruso)Producto elegidoPosiciónPrecio (RUB)ValoracionesCompras
Termo de coche, 510 mlтермокружкаBASQA13.500349null
Organizador giratorio de cosméticosорганайзер для косметики вращающийсяZALUU HOME13.990419null
Soporte magnético de móvilдержатель для телефона в машину магнитныйTONG (marca)71.2005.372null
Proyector de estrellas astronautaночник проектор звездное небоLo&Ger12.500106609
Mochila urbanaрюкзак для ноутбука мужскойMozione65.900105558

Hay un dato útil para diseñar el agente. El campo purchase_count solo tenía valor en 2 de los 5 productos, el proyector y la mochila; los otros 3 tenían null. En cambio, los 5 tenían rating_count. Así que, para ordenar productos por demanda, usa el número de valoraciones como señal principal y las compras solo cuando tengan valor. El campo image_url apunta a la foto a tamaño completo en el servidor de imágenes de Yandex, así que puedes pasarla directamente al siguiente paso sin descargarla ni volver a subirla.

Paso 2: buscar el mismo producto por imagen y contar cuántos aciertos hay entre los 5 primeros

El paso 2 envía la URL de la foto de Yandex Market a alibaba1688/image_search. La búsqueda del termo respondió a las 00:16 hora de Singapur: los 5 candidatos eran termos de coche de acero 304, de 7,88 a 11,66 yuanes. La del organizador respondió a las 00:19: los 5 eran el mismo organizador giratorio de brochas, de 3,76 a 6 yuanes. Estos dos resultados fueron muy limpios, pero los otros tres no.

En el soporte de móvil, la llamada síncrona devolvió HTTP 503 con el código de error timeout a las 00:21:25 hora de Singapur, tras 85 segundos de espera. La respuesta traía billing.charged: false y el texto «Not charged», y sugería repetir con "mode":"async". A las 00:23:04 enviamos la misma petición en modo asíncrono y recibimos un job_id al instante. A las 00:24 la consulta devolvió el resultado.

ProductoLlamada síncronaResultado síncronoEnvío asíncronoResultado asíncronoCobrado
Termo de coche00:165 candidatosno hizo falta—$0,005556
Organizador de cosméticos00:195 candidatosno hizo falta—$0,005556
Soporte magnético00:21:25503 por tiempo a los 85 s00:23:0400:24$0,005556 (síncrona: $0)
Proyector de estrellas00:27:35503 por tiempo a los 85 s00:30:1600:32$0,005556 (síncrona: $0)
Mochila urbana00:295 candidatosno hizo falta—$0,005556

Todas las horas de la tabla son hora de Singapur del 2026-11-08. En total, 2 de 7 búsquedas por imagen agotaron el tiempo en modo síncrono y ninguna se cobró. Cada uno de los dos reintentos asíncronos costó $0,005556. Para el agente, esto se traduce en una regla: usa el modo asíncrono por defecto en la búsqueda por imagen.

Captura de una respuesta real de la API de EveryInfra. La cabecera muestra GET /api/v1/jobs/ con el identificador de la tarea, alibaba1688/image_search, 2026-11-08 00:24 SGT y charged_usd 0.005556. Debajo, el JSON con status succeeded y count 5. Un recuadro verde azulado marca el primer resultado con la etiqueta «rank 1 = desk clip fan · mismatch»: un ventilador de pinza de 35 CNY, pedido mínimo 5 y 47 pedidos. Los puestos 2 a 5 son soportes magnéticos de coche de 6 a 17 CNY. Los títulos del JSON están en chino, tal como los devuelve 1688.
Búsqueda por imagen del soporte de móvil: el primer puesto es un ventilador de pinza y el mismo producto está en el tercero. Captura del 8 de noviembre de 2026, 00:24 hora de Singapur. Captura de una respuesta de la API de EveryInfra, 2026-11-08 00:24 SGT

El trabajo de verdad empieza cuando llegan los resultados. La tabla resume qué había en cada puesto de las dos búsquedas más difíciles.

PuestoSoporte magnético de móvilProyector de estrellas astronauta
1Ventilador de pinza con dibujos, 35 yuanes, mínimo 5 (erróneo)Taller de moldes de inyección para carcasas de robot (erróneo)
2Soporte magnético de otro diseño (parecido)Proyector astronauta (igual)
3El mismo soporte, 17 yuanes, mínimo 2 (igual)Proyector astronauta (igual)
4Soporte magnético con otra pinza y otro cabezal (parecido)Proyector astronauta (igual)
5Pieza suelta de cabezal magnético (erróneo)Astronauta abrazado a una estrella, como el de Yandex Market (igual, el elegido)

Los puestos 3 y 4 del proyector dicen «cohete» en el título, pero su foto principal lleva el rótulo «blanco, abraza una estrella» y la misma forma; por eso cuentan como iguales.

La mochila fue el caso más difícil: ninguno de los 5 candidatos era claramente el mismo producto. La foto del puesto 4 es un grupo de mochilas escolares celestes, amarillas y rosas con bolsillos laterales y colgantes; solo una es negra. La marcamos como errónea.

Queríamos un mismo criterio para todas las decisiones. Así que redujimos la foto de origen y las 5 de los candidatos a 300×300 píxeles y las unimos en una hoja de contactos de 1800×300. «Igual» significa mismo cuerpo, forma y piezas. «Parecido» significa el mismo tipo de producto con otro diseño o sin coincidencia clara. «Erróneo» significa otro tipo de producto.

ProductoPrimer puesto de la búsquedaIguales en el top 5ParecidosErróneosProducto de 1688 elegido
Termo de coche, 510 mlIgual500Puesto 4, unos 25.000 vendidos
Organizador giratorioIgual500Puesto 1, 3,76 yuanes
Soporte magnéticoErróneo (ventilador)122Puesto 3, 17 yuanes, mínimo 2
Proyector astronautaErróneo (taller de moldes)401Puesto 5, modelo con estrella, 16,21 yuanes
Mochila urbanaParecido041Puesto 3 solo como referencia, no es el mismo
TotalIgual 2 veces1564Mismo producto en 4 categorías
Gráfico de barras horizontales apiladas. Cada uno de los 5 productos tiene una barra de 5 candidatos dividida en igual (verde azulado), parecido (gris claro) y erróneo (gris oscuro). Termo: 5 iguales. Organizador: 5 iguales. Soporte: 1 igual, 2 parecidos, 2 erróneos. Proyector: 4 iguales, 1 erróneo. Mochila: 4 parecidos, 1 erróneo. Título: 15 de 25 candidatos eran el mismo producto, pero el primer puesto acertó solo 2 veces.

La tabla muestra dos cosas. Primero, la cobertura es buena: en 4 de las 5 categorías el top 5 incluye el mismo producto, y el 60 % de los 25 candidatos lo son. Segundo, el orden no es fiable: el primer puesto fue el mismo producto solo 2 veces (40 %).

Un agente que se quede con el primer puesto calcularía mal 3 de las 5 filas. Dos de ellas estarían muy mal: una usaría el precio de un ventilador de 35 yuanes para un soporte de móvil, y otra el de un servicio de moldes para un proyector. Por eso la revisión de fotos no es opcional: decide si los números de la tabla sirven o no.

Paso 3: dejar que Claude mire las fotos, y cuántos tokens cuesta

Claude puede leer imágenes. La documentación de visión de Anthropic cuenta las imágenes en bloques de 28×28 píxeles (documentación de visión). Los tokens de una imagen son el ancho dividido entre 28, redondeado hacia arriba, por el alto dividido entre 28, también redondeado hacia arriba. Nuestra hoja de 1800×300 da 65 × 11 = 715 tokens de visión.

Si mandas las 6 fotos por separado a 1000×1000, salen 6 × 36 × 36 = 7.776 tokens, unas 11 veces más que la hoja de contactos. Para comparar productos, una miniatura de 300×300 basta para ver la forma del termo, la tapa y la base. Una imagen grande añade coste y no aporta información nueva.

Con los precios base de entrada de la página de precios de Anthropic, leída a las 02:13 hora de Singapur del 8 de noviembre, una hoja de contactos cuesta unos $0,0000715 con Haiku 5.5 ($0,10 por millón de tokens si el prompt completo no pasa de 100.000 tokens; por encima, $0,50), unos $0,00143 con Sonnet 5.5 ($2 por millón) y unos $0,00286 con Opus 5.5 ($4 por millón). La salida son 5 etiquetas y una o dos frases, unas decenas de tokens, así que se puede ignorar.

Es decir, incluso con Opus, revisar las fotos cuesta alrededor de un tercio de lo que cuestan los datos de cada producto. Con Haiku, casi nada. Aun así, recomendamos un modelo de la gama Sonnet o superior para este paso. Lo difícil no es reconocer «esto es un termo», sino distinguir «¿es la misma tapa?» o «¿el cabezal es de bola o plano?». Un modelo barato dice «parece igual» con más facilidad cuando la diferencia es pequeña.

En Claude Code hay dos formas de leer las fotos. La primera es guardar la hoja de contactos en la carpeta del proyecto y abrirla con la herramienta Read; la página de flujos de trabajo comunes explica que puedes arrastrar una imagen a la sesión o darle a Claude la ruta del archivo (flujos de trabajo comunes). La segunda es encargar la revisión a un subagente. El subagente mira las fotos en su propio contexto y devuelve solo la respuesta, por ejemplo «el puesto 3 es el mismo producto».

La documentación oficial describe los subagentes justo para esto: una tarea lateral que genera mucho contenido que no vas a volver a necesitar (documentación de subagentes). También puedes asignar al subagente un modelo más barato para controlar el coste. Para lotes de 100 productos o más, la segunda forma mantiene la sesión principal limpia.

Gráfico de barras horizontales en dólares con el coste de revisar un producto. Tres llamadas de datos: yandex/market 0,001389; alibaba1688/image_search 0,005556; alibaba1688/product_detail 0,001389; total 0,008334. Lectura de una hoja de contactos de 715 tokens: Haiku 5.5 0,0000715; Sonnet 5.5 0,00143; Opus 5.5 0,00286. Título: unos $0,0083 de datos por producto y entre $0,00007 y $0,0029 para mirar las fotos.

Paso 4: leer la ficha de 1688 para el precio mayorista y el pedido mínimo

Cuando ya sabes cuál es el mismo producto, llamas a alibaba1688/product_detail para ese candidato. El parámetro puede ser el enlace completo o el offerId numérico. La ficha del termo respondió a las 00:17 hora de Singapur y costó $0,001389. Lo más útil de la respuesta es el array skus: este termo tiene 38 SKU según tapa, color y capacidad, de 7,88 a 11,53 yuanes.

Elegimos el SKU que coincide con el producto de Yandex Market: tapa normal, negro, 510 ml. Cuesta 8,17 yuanes (antes 8,5) y tiene 97.467 unidades en stock. El mismo SKU trae un peso de 284 gramos y una caja de 9,5 × 9,5 × 18 cm. El proveedor es una fábrica de termos de Yongkang, en Zhejiang. El pedido mínimo es de 1 unidad y el producto lleva 24.829 unidades vendidas (la página lo redondea a «25.000+»).

ProductoSKU en la fichaRango de precio por SKU (CNY)SKU elegido (CNY)Pedido mínimoPesoCaja
Termo de coche387,88–11,538,171284 g (ficha síncrona)9,5 × 9,5 × 18 cm (ficha síncrona)
Organizador de cosméticos53,76 (todos)3,761187 g (ficha asíncrona)15 × 12,5 cm, leído en la foto del proveedor
Soporte magnético217–1817278 g (ficha síncrona)en el SKU (ficha síncrona)
Proyector de estrellas85–20,9716,211falta en síncrona y asíncronafalta
Mochila urbana (solo parecida)2tramos 9,5–11111falta en síncrona y asíncronafalta

¿Por qué usar el precio del SKU y no el price_min del producto? Porque dentro de una misma ficha los precios cambian mucho. La ficha del proyector tiene 8 SKU, de 5 yuanes a 20,97 yuanes. El de 5 yuanes es un cable USB y el de 20,97 es un modelo de pie con mando. Un agente que use price_min como coste mostraría un margen mucho más alto que el real.

La regla para el agente es sencilla. Identifica el diseño a partir del título y la foto de Yandex Market. Busca la fila correspondiente en skus. Si no hay ninguna que coincida, se detiene y pregunta a una persona.

El pedido mínimo es el siguiente campo que hay que mirar. El catálogo describe min_order_quantity como el primer filtro del comercio mayorista de 1688 y aconseja revisarlo antes de comprar. En esta prueba, 4 de los 5 productos elegidos tenían un mínimo de 1 y el soporte, de 2. Todos sirven para un pedido de prueba pequeño. Pero entre los resultados de la búsqueda por imagen había una mochila con un mínimo de 500, y una búsqueda por palabra clave mostró un termo con un mínimo de 100.

El campo price_tiers da los precios por volumen. La respuesta síncrona de la mochila mostraba tres tramos: 11 yuanes de 1 a 199 unidades, 10 yuanes de 200 a 2.999 y 9,5 yuanes a partir de 3.000. La asíncrona mostraba solo un tramo: 11 yuanes desde 1 unidad. Así que el mismo producto puede mostrar precios distintos según el momento o el método. Antes de un pedido grande, comprueba los tramos reales en la página de 1688. Nuestra tabla siempre usa el precio de la cantidad mínima, que es el coste más prudente.

Peso que falta: el agente tiene que saber cuándo parar

El flete internacional se cobra por kilo y el transporte intermedio de Yandex Market se cobra por litro. Por eso el margen necesita el peso unitario y el tamaño de la caja. En el termo y en el soporte, la ficha síncrona traía weight_g y las medidas dentro del SKU.

En el organizador, la ficha síncrona no traía peso. Enviamos una tarea asíncrona a las 00:34 hora de Singapur y a las 00:36 tuvimos el resultado: la tabla de especificaciones decía «peso bruto 187 g». Las medidas, 15 × 12,5 cm, las leímos en la foto principal del proveedor: es un cilindro de 15 cm de diámetro y 12,5 cm de alto, que el script cuenta como 15 × 15 × 12,5 cm (unos 2,8 litros). El proyector y la mochila no tenían ni peso ni medidas en ninguna de las dos respuestas.

En ese caso, lo correcto es que el agente se detenga. Debe marcar el flete y el transporte intermedio como «faltan» y no inventar un número. Nuestro script hace exactamente eso. Para el proyector y la mochila solo calcula lo que queda tras la comisión, las tarifas de envío y el precio de compra: 876 rublos y 2.475 rublos. La columna de margen queda vacía.

La regla de la Skill puede ser corta: «Si falta el peso o las medidas, enumera los campos que faltan y pide los datos al proveedor. No los estimes». Parece una regla muy prudente, pero frena el error más común. Un modelo puede rellenar un número con conocimiento general, por ejemplo «una mochila pesa unos 0,6 kg». El margen parece razonable, pero no tiene ningún respaldo.

La mochila tiene un problema mayor. El título de Yandex Market dice «25 litros» y «para portátil de 15,6 pulgadas». La mochila del puesto 3 de 1688 dice «portátil de 8 pulgadas» y «capacidad de 36 a 55 litros» en su ficha asíncrona. En las fotos, las dos son negras y lisas, con un bolsillo delantero con cremallera. Si solo miras las fotos, puedes darlas por iguales; si comparas las especificaciones, ves que son productos distintos. En bolsos, calzado y ropa, el agente tiene que comparar también las especificaciones.

Paso 5: de dónde sale cada número de la fórmula del margen

La fórmula sigue la economía unitaria que usan los vendedores rusos. Se parte del precio de venta y se restan la comisión de colocación, la entrega al comprador, la tramitación del pedido, la recogida y el transporte intermedio. Después se restan el precio de compra y el flete. La tabla indica la fuente y la fecha de lectura de cada partida.

Usamos el modelo FBS de Yandex Market: el vendedor envía desde su propio almacén y la plataforma recoge los pedidos. Es el modelo que más se parece al de quien importa lotes pequeños de China y envía desde un almacén pequeño en Moscú.

PartidaValorFuente y fecha de lectura
Comisión de colocación (размещение)Precio × tarifa de categoría, 44,5 % a 50 % en las 5 categoríasTabla de comisiones de Yandex Market, leída el 2026-11-08
Entrega al comprador5 % del precio, máximo 1.000 rublosTarifas FBS, leída el 2026-11-08
Tramitación del pedido25 rublos por pedido (no para artículos grandes)Misma página
Recogida500 rublos al día de 1 a 10 pedidos; con 10 pedidos diarios, 50 rublos por pedidoMisma página
Transporte intermedio92 rublos hasta 1 litro y 8 rublos por cada litro más, redondeando hacia arribaMisma página
Tipo de cambio1 yuan = 12,2651 rublos; 1 euro = 92,1924 rublosTipos oficiales del Banco de Rusia, 2026-11-07
Flete internacional120 rublos por kilo (tarifa mínima)Página B2B de CDEK, «carga consolidada desde China desde 120 rublos/kg», leída el 2026-11-08
Captura de la página de ayuda para vendedores de Yandex Market sobre las tarifas FBS, en ruso. Arriba, un texto explica que el transporte intermedio se calcula por volumen: largo por ancho por alto entre 1.000, redondeado al litro entero. En el centro, un recuadro verde azulado marca una tabla: hasta 1 litro, 92 rublos; de 1,001 a 200 litros, 92 rublos más 8 rublos por litro adicional; por encima de 200,001 litros, 5 rublos más por litro. Abajo empieza el ejemplo 1: un armario de 121 kg y 200 × 60 × 31 cm, con 372 litros de volumen.
Tarifas originales de transporte intermedio FBS de Yandex Market; el recuadro marca los tres tramos que usa este artículo. Captura del 8 de noviembre de 2026, hora de Singapur. Captura del centro de ayuda para vendedores de Yandex Market

La tarifa de categoría es la cifra más grande de la tabla, y nos sorprendió. La tabla de colocación de Yandex Market da tarifas por categoría para cuatro modelos: FBY, FBS, Express y DBS. Nuestras categorías van del 44,5 % al 50 %; el grupo de accesorios para coche, por ejemplo, está en el 52 %. La comisión se calcula sobre el precio que fija el vendedor, aunque la plataforma aplique un descuento o el comprador use puntos. Si el comprador devuelve el artículo, la plataforma reembolsa la comisión ese mismo mes.

La página FBS del mismo centro de ayuda trae otro ejemplo: una funda de tableta de 3.000 rublos con una comisión de colocación de 510 rublos, es decir, un 17 %. Las tarifas cambian mucho de una categoría a otra. Por eso calculamos también cada fila al 17 %, como referencia de una categoría con comisión baja. No es la tarifa real de estos 5 productos.

Hay otra regla especial. En FBS, los artículos de menos de 300 rublos y menos de 5 litros pagan una tarifa única del 42 % hasta finales de 2026, que ya incluye colocación, entrega y transporte intermedio. Nuestros 5 productos cuestan 1.200 rublos o más, así que no se aplica. Pero si revisas accesorios de pocas decenas de rublos, el agente tiene que comprobar primero esta regla; si no, cobrará dos veces lo mismo.

Para el tipo de cambio usamos el oficial del Banco de Rusia. El yuan subió un 1,47 % en una semana, como muestra la tabla. Un movimiento así basta para cambiar el resultado de un producto con poco margen. Un cambio de divisa real añade además el diferencial del banco o del servicio de pago, que la tabla no incluye.

Fecha del Banco de RusiaRUB por 1 CNYRUB por 1 USDRUB por 1 EUR
2026-10-3112,087380,557389,6603
2026-11-0412,181681,669991,6010
2026-11-0612,257081,794792,1581
2026-11-07 (el que usa este artículo)12,265182,138692,1924

Esa subida del 1,47 % apenas mueve el margen: el soporte cuesta unos 3 rublos más (0,25 puntos menos de margen) y el termo 1,5 rublos más, frente a 1.750 rublos de comisión de colocación. Cuando la compra es solo del 1 % al 17 % del precio, la tarifa de la categoría pesa más de cien veces lo que pesa el tipo de cambio. (El tipo central del Banco Popular de China del 2026-11-06 fue de 12,2130 rublos por yuan, un 0,4 % por debajo del Banco de Rusia; avisos, en chino.) Para los valores en euros de este artículo usamos el tipo cruzado del Banco de Rusia del 7 de noviembre: 8,17 yuanes son unos 1,09 €.

Para el flete usamos la tarifa pública de CDEK, «desde 120 rublos por kilo», que es la mínima. La página de carga consolidada de CDEK aclara que este tipo de envío empieza en 100 kg y tarda de 10 a 14 días (página de carga consolidada de CDEK). 100 kg son unos 352 termos o 1.282 soportes de 78 g. Un pedido de prueba pequeño va por mensajería urgente, mucho más cara por kilo. Es una de las razones por las que todos los márgenes de la tabla son optimistas.

Resultados reales: mismo producto × precio en 1688 × precio en Yandex Market × margen

Este es el resultado completo. Un script calculó cada cifra a partir de las respuestas originales: lee los JSON de Yandex Market y de 1688, el XML del Banco de Rusia y las etiquetas de las fotos. Aplica las tarifas de la tabla anterior partida por partida y escribe un JSON. Los rublos se redondean a la unidad, con .5 al par más cercano: 274,5 queda en 274 y 2.920,5 en 2.920.

Producto (Yandex Market)Precio (RUB)Coste en 1688 (CNY)MínimoCoste en RUBTarifaColocaciónEntrega + fijosIntermedioFleteMargen (RUB)Margen %
Termo de coche, 510 ml3.5008,17110050 %1.750250100341.26636,2 %
Organizador giratorio3.9903,7614649,5 %1.975274108221.56439,2 %
Soporte magnético1.20017220944,5 %53413592922118,4 %
Proyector astronauta2.50016,21119949 %1.225200faltafaltasin calcular (876 tras el coste)—
Mochila urbana5.90011 (modelo parecido)113549,5 %2.920370faltafaltasin calcular (modelo parecido; quedan 2.475 tras el coste)—
Gráfico de barras horizontales apiladas en rublos por unidad. Cada uno de los 5 productos tiene una barra tan larga como su precio en Yandex Market, dividida de izquierda a derecha en coste de compra, flete, comisión de colocación, entrega y fijos, transporte intermedio y margen (verde azulado). Termo 3.500: coste 100, flete 34, colocación 1.750, entrega y fijos 250, intermedio 100, margen 1.266. Organizador 3.990: 46, 22, 1.975, 274, 108, margen 1.564. Soporte 1.200: 209, 9, 534, 135, 92, margen 221. Proyector 2.500 y mochila 5.900 marcan el flete y el intermedio como faltantes, y la última parte gris dice «quedan 876 tras el coste» y «quedan 2.475 tras el coste». Título: la comisión de la plataforma es la parte más grande y el coste de compra es solo del 1 % al 17 % del precio.

La primera conclusión es directa: en estos productos pequeños, el coste en 1688 es una parte mínima del precio. Es el 2,9 % en el termo, el 1,2 % en el organizador y el 17,4 % en el soporte. Lo que se come el dinero es la comisión de la plataforma. En los 3.500 rublos del termo, la comisión de colocación es de 1.750 rublos, más de 17 veces el coste de compra.

Así que los vendedores rusos tienen razón cuando dicen que «la mercancía es barata», pero es solo media historia. Con una tarifa de categoría del 17 % en lugar del 50 %, el margen del mismo termo pasa del 36,2 % al 69,2 %. El organizador pasa del 39,2 % al 71,7 %, y el soporte, del 18,4 % al 45,9 %. La tarifa es la cifra más sensible de toda la tabla.

El soporte de móvil muestra otro problema. Es el que más valoraciones tiene en Yandex Market (5.372), así que se vende. Pero en un precio de 1.200 rublos, el coste de 17 yuanes son 209 rublos, y cada pedido paga además 25 rublos de tramitación y 50 de recogida. Esas tarifas fijas no bajan con el precio: son 75 rublos por pedido tanto a 1.200 como a 3.500 rublos. Para los artículos de menos de 300 rublos, Yandex Market tiene aparte la tarifa del 42 % ya citada.

La tabla deja fuera algunos costes, y hay que tenerlos presentes para no confundirla con el beneficio neto. La siguiente tabla los enumera con un valor aproximado cuando los datos públicos lo permiten.

Coste que no está en la tablaValor aproximado para nuestras filasFuente
IVA de importación22 % de coste más flete: unos 30 RUB (termo), 15 RUB (organizador), 48 RUB (soporte)IVA general del 22 % desde el 2026-01-01 (nota del Servicio Federal de Impuestos, en ruso, resumen de ConsultantPlus, en ruso)
ArancelDepende del código arancelarioConsultar por código
Impuesto sobre la renta o régimen simplificadoDepende de tu situación fiscalTu propia configuración fiscal
Devoluciones15 RUB de tramitación por devolución más el envío de vuelta a tarifa de transporte intermedioTarifas FBS
Publicidad y promocionesTu propio presupuestoNo es público
Diferencial de cambio y comisiones de pagoTu banco o servicio de pagoNo es público

Todo junto puede convertir la fila del soporte en pérdidas. Usa esta tabla para descartar productos que claramente no funcionan, no como decisión final de compra.

El mismo termo tiene 5 precios en Yandex Market

El paso 1 solo tomó el termo más popular, a 3.500 rublos. ¿El precio del vendedor más popular refleja el precio de mercado?

A las 00:36 hora de Singapur volvimos a llamar a yandex/market con una palabra clave más concreta, «термокружка coffee 510 мл», y tomamos 20 resultados. Clasificamos cada foto en tres niveles. El nivel A tiene el mismo cuerpo y la misma tapa. El nivel B es el mismo tipo de termo con otra tapa u otra funda. El nivel C es otro producto.

Salieron 5 en el nivel A, 10 en el B y 5 en el C. Los 5 del nivel A cuestan 3.500, 2.874, 2.441, 1.586 y 1.227 rublos: el más caro es casi 3 veces el más barato y la mediana es de 2.441 rublos. Es decir, el vendedor más popular es también el más caro. Un vendedor nuevo con el mismo termo difícilmente venderá a 3.500 rublos.

Con la mediana de 2.441 rublos (unos 26,48 €), el margen es de 789 rublos, un 32,3 %. Con el precio más bajo, 1.227 rublos (unos 13,31 €), quedan solo 243 rublos, un 19,8 %. Con una tarifa del 17 %, esos dos precios darían 1.595 rublos (65,3 %) y 648 rublos (52,8 %).

Gráfico de barras horizontales en rublos. Los 20 resultados de Yandex Market para «термокружка coffee 510 мл» ordenados de menor a mayor precio, con colores por nivel. Nivel A, mismo producto (verde azulado), 5 resultados: 1.227, 1.586, 2.441, 2.874 y 3.500. Nivel B, mismo tipo con otra tapa (gris claro), 10 resultados de 1.472 a 12.253. Nivel C, otros productos (gris oscuro), 5 resultados de 3.799 a 53.120. Una línea vertical discontinua marca el coste puesto en destino, unos 134 rublos (100 de coste más 34 de flete). Título: 5 vendedores ofrecen el mismo termo, de 1.227 a 3.500 rublos.
Gráfico de líneas. El eje horizontal es el precio del termo en rublos, con 5 puntos en los 5 precios del nivel A: 1.227, 1.586, 2.441, 2.874 y 3.500. El eje vertical es el margen por unidad en rublos. Dos líneas: con tarifa del 50 %, 243, 404, 789, 984 y 1.266 (línea continua verde azulado); con tarifa del 17 %, 648, 928, 1.595, 1.932 y 2.421 (línea discontinua gris). Título: el coste del termo no cambia; el precio y la tarifa deciden el margen.

Esta consulta extra costó solo $0,001389 y cambió la conclusión de «36 % de margen» a «entre el 19,8 % y el 36,2 %, según el precio que consigas». Por eso recomendamos un paso más en el agente. Después de identificar el mismo producto, vuelve a buscar en Yandex Market con las palabras del título y mira cuántos vendedores lo ofrecen y a qué precios. Luego calcula el margen con la mediana, no con el precio del más vendido.

Como contraste, llamamos dos veces a alibaba1688/search con palabras clave en chino y tomamos 20 resultados ordenados por ventas. La de los termos significa «taza de café de acero 304, termo de coche, 510 ml».

Búsqueda por palabra clave en 1688Hora de SingapurMediana del precio mínimoRangoElegido por imagen
Termo de coche 510 ml00:3711,5 yuanes2,96–15,5 yuanes8,17 yuanes (iguales: 7,88–11,66)
Proyector de estrellas00:4622,94 yuanes5–72 yuanes16,21 yuanes

El de 2,96 yuanes se llama igual que nuestro termo, pero pide un mínimo de 100 unidades (es precio por volumen) y no trae foto, así que no se puede saber si es el mismo modelo. Cada método tiene su función: la búsqueda por imagen encuentra el mismo producto y la búsqueda por palabra clave muestra la franja de precios.

Comprar en 1688 desde España: el mismo tipo de termo en Amazon.es

Si vendes en España, el agente funciona igual. Solo cambia el paso 1: usa amazon/search con el parámetro domain en lugar de yandex/market (capacidad de búsqueda de productos de Amazon). Para ver el nivel de precios hicimos una llamada extra a las 01:46 hora de Singapur. La palabra clave fue «termo taza café coche 510 ml acero inoxidable» en amazon.es con lang: es. Devolvió 10 resultados, todos con precio, y costó $0,002236.

Producto en Amazon.es (búsqueda por palabra clave, sin revisar fotos)PrecioNotaValoraciones
Mulbijeo termo café 600 ml antigoteo para coche10,74 €4,413
Motswedi termo café 600 ml antigoteo para coche12,39 €4,912
Grsta taza térmica de acero inoxidable 600 ml9,46 €4,497
Motswedi taza de café 600 ml de acero 3048,83 €5,01
Contigo vaso térmico Byron Snapseal20,65 €4,524.390
STANLEY 1913 Transit Flip Top, 0,35 L26,40 €4,6447

Los 10 precios van de 8,83 € a 26,40 € y la mediana es de 12,05 €. El termo de 1688 cuesta unos 1,09 €, así que el coste de compra es alrededor del 9 % de la mediana en Amazon.es. Es bastante más que el 2,9 % de Yandex Market. Como estos resultados no están revisados por foto, tómalos como una franja de precios y no como el mismo producto. Amazon tiene además sus propias comisiones por venta y logística, que este artículo no calcula. Antes de fiarte de un margen en España, añade a la fórmula la comisión de Amazon de tu categoría, el IVA y el arancel de importación.

парсер 1688: escribir tu propio scraper o usar una API

Los vendedores rusos que buscan «парсер 1688» (un analizador de 1688) suelen querer una herramienta que saque precios de 1688 en bloque. En GitHub, los proyectos de código abierto siguen dos caminos. El primero imita un navegador. Un proyecto de búsqueda por imagen con 204 estrellas obtiene la cookie y el token, firma la petición, sube la foto y lanza la búsqueda. Su autor avisa de que el código es «solo para aprender» y no para uso comercial (proyecto de búsqueda por imagen en 1688).

El segundo camino es una herramienta de línea de comandos para agentes de IA. Por ejemplo, 1688-cli funciona dentro de un Chrome real y necesita iniciar sesión con un código QR desde la app de 1688 (1688-cli). Puede buscar, hacer búsquedas por imagen y leer fichas. También puede pedir presupuestos y hacer pedidos.

Los dos caminos tienen los mismos costes. Tienes que mantener la sesión y la firma de las peticiones. Tienes que cambiar el código cada vez que cambia la página. Y el riesgo para tu cuenta de 1688 corre de tu cuenta.

1688 tiene además su propia plataforma abierta, con una capacidad de búsqueda por imagen para compradores transfronterizos y proveedores de ERP (capacidad de búsqueda por imagen de la plataforma abierta de Alibaba). Pero su documentación exige contratar antes una solución de compras transfronterizas o de integración ERP (documentación de la API de búsqueda por imagen transfronteriza). Es un camino para proveedores de servicios acreditados, no para un vendedor que quiere hacer una prueba rápida.

Con una API de datos como EveryInfra no necesitas sesión ni firma. Pagas por llamada y las llamadas fallidas no se cobran. A cambio, recibes campos ya ordenados, pero no puedes hacer pedidos ni pedir presupuestos. La tabla compara los cuatro caminos.

CaminoSesión en 1688Búsqueda por imagenPedidos y presupuestosMantenimientoCoste
Proyecto de código abierto que imita un navegadorSí, mantienes cookies y firmasSíNoAlto, se rompe cuando cambia la páginaGratis, pero el riesgo es de tu cuenta
Herramienta de línea de comandos en el navegadorSí, con QRSíSíMedioGratis, pero el riesgo es de tu cuenta
Plataforma abierta de 1688Requiere acreditación y una solución de pagoSí (catálogo transfronterizo)Depende de la soluciónBajoSegún la solución
API de datos de EveryInfraNoSí (hasta 5 por llamada)NoBajoDe $0,001389 a $0,005556 por llamada, sin cargo si falla

Para un agente de compras, «no hace pedidos» no es un problema: su trabajo es decidir antes de pedir. Para el pedido en sí, los vendedores suelen usar un agente de compras o su propia cuenta de 1688. La API de datos mira; una persona o un agente de compras compra.

Escribir el proceso como Skill: las mismas reglas en cada revisión

Una Skill de Claude Code es un archivo SKILL.md con instrucciones. Claude la usa en las tareas relacionadas y también puedes lanzarla con /nombre-de-la-skill. A diferencia de CLAUDE.md, el cuerpo de la Skill solo se carga cuando se usa (documentación de Skills), así que un texto de referencia largo casi no ocupa contexto el resto del tiempo. Las reglas de compra encajan bien en una Skill, porque la tabla de tarifas, la fuente del tipo de cambio y la regla para datos que faltan no cambian. Este es el esqueleto de un ejemplo de configuración:

markdown
---
name: sourcing-margin
description: Recibe una palabra clave de producto en ruso, lee el precio en Yandex Market, busca el mismo artículo en 1688 y calcula el margen FBS
---
1. Llama a everyinfra_call_api: platform=yandex, action=market, city=moscow, sort=popular, limit=10.
   Ordena por rating_count. purchase_count puede ser null; no lo uses como señal principal.
2. Llama a alibaba1688/image_search con el image_url del producto elegido, mode=async. Lee el resultado con everyinfra_get_job.
3. Reduce la foto de origen y los 5 candidatos a 300x300 y únelos en una sola hoja.
   Marca cada candidato como igual / parecido / erróneo. El primer puesto no siempre es el mismo producto.
   En bolsos, calzado, ropa y otros productos que se parecen, compara también las especificaciones (medidas, capacidad, compatibilidad).
4. Llama a alibaba1688/product_detail para el mismo producto. Toma el precio del SKU, weight_g y las medidas del diseño que coincide.
   Si falta el peso o las medidas, repite una vez con mode=async. Si siguen faltando, enumera lo que falta. No lo estimes.
5. Vuelve a llamar a yandex/market con las palabras del título del mismo producto (limit=20). Toma la mediana de precio del mismo producto.
6. Ejecuta margin.py con la columna FBS de la tabla de tarifas, el tipo del Banco de Rusia del día y la tarifa mínima de flete.
   Devuelve la tabla y enumera los impuestos y costes que no incluye.

Las reglas de esta Skill salen de los resultados reales, no de la imaginación. La tabla muestra cada regla y el dato que la respalda.

Regla de la SkillDato de la prueba real
Usar el modo asíncrono en la búsqueda por imagen2 de 7 búsquedas síncronas agotaron el tiempo a los 85 segundos (sin cargo)
El primer puesto no siempre es el mismo productoEl primer puesto fue erróneo o solo parecido en 3 de 5 búsquedas
No estimar el peso que falta2 de 5 productos no tenían peso ni en la ficha síncrona ni en la asíncrona
Usar la mediana de precio del mismo productoEl mismo termo se vende de 1.227 a 3.500 rublos según el vendedor

Para ejecutar un lote cada día o cada semana, usa el modo no interactivo claude -p (documentación del modo sin interfaz). Con --allowedTools permites herramientas de antemano y con --output-format obtienes una salida estructurada. Hay una trampa: con --bare, Claude Code no lee el .mcp.json del proyecto ni descubre Skills automáticamente, y solo conecta los servidores MCP que le pases con --mcp-config. En una ejecución programada, o no uses --bare, o pasa la configuración MCP en la línea de comandos.

La misma página describe --max-budget-usd, que fija un límite de gasto para una ejecución. Cuando una ejecución llega al límite, Claude Code detiene el trabajo en segundo plano que quede. Con datos que se cobran por llamada, conviene tener ese segundo freno de gasto fuera del agente. Si prefieres lanzar las ejecuciones desde una sesión, Claude Code también tiene tareas programadas (documentación de tareas programadas). En otro artículo las usamos para resumir cada día los problemas que cuentan los usuarios de Reddit (tareas programadas de Claude Code en la práctica).

Función de Claude CodeUso en este agenteVersión o fechaFuente oficial
MCP remoto por HTTPConectar las herramientas de EveryInfraLeído el 2026-11-08Documentación MCP
Permisos y ajustesPermitir solo las dos herramientas de EveryInfraLeído el 2026-11-08Documentación de permisos
SubagentesRevisión de fotos en un contexto aparteLeído el 2026-11-08Documentación de subagentes
SkillsReglas de compra fijasLeído el 2026-11-08Documentación de Skills
claude -p, --max-budget-usdLotes programados con límite de gastoLeído el 2026-11-08Documentación del modo sin interfaz
Tareas MCP en el terminalLas llamadas lentas pasan a segundo plano2.1.319, 2026-11-06Registro de cambios
permissions.denyInsteadOfPromptingNo quedarse parado ante una petición de permiso2.1.319, 2026-11-06CHANGELOG.md

Búsquedas por imagen lentas y tareas MCP en Claude Code

Como vimos, 2 de 7 búsquedas por imagen agotaron el tiempo a los 85 segundos en modo síncrono. Con un servidor MCP remoto hay dos formas de manejar las llamadas lentas. La primera está del lado de los datos: envía mode: async a everyinfra_call_api, recibe un job_id al instante y consúltalo con everyinfra_get_job. Nuestras dos búsquedas asíncronas tardaron, desde el envío hasta el resultado, alrededor de 1 minuto y 22 segundos y alrededor de 2 minutos.

La segunda está del lado de Claude Code. Claude Code 2.1.319 se publicó en npm el 2026-11-06 (historial de versiones en npm). Su registro de cambios añade soporte para tareas MCP en el terminal (página del registro de cambios). Cuando un servidor MCP ejecuta una llamada como tarea, Claude Code la pasa a segundo plano enseguida y avisa a Claude cuando termina. Si prefieres que Claude Code espere dentro de la llamada, define CLAUDE_CODE_DISABLE_MCP_TASK_BACKGROUND.

La misma versión añade el ajuste permissions.denyInsteadOfPrompting (CHANGELOG de Claude Code). Con él, una llamada que tendría que esperar una petición de permiso se rechaza y el turno continúa, en sesiones de terminal, subagentes y compañeros de equipo. En un lote, este ajuste evita que el agente se quede esperando una confirmación que nadie va a dar. Úsalo junto con la regla que permite las dos herramientas de EveryInfra; si no, Claude Code rechazará también las llamadas que necesitas.

Esta prueba también demuestra que las llamadas fallidas no se cobran. Los dos 503 por tiempo traían billing.charged: false y refund.status: succeeded. A las 00:17:57 hora de Singapur enviamos dos peticiones a yandex/market a la vez. Chocaron con el límite de la clave de prueba, 10 llamadas por minuto, y las dos devolvieron HTTP 429 sin cargo.

Para conciliar los reembolsos de llamadas fallidas, consulta la guía de conciliación de reembolsos. Para que un agente corrija sus propios parámetros a partir del texto de error, consulta errores de API que el agente puede corregir.

Cuánto cuesta revisar 100 productos

A precios de catálogo, cada producto necesita 3 llamadas de datos: yandex/market a $0,001389, alibaba1688/image_search a $0,005556 y alibaba1688/product_detail a $0,001389. En total, $0,008334; se cobra por llamada, así que limit: 10 o limit: 20 cuestan lo mismo. La consulta extra en Yandex Market para ver la franja de precios suma $0,001389, hasta $0,009723. 100 productos cuestan unos $0,83 sin esa consulta o $0,97 con ella; 1.000 productos, unos $8,33 o $9,72.

Esta prueba tuvo 23 llamadas cobradas, por un total de $0,057254. Hubo 6 llamadas a yandex/market y 5 búsquedas por imagen cobradas; las 2 que agotaron el tiempo no se cobraron. Hubo también 8 fichas de producto (5 síncronas y 3 asíncronas), 2 búsquedas por palabra clave en 1688 y 2 llamadas a amazon/search para los ejemplos de Estados Unidos y España. La lectura de la lista de herramientas MCP fue gratuita. El total supera los 5 × $0,008334 porque pedimos algunas fichas dos veces y lanzamos consultas de contraste.

El lado de Claude depende de tu plan. Con Claude Code dentro de una suscripción de Claude, mirar fotos y razonar cuenta para el uso de la suscripción; la documentación de subagentes dice que sus peticiones cuentan para los mismos límites de uso. Con una clave de API pagas por token. La tabla solo cuenta los 715 tokens de visión de la hoja; la descripción de las herramientas, las respuestas JSON y la salida del modelo también cuentan, y no las medimos en Claude Code. Usa tu propio /usage (documentación de costes).

EscalaDatos (3 llamadas por producto)Con franja de precios (4 llamadas)Revisión de fotos (Sonnet 5.5, 715 tokens por producto)
1 producto$0,008334$0,009723$0,00143
100 productos$0,83$0,97$0,14
1.000 productos$8,33$9,72$1,43

Límites y precauciones

Primero, EveryInfra no ofrece datos públicos de productos de Ozon ni de Wildberries. Este artículo usa los precios de Yandex Market porque son los que podemos leer de las tres grandes plataformas rusas. Un precio de Yandex Market no es el que vas a conseguir en Wildberries u Ozon: las tres tienen compradores, comisiones, logística y promociones distintas.

Si vendes en Ozon, puedes leer los datos de tu propia tienda con la API de vendedores de Ozon (documentación de Ozon Seller API). Yandex Market también tiene su API para vendedores (documentación de la API de socios de Yandex Market). Esas API dan datos de tu cuenta de vendedor, no datos públicos de la competencia. Su uso es distinto del de este artículo.

Segundo, la búsqueda por imagen devuelve como mucho 5 candidatos por llamada y el orden no es fiable. Cuando ninguno de los 5 es el mismo producto, como en la mochila, el agente debe buscar de nuevo con otra foto: la segunda foto del producto o una sin fondo. También puede pasar a una búsqueda por palabra clave en chino. Lo que no debe hacer es elegir uno de los 5 parecidos para rellenar la fila.

Tercero, los precios, el stock y los tramos de 1688 cambian a todas horas, y los productos pueden desaparecer. Vimos tramos distintos para el mismo producto en la respuesta síncrona y en la asíncrona. Guarda la hora de consulta junto a cada resultado y no hagas pedidos con resultados de hace más de una o dos semanas.

Cuarto, las tarifas, los tipos de cambio y el flete de la tabla son precios públicos estándar. No incluyen descuentos negociados con la plataforma o con el transportista, ni impuestos, devoluciones o publicidad. No damos asesoramiento financiero ni de inversión; los márgenes de este artículo son estimaciones con datos públicos.

Quinto, las normas cambian. El 2026-10-29, la Duma Estatal rusa aprobó en primera lectura un proyecto de ley que añade un IVA del 22 % a los pedidos de tiendas en línea extranjeras (noticia de GoGov, en ruso). Está previsto que entre en vigor el 1 de enero de 2027, y el plazo para enmiendas de segunda lectura termina el 12 de noviembre. Afecta sobre todo a los envíos transfronterizos directos al comprador ruso. Para quien importa desde China y envía desde un almacén en Rusia, el efecto es que parte de la competencia tendrá costes más altos.

La noticia también dice que hoy los pedidos del extranjero de menos de 200 euros no pagan arancel. Al tipo del Banco de Rusia del 2026-11-07, 92,1924 rublos por euro, son unos 18.438 rublos. Puedes comprobar también el tipo de referencia del euro en la página del Banco Central Europeo.

Cambios recientes

Claude Code 2.1.319 y el proyecto de IVA del 2026-10-29 ya están en el cuerpo del artículo; aquí solo van los cambios externos que alteran la fórmula del margen.

2026-10-22: el portal ruso de noticias aduaneras TKS.RU informa de que Yandex Market cambia las reglas de almacén FBY desde el 2026-11-01 (noticia de TKS.RU). Desaparece la tarifa de 150 rublos por unidad sobrante en la entrada y la sustituye una multa de 10 rublos por litro de diferencia de volumen. La tarifa del centro de clasificación pasa a 20 rublos el primer litro y 5 rublos por litro adicional. Quien use FBY tiene que reescribir la parte logística de la fórmula y no copiar el cálculo FBS de este artículo.

2026-07: según T-Journal, Wildberries subió las comisiones a los vendedores chinos tras la presión de la autoridad de competencia (artículo de T-Journal). Una asociación del sector estimó que en diciembre de 2025 los vendedores chinos pagaban un 11 % en Wildberries y un 14 % en Ozon, frente a hasta un 44 % de algunos vendedores rusos. Para el lector, el mismo producto puede llevar comisiones muy distintas según quién lo venda, así que la tarifa de tu tabla debe ser la tuya.

Preguntas frecuentes

¿Hay 1688 en español?

La pregunta sale de la sugerencia de Google «1688 en español», leída el 2026-11-08. Los títulos de los productos en 1688 están en chino, como se ve en la captura de este artículo. El enfoque de este artículo evita el problema del idioma: buscas en un marketplace en tu idioma, pasas la foto a la búsqueda por imagen de 1688 y pides a Claude que te resuma la ficha. Los campos de la API (precio, pedido mínimo, peso) son números y no necesitan traducción.

¿Cómo comprar en 1688 desde España o desde México?

La pregunta sale de las sugerencias de Google «comprar en 1688 desde españa» y «comprar en 1688 desde mexico», leídas el 2026-11-08. Para el pedido en sí, lo habitual es un agente de compras o tu propia cuenta de 1688. En el hilo de Reddit citado más arriba, un vendedor cuenta que el pago y el idioma son los principales obstáculos. Una API de datos no hace pedidos. Sirve para decidir antes qué comprar, a qué precio y con qué pedido mínimo.

¿Cuánto cuesta la API de 1688?

La pregunta sale de la sugerencia de Google «1688 api pricing», leída el 2026-11-08. En la plataforma abierta de 1688 primero hay que contratar una solución, y el precio depende de ella. EveryInfra cobra por llamada: alibaba1688/product_detail cuesta $0,001389, alibaba1688/search $0,002778 y alibaba1688/image_search $0,005556. Las llamadas fallidas y los tiempos agotados no se cobran, y una revisión completa de un producto cuesta $0,008334.

¿Necesito mi propia clave de 1688?

La pregunta sale de la sugerencia de Google «1688 api key», leída el 2026-11-08. La plataforma abierta de 1688 exige una cuenta de desarrollador, una aplicación y una solución de pago. EveryInfra no necesita cuenta ni clave de 1688. Solo necesitas una clave de EveryInfra, que creas en la guía de inicio rápido y añades en Claude Code con --header.

¿Existe una API de 1688 gratuita?

La pregunta sale de la sugerencia de Google «1688 api free», leída el 2026-11-08. Los proyectos de código abierto que imitan un navegador son gratuitos, pero tienes que mantener la sesión y la firma, y el riesgo es de tu cuenta; algunos prohíben además el uso comercial. Nuestro catálogo y la lista de herramientas MCP se pueden leer gratis. Las llamadas de datos se cobran por llamada.

парсер 1688: ¿hay un parser de 1688 ya hecho?

La pregunta sale de la sugerencia de Google «парсер 1688» («parser de 1688»), leída el 2026-11-08. En GitHub hay dos tipos: scrapers que imitan un navegador, con cookies y firma a tu cargo (alguno prohíbe el uso comercial), y herramientas de línea de comandos que corren en un Chrome real con sesión de 1688 por código QR. En los dos casos el riesgo es de tu cuenta. Una API de datos no pide sesión, pero no hace pedidos; la sección «парсер 1688» compara los cuatro métodos.

¿Estas plataformas ofrecen una API o un enlace directo para hacer pedidos?

La pregunta sale de un hilo de Reddit r/dropshipping que pregunta «do these platforms provide link/API» (hilo original). Varias respuestas dicen que 1688 no tiene una API de dropshipping para compradores normales y que se trabaja con un agente de compras o con una plataforma que ya tiene la conexión. Una API de datos responde a «cuánto cuesta y cuál es el mismo artículo». Para pedir, sigues necesitando un agente de compras o tu propia cuenta de 1688.

Referencias

  1. Connect Claude Code to tools via MCP, documentación de Claude Code, Anthropic, leída el 2026-11-08, https://code.claude.com/docs/en/mcp
  2. Create custom subagents, documentación de Claude Code, Anthropic, leída el 2026-11-08, https://code.claude.com/docs/en/sub-agents
  3. Extend Claude with skills, documentación de Claude Code, Anthropic, leída el 2026-11-08, https://code.claude.com/docs/en/skills
  4. Run Claude Code programmatically (headless), documentación de Claude Code, Anthropic, leída el 2026-11-08, https://code.claude.com/docs/en/headless
  5. Claude Code settings, documentación de Claude Code, Anthropic, leída el 2026-11-08, https://code.claude.com/docs/en/settings
  6. Configure permissions, documentación de Claude Code, Anthropic, leída el 2026-11-08, https://code.claude.com/docs/en/permissions
  7. Manage costs effectively, documentación de Claude Code, Anthropic, leída el 2026-11-08, https://code.claude.com/docs/en/costs
  8. Common workflows, documentación de Claude Code, Anthropic, leída el 2026-11-08, https://code.claude.com/docs/en/common-workflows
  9. Scheduled tasks, documentación de Claude Code, Anthropic, leída el 2026-11-08, https://code.claude.com/docs/en/scheduled-tasks
  10. Hooks reference, documentación de Claude Code, Anthropic, leída el 2026-11-08, https://code.claude.com/docs/en/hooks
  11. Changelog, documentación de Claude Code, Anthropic, leída el 2026-11-08, https://code.claude.com/docs/en/changelog
  12. CHANGELOG.md (2.1.319), anthropics/claude-code, GitHub, leída el 2026-11-08, https://github.com/anthropics/claude-code/blob/main/CHANGELOG.md
  13. Historial de versiones de @anthropic-ai/claude-code (2.1.319 publicada el 2026-11-06), npm, https://www.npmjs.com/package/@anthropic-ai/claude-code
  14. Vision, documentación de Claude Platform, Anthropic, leída el 2026-11-08, https://platform.claude.com/docs/en/build-with-claude/vision
  15. Pricing, documentación de Claude Platform, Anthropic, leída el 2026-11-08, https://platform.claude.com/docs/en/about-claude/pricing
  16. Transports (2025-06-18), especificación de Model Context Protocol, https://modelcontextprotocol.io/specification/2025-06-18/basic/transports
  17. Tools (2025-06-18), especificación de Model Context Protocol, https://modelcontextprotocol.io/specification/2025-06-18/server/tools
  18. Catálogo de datos de EveryInfra, EveryInfra, leído a las 00:13 SGT del 2026-11-08, https://api.everyinfra.com/api/v1/social/catalog
  19. Catálogo de 1688 de EveryInfra, EveryInfra, leído el 2026-11-08, https://api.everyinfra.com/api/v1/social/catalog?platform=alibaba1688
  20. Catálogo de Yandex de EveryInfra, EveryInfra, leído el 2026-11-08, https://api.everyinfra.com/api/v1/social/catalog?platform=yandex
  21. Catálogo de Amazon de EveryInfra, EveryInfra, leído el 2026-11-08, https://api.everyinfra.com/api/v1/social/catalog?platform=amazon
  22. Comisiones de colocación (en ruso), centro de ayuda para vendedores de Yandex Market, leída el 2026-11-08, https://yandex.ru/support/marketplace/ru/introduction/rates/placement
  23. Tarifas del modelo FBS (en ruso), centro de ayuda para vendedores de Yandex Market, leída el 2026-11-08, https://yandex.ru/support/marketplace/ru/introduction/rates/models/fbs
  24. Documentación de la API de socios de Yandex Market (en ruso), Yandex, leída el 2026-11-08, https://yandex.ru/dev/market/partner-api/doc/ru/
  25. Tipos oficiales de cambio, XML del 2026-11-07, Banco de Rusia, https://www.cbr.ru/scripts/XML_daily.asp?date_req=07/11/2026
  26. Página de tipos oficiales diarios, Banco de Rusia, leída el 2026-11-08, https://www.cbr.ru/currency_base/daily/
  27. Avisos del tipo central del yuan (en chino, aviso del 2026-11-06), Banco Popular de China, https://www.pbc.gov.cn/zhengcehuobisi/125207/125217/125925/index.html
  28. Euro foreign exchange reference rates, Banco Central Europeo, leída el 2026-11-08, https://www.ecb.europa.eu/stats/policy_and_exchange_rates/euro_reference_exchange_rates/html/index.en.html
  29. Transporte internacional de carga B2B (en ruso), CDEK, leída el 2026-11-08, https://b2b.cdek.ru/
  30. Carga consolidada desde China y Turquía a partir de 100 kg (en ruso), CDEK, leída el 2026-11-08, https://b2b.cdek.ru/freight
  31. Cómo calcular el IVA con las normas de 2026 (en ruso), Servicio Federal de Impuestos de Rusia, 2025-12-17, https://www.nalog.gov.ru/rn25/news/activities_fts/16590316/
  32. Subida del tipo de IVA desde el 1 de enero (en ruso), ConsultantPlus, leída el 2026-11-08, https://www.consultant.ru/document/cons_doc_LAW_517272/
  33. Nuevo impuesto a las compras en marketplaces extranjeros (en ruso), GoGov, leída el 2026-11-08, https://gogov.ru/news/941292
  34. Yandex Market cambia las tarifas de procesamiento de almacén (en ruso), TKS.RU, 2026-10-22, https://www.tks.ru/politics/2026/10/22/0017/yandeks-market-izmenit-tarifyi-skladskoj-obrabotki-tovarov/
  35. Subida de precios en Wildberries y Ozon (en ruso), T-Journal, leída el 2026-11-08, https://t-j.ru/kitai-zahvatil-marketpleisy/
  36. Documentación de Ozon Seller API (en ruso), Ozon, leída el 2026-11-08, https://docs.ozon.ru/api/seller/
  37. Capacidad de búsqueda por imagen transfronteriza (en chino), plataforma abierta de Alibaba, leída el 2026-11-08, https://open.1688.com/ability/detail?key=1611630817677
  38. Documentación de alibaba.cross.similar.offer.search (en chino), plataforma abierta de Alibaba, leída el 2026-11-08, https://open.1688.com/api/apidocdetail.htm?aopApiCategory=linkplus&id=com.alibaba.linkplus:alibaba.cross.similar.offer.search-1
  39. 1688_crawler-image_search_products, GitHub, leída el 2026-11-08, https://github.com/Carmenliukang/1688_crawler-image_search_products
  40. 1688-cli, GitHub, leída el 2026-11-08, https://github.com/superjack2050/1688-cli
  41. wildberries-agent-integration, GitHub, leída el 2026-11-08, https://github.com/bearscloud/wildberries-agent-integration
  42. wb-calculator, GitHub, leída el 2026-11-08, https://github.com/husravtjk/wb-calculator
  43. statistics: funciones de estadística matemática (mediana), documentación de Python, leída el 2026-11-08, https://docs.python.org/3/library/statistics.html
  44. Which Chinese platforms are used for sourcing specifically for dropshipping?, Reddit r/dropshipping, leída el 2026-11-08, https://www.reddit.com/r/dropshipping/comments/1x3kq5q/which_chinese_platforms_are_used_for_sourcing/

Referencia BL-110