Yuanbao Search API: qué devuelve y cómo sumar datos de apps chinas

El 2026-10-20 Tencent abrió Yuanbao Search a desarrolladores externos a través de Tencent Cloud, con una API, un servidor MCP y una Skill, y con 2000 llamadas gratis al mes (MyDrivers, 2026-10-20). Cada resultado de SearchPro trae título, fecha, enlace, resumen, nombre del sitio y una puntuación de relevancia, pero no trae likes, comentarios, guardados, reproducciones ni seguidores, y las preguntas frecuentes de Tencent Cloud dicen que no incluye los artículos de las cuentas oficiales de WeChat (referencia de SearchPro, preguntas frecuentes de Yuanbao Search). Entre las 00:17 y las 00:20, hora de Singapur, del 2026-11-06 lanzamos una misma búsqueda de producto en Xiaohongshu, Douyin, Bilibili y WeChat con EveryInfra: 6 llamadas cobradas sumaron 0,028557 USD. Cada fila de Xiaohongshu, Douyin y Bilibili trajo likes, comentarios y fecha de publicación, y los artículos de WeChat pueden dar lecturas con una segunda llamada. SearchPro no devuelve ninguna de esas cifras, así que un agente que ya usa Yuanbao necesita además una API de datos de dentro de las apps. EveryInfra no tiene ningún acuerdo con Tencent: son dos servicios independientes.

Este artículo es para equipos de España y América Latina que venden en China o que estudian al consumidor chino con agentes de IA: una marca de vino que quiere saber qué dicen de ella en Xiaohongshu, una cadena de moda que prepara su campaña de invierno, una agencia que hace informes de mercado. La pregunta típica es «¿de qué se quejan los compradores chinos de los plumíferos este invierno?». Para esa pregunta, un buscador occidental sirve de poco, porque dos de las grandes apps chinas cierran el paso a casi todos los rastreadores extranjeros, y en las otras dos un buscador devuelve otros vídeos distintos de los que la app pone arriba, y sin cifras. La nueva API de búsqueda de Tencent sí cubre bien la web pública china y las noticias del propio Tencent, pero no devuelve lo que pasa dentro de las apps.

Todo lo que contamos de Yuanbao Search sale de la documentación en chino de cloud.tencent.com y de la prensa publicada entre el 2026-10-20 y el 2026-10-22, y damos la fecha en que leímos cada dato. No abrimos una cuenta de Tencent Cloud, así que cada petición y cada configuración de Yuanbao que aparece aquí es un ejemplo de configuración que no ejecutamos. Cada cifra de EveryInfra viene de respuestas reales del 2026-11-06. Nuestro artículo anterior, DeepSeek Search API y datos de dentro de las apps chinas, trata otra API de búsqueda y otras apps; más abajo explicamos las diferencias.

Primero los datos: una búsqueda en cuatro apps chinas

Empezamos por lo que una marca necesita ver, y después explicamos qué parte puede cubrir Yuanbao. Casi toda la conversación de consumo en China ocurre dentro de cuatro apps. Xiaohongshu (RedNote) es una app de notas con fotos o vídeos cortos donde la gente recomienda y critica productos. Douyin es la versión china de TikTok. Bilibili es una web de vídeos largos con comentarios que pasan por encima del vídeo. Las cuentas oficiales de WeChat publican artículos largos dentro de WeChat.

Todas las llamadas fueron a POST /api/v1/social entre las 00:17 y las 00:20, hora de Singapur, del 2026-11-06. La búsqueda fue la frase china que significa «reseña de plumífero». Dos llamadas chocaron con el límite de esta clave de prueba, 10 llamadas por minuto, y devolvieron 429, sin cobro. Una llamada a Xiaohongshu ordenada por más likes en los últimos 30 días devolvió 0 filas y el sistema devolvió la reserva. Una llamada a Douyin llevaba a propósito un valor de orden incorrecto y devolvió 422. Las 6 llamadas cobradas sumaron 0,028557 USD.

Douyin devolvió 10 vídeos para «más likes, última semana». Los likes iban de 1507 a 17 048, con una mediana de 4896,5, y los 10 vídeos sumaban 4501 comentarios. El primero tenía 17 048 likes, 853 comentarios, 6699 guardados y 3674 compartidos. El segundo hablaba de la marca Bosideng y tenía 15 377 likes y 15 860 compartidos, es decir, más veces compartido que gustado. Los seguidores de los autores iban de 137 a 464 930. La cuenta con 137 seguidores tenía 8217 likes y 1433 comentarios, así que un filtro por seguidores habría dejado fuera un vídeo viral.

Xiaohongshu devolvió 19 notas en vídeo publicadas entre el 2026-11-02 y el 2026-11-05. La nota mediana tenía 9 likes. La primera tenía 334 likes, 14 comentarios y 101 guardados, y 6 de las 19 notas aún no tenían comentarios. Al ordenar por «más recientes» llegan publicaciones de hace pocas horas, con cifras bajas. Esta vista responde a «qué marcas está probando la gente esta semana», no a «qué reseña es la más popular». La primera llamada, ordenada por más likes, devolvió 0 filas, y la respuesta daba empty_result_refunded como motivo.

Bilibili devolvió 20 vídeos en el orden por defecto, con reproducciones entre 0 y 1 695 719 y una mediana de 1047,5. Los 20 vídeos sumaban 3447 comentarios sobre la imagen, y 4 tenían más de un año. El primero era una comparativa de un creador de reseñas publicada el 2023-12-01, con 1 695 719 reproducciones, 44 806 likes y 3678 comentarios. Después pedimos sus comentarios destacados con bilibili/comments. Los 3 primeros tenían 3999, 1843 y 1831 likes, y el primero era un resumen de la prueba escrito por un espectador. Un buscador web encuentra la página del vídeo, pero no ordena los comentarios que hay debajo.

Las cuentas oficiales de WeChat devolvieron 36 artículos de 25 cuentas. Para uno de ellos pedimos las métricas con wechat_oa/article_metrics: una reseña de 14 plumíferos que la cuenta de pruebas de consumo Laoba Pingce publicó el 2025-11-19. La llamada devolvió read_count 100001, like_count 2763, watching_count 1455 (el botón «wow» de WeChat), share_count 7763, collect_count 932 y comment_count 94. WeChat muestra «100 000+» en los artículos populares, así que 100001 seguramente representa esa marca y es un mínimo. No encontramos documentación que lo diga; en una respuesta, escribe «más de 100 000 lecturas».

Antigüedad de los resultados de dentro de las apps

Las preguntas de producto dependen del momento. Una reseña del invierno pasado dice menos que una queja de esta semana. Medimos la antigüedad de cada fila en el momento de la llamada, 2026-11-05T16:19:30Z, en cuatro tramos: menos de 1 día, de 1 a 7 días, de 7 a 30 días y más de 30 días. Las 19 notas de Xiaohongshu tenían menos de 7 días, 12 de ellas menos de 1 día, con una mediana de 0,47 días. Los 10 vídeos de Douyin tenían menos de 7 días porque enviamos publish_time=one_week, con una mediana de 2,56 días.

Las otras dos apps mezclan contenido nuevo y viejo. El orden por defecto de Bilibili dio 13 vídeos de menos de 7 días y 6 de más de 30 días, y el más antiguo es del 2021-01-22. WeChat dio 24 artículos de los últimos 30 días y 12 más antiguos, el más viejo del 2024-12-18. Un agente debe filtrar estas filas por posted_at antes de pasarlas al modelo; si no lo hace, el modelo puede presentar una prueba de 2021 como la opinión de este año.

Yuanbao también tiene un filtro de tiempo, Freshness, que limita los resultados web a los últimos N días. Hace un trabajo parecido al de date_range y publish_time en las apps, con una diferencia: el date de Yuanbao es la fecha de publicación de una página web, mientras que posted_at es la fecha en que se subió la nota o el vídeo. Las dos fechas pueden no coincidir en reediciones y páginas agregadoras, así que conviene indicar de dónde sale cada fecha.

Por qué un buscador occidental casi no ve estas apps

Cada app decide qué rastreadores pueden leer sus páginas y lo escribe en su archivo robots.txt. Leímos los cuatro archivos a las 00:23, hora de Singapur, del 2026-11-06. El robots.txt de Xiaohongshu da a Googlebot Disallow: /, y el grupo general también es Disallow: /; en cambio, deja entrar a los rastreadores web y móvil de Sogou en /explore y en los mapas del sitio de las notas, y Sogou pertenece a Tencent. El robots.txt de WeChat solo permite unas pocas rutas, y la de los artículos no está entre ellas. Los de Douyin y Bilibili bloquean muy pocas rutas, así que sus páginas de vídeo están abiertas.

Que las reglas estén abiertas no dice qué vídeos devuelve un buscador web, así que lo medimos. No teníamos clave de Yuanbao, de modo que la sonda usa un buscador web público (Google, con región China e idioma chino), no Yuanbao. Para cada fila de nuestras llamadas buscamos los primeros 18 caracteres del título entre comillas, más site: con el dominio de la app. Contamos un acierto cuando el mismo identificador de nota o vídeo aparece entre los 10 primeros enlaces. Antes probamos el método con 6 páginas de Douyin y Bilibili que sabíamos indexadas, y las encontró todas. Un primer método que buscaba solo el identificador encontró 0 de esas 6, así que lo descartamos y no usamos sus resultados.

La sonda encontró 0 de 19 notas de Xiaohongshu, 0 de 10 vídeos de Douyin, 4 de 20 vídeos de Bilibili y 0 de 36 artículos de WeChat; el grupo de control, 6 de 6. Los ceros de Xiaohongshu y WeChat se explican por el robots.txt, que es una petición a los rastreadores y no un control de acceso (su formato está en el RFC 9309). A la vez buscamos el tema con site: en el mismo buscador: para Xiaohongshu y WeChat devolvió 0 resultados, con o sin el límite de una semana.

Los ceros de Douyin y Bilibili no significan que los vídeos nuevos se indexen tarde; nuestros propios datos de control lo descartan. Los dos sitios dejan leer sus páginas de vídeo. Limitado a la última semana, el mismo buscador devolvió 10 vídeos de Bilibili sobre el tema, todos reseñas de plumíferos, marcados entre «hace 12 horas» y «hace 6 días», y 9 vídeos de Douyin marcados entre «hace 1 día» y «hace 6 días», aunque solo 1 título trataba de plumíferos. El grupo de control también tenía vídeos nuevos, uno de Douyin de «hace 1 día» y uno de Bilibili de «hace 6 días», y la sonda encontró los dos por título. Los datos solo muestran una cosa: las filas que las apps devolvieron por «más likes» o por orden por defecto no estaban entre los 10 primeros resultados web. En Bilibili, los 4 aciertos tenían 16,1, 1070,6, 1386,1 y 2113,4 días, y no apareció ninguno de los 13 vídeos de los últimos 7 días: eso apunta a otro orden, no a una indexación lenta. Para un agente quedan dos ideas firmes. No controlas qué vídeos devuelve un buscador web, y no coinciden con el orden «más likes» o «más recientes» de la app. Y los que devuelve no traen likes, comentarios ni guardados.

Este resultado no es una prueba de Yuanbao. Yuanbao usa otro índice y Tencent dice que se actualiza en minutos (descripción del producto); qué páginas de las apps guarda y en qué orden las pone puede ser distinto de Google. Como Xiaohongshu deja entrar al rastreador de Sogou, Yuanbao puede tener algunas páginas de notas; no pudimos medir cuántas. Hay dos cosas seguras: incluso una página indexada vuelve sin likes ni comentarios, y Tencent excluye por escrito las cuentas oficiales de WeChat.

Qué es Yuanbao Search API, según la documentación leída el 2026-11-06

Yuanbao Search es el nombre del producto; en la API de Tencent Cloud se llama wsa. Según la página de novedades, nació el 2025-07-01 como «API de búsqueda web», sumó una edición ligera el 2026-01-21 y una edición Flagship el 2026-05-29, y se rebautizó como Yuanbao Search el 2026-10-09. Lo del 2026-10-20 fue abrir a usuarios externos un servicio que Tencent ya usaba por dentro. Phoenix Tech informó el 2026-10-20 de que su índice tiene cientos de miles de millones de páginas, recibe cientos de millones de llamadas al día y da servicio a más de 50 productos de Tencent, entre ellos WorkBuddy, ima, Tencent Financial Technology y Tencent Video. Según el mismo medio, conecta 157 fuentes fiables de 13 sectores como finanzas, salud, derecho y viajes.

Hay cosas que la documentación no dice, y no las rellenamos. La página de facturación dice que las llamadas fallidas no se cobran, pero no aclara si una llamada con 0 resultados cuenta como correcta. Ni la facturación ni los reembolsos mencionan la cuota gratis; la página del servidor MCP remite a una página de «actividades» de la consola. Las cifras de 2000 y 6000 salen de la prensa. La descripción del producto cita tres fuentes de Tencent y no dice nada de Xiaohongshu, Douyin ni Bilibili. Y la facturación solo usa la unidad «por 1000 llamadas», sin decir si 50 resultados cuestan más que 10.

Alta, cuota gratis y precios en dólares

La guía de la clave de API describe cuatro pasos: registrar una cuenta de Tencent Cloud y pasar la verificación de identidad real, personal o de empresa; activar el servicio en la consola de Yuanbao Search; crear una clave de API; y enviar peticiones al punto final de SearchPro. Toda la documentación que leímos está en el sitio en chino, y no probamos el alta desde fuera de China continental. La misma guía pone dos límites: cada cuenta o subcuenta puede tener como mucho 3 claves a la vez, y la clave en texto claro solo se muestra al crearla. Las preguntas frecuentes añaden que una cuenta con deuda no puede activar el servicio.

La cuota gratis pide cuidado. MyDrivers publicó a las 15:55 del 2026-10-20 que cada mes incluye 2000 llamadas gratis, y otra nota de MyDrivers a las 18:15 del mismo día la llama oferta por tiempo limitado, sin fecha de fin. Una nota de Eastmoney del 2026-10-22 dice que un código de invitación la sube a 6000 al mes en octubre y noviembre. La documentación de Tencent no dice si las tres vías comparten la cuota; una columna de Zhihu dice que sí. Úsala para pruebas, no la metas en el presupuesto a largo plazo.

Para comparar con EveryInfra en dólares usamos el tipo central del 2026-11-05 que publica la Administración Estatal de Divisas: 6,7156 yuanes por dólar. Todas las cifras en dólares de Yuanbao son aproximadas.

Las reglas de reembolso son breves: la parte no usada de un paquete se reembolsa dentro de su año, menos los cupones, y el pago por uso es definitivo. Para un agente, lo sensato es empezar con la cuota gratis y el pago por uso, medir el volumen mensual y comprar un paquete solo cuando el volumen sea estable. El paquete de 1 millón sale un 7,5 % más barato por llamada que el pago por uso.

Qué devuelve Yuanbao Search API: campos web, sin interacción

SearchPro pone los resultados en una lista Pages. Cada elemento es una cadena JSON, así que el cliente tiene que analizarla una segunda vez (referencia de SearchPro). Las ediciones devuelven campos distintos. El campo de imágenes se llama pics en la referencia y images en el ejemplo de la guía de la clave; vimos los dos nombres, así que revisa una respuesta real antes de mapearlo.

En la petición, Query es obligatorio y admite hasta 1500 bytes UTF-8. Mode vale 0 para páginas web, 1 para tarjetas verticales fiables como el tiempo, el oro o la bolsa, y 2 para ambas. Site admite un dominio o excluir hasta 5 con exclude:. Cnt vale 10, 20, 30, 40 o 50, e Industry vale gov, news, acad o finance. Freshness acepta los últimos N días, meses o años, una fecha o un rango. Lite no acepta Mode, Cnt ni Industry. Estas opciones sirven para buscar contexto, como noticias de la última semana o el comunicado de una marca en su web, pero no responden a «cuánta gente dio like a esta reseña».

El gráfico siguiente pone la lista de campos de Yuanbao al lado de nuestras filas reales. La columna de Yuanbao tiene la fecha de publicación y nada más de nuestra lista. Las columnas de Xiaohongshu, Douyin y Bilibili tienen likes, comentarios, guardados y fecha en todas las filas. Los nombres de campo de EveryInfra salen de response_fields en cada catálogo: el catálogo de Xiaohongshu trae like_count, collect_count, comment_count, share_count, posted_at e is_cooperation_note para notas patrocinadas; el de Douyin añade author_follower_count, view_count e is_ad; y el de Bilibili tiene view_count, danmaku_count para los comentarios sobre la imagen, favorite_count y coin_count.

Dos celdas merecen una nota. El share_count de Xiaohongshu vino vacío en las 19 filas y los compartidos de Bilibili también, así que no uses los compartidos como métrica común de las tres apps. El view_count de Douyin vino vacío en las 10 filas; las reproducciones de Douyin hay que pedirlas con otra llamada. Las marcas de patrocinio y de cuenta verificada vinieron todas en false y la marca de anuncio de Douyin vino vacía. Con una sola búsqueda no sabemos si son valores reales o valores por defecto, así que no las usamos para filtrar anuncios.

El hueco de WeChat: la fuente que Yuanbao descarta

Las preguntas frecuentes de Yuanbao tienen una pregunta directa: ¿incluye el contenido de las cuentas oficiales de WeChat? La respuesta es que no, «por derechos de autor del contenido» (preguntas frecuentes). Es la única fuente que la documentación excluye por su nombre. Para un estudio de producto, WeChat es donde se publican muchas reseñas largas, y aquí es donde una marca extranjera suele encontrar las comparativas que leen los compradores antes de decidir.

Dos capacidades de EveryInfra cubren ese hueco. wechat_oa/article_search busca artículos por palabra clave y devuelve título, resumen, enlace, nombre de la cuenta y fecha; nos devolvió 36 artículos en una llamada por 0,008 USD. wechat_oa/article_metrics recibe el enlace de un artículo y devuelve lecturas, likes, «wow», compartidos, guardados y comentarios, por 0,005556 USD el artículo. La visión general de la plataforma está en la página de la API de cuentas oficiales de WeChat.

El artículo de Laoba Pingce tenía 7763 compartidos y solo 2763 likes, igual que el vídeo de Bosideng en Douyin, que se compartió más de lo que gustó. Las reseñas circulan más por reenvío que por likes. Un agente que ordene las reseñas solo por likes infravalora este tipo de contenido; si suma compartidos y guardados, el orden se parece más a lo que hacen los lectores.

El servidor MCP de Yuanbao junto al de EveryInfra en un mismo agente (ejemplo de configuración)

Los dos servicios son servidores MCP remotos. Los dos usan Streamable HTTP y leen un token Bearer de la cabecera Authorization. El de Yuanbao tiene una sola herramienta, SearchPro (página del servidor MCP de Yuanbao). El de EveryInfra devolvió 12 herramientas en tools/list a las 00:24, hora de Singapur, del 2026-11-06; las tres principales son everyinfra_list_capabilities, una lista gratuita de apps y capacidades, everyinfra_call_api, que ejecuta una capacidad, y everyinfra_get_job, que lee un resultado asíncrono.

El transporte está definido en la sección Transports de la especificación MCP 2025-06-18. El cliente envía primero initialize para acordar la versión del protocolo (Lifecycle) y después usa tools/list y tools/call (Tools). Si llamas al punto final MCP desde un script propio, envía la cabecera MCP-Protocol-Version en cada petición posterior a initialize; es una regla que añadió la versión 2025-06-18 (cambios de 2025-06-18). Claude Code, Cursor y casi todos los clientes la añaden solos.

El bloque siguiente es un archivo .mcp.json para la raíz de un proyecto de Claude Code. Pone los dos servidores lado a lado y lee las dos claves de variables de entorno. El ejemplo de Tencent usa "type": "streamableHttp". La documentación de MCP de Claude Code, actualizada el 2026-11-02, dice que type acepta http, con streamable-http como alias; la forma con mayúscula intermedia no está en esa lista, así que en Claude Code usa http. En Cursor y otros clientes, sigue la documentación del propio cliente.

{
  "mcpServers": {
    "yuanbao-websearch-mcp": {
      "type": "http",
      "url": "https://api.wsa.cloud.tencent.com/Mcp",
      "headers": {
        "Authorization": "Bearer ${WSA_API_KEY}"
      }
    },
    "everyinfra": {
      "type": "http",
      "url": "https://api.everyinfra.com/mcp",
      "headers": {
        "Authorization": "Bearer ${EVERYINFRA_API_KEY}"
      }
    }
  }
}

Al conectar, ejecuta tools/list una vez y lee el esquema de entrada de SearchPro. La página MCP de Tencent no es coherente: su tabla de parámetros lista Query, Site, Mode, Freshness, Cnt e Industry, pero la definición de la herramienta incrustada en la misma página usa FromTime y ToTime como marcas de tiempo Unix en lugar de Freshness, y declara Mode como texto. La única respuesta fiable es tu propio tools/list. MCP Inspector muestra las herramientas de los dos servidores sin escribir código. Los dos servidores usan una clave Bearer fija, no el flujo OAuth de la especificación MCP; el formato de la cabecera viene del RFC 6750.

Yuanbao Search también se distribuye como Skill en la página de SkillHub de Yuanbao Search. Antes de cada ejecución, la Skill comprueba la variable de entorno TENCENTCLOUD_WSA_APIKEY y luego ejecuta scripts/websearch.py con un valor --query y, si quieres, un valor --site. La Skill y el servidor MCP llaman a la misma API SearchPro con la misma clave; usa la Skill en herramientas que cargan Skills y el servidor MCP en clientes que cargan servidores MCP.

Con los dos servidores conectados, el agente necesita una regla de reparto en su prompt de sistema. Reparte según lo que pide la pregunta, no según el nombre de la app. Yuanbao responde a «qué es y dónde está la fuente»; las llamadas a las apps responden a «cuánta gente lo dice, qué dice y desde cuándo».

El paso de búsqueda web no tiene por qué ser Yuanbao. EveryInfra también tiene una capacidad de búsqueda web, web/search. Su precio en el catálogo es 0,001389 USD por llamada, es decir, 1,389 USD por cada 1000 (leído el 2026-11-06). La página de facturación de Tencent pone Yuanbao Standard a 20 yuanes por cada 1000 llamadas, unos 2,978 USD con el tipo central del 2026-11-05 (6,7156 yuanes por dólar), y Lite a 14 yuanes, unos 2,085 USD. Cada uno sirve para algo distinto. Yuanbao mezcla Tencent News, Sogou Baike y las cuentas Penguin, tiene filtros Industry y tarjetas en vivo con Mode=1, devuelve hasta 50 filas por llamada en Standard y tiene una cuota gratis limitada: encaja con noticias, enciclopedias y textos oficiales en chino. web/search devuelve hasta 10 filas por llamada con título, enlace, resumen, posición y fecha, admite country y language, y comparte clave, factura y servidor MCP con las capacidades de dentro de las apps: encaja con equipos que no quieren abrir una cuenta de Tencent Cloud o con preguntas que van más allá de la web china. En esta prueba no llamamos a web/search, así que sus campos y su precio salen del catálogo.

Sin MCP: dos peticiones con curl

También puedes llamar a los dos servicios por HTTP. El modo con clave de Yuanbao solo necesita una cabecera Bearer, sin la firma de Tencent Cloud API 3.0 (guía de la clave). Para el modo con firma, los SDK de Tencent Cloud traen un paquete wsa: empieza por el cliente de Python y su models.py. Los demás lenguajes están en el repositorio SDK de TencentCloud correspondiente, bajo una ruta wsa/v20250508, por ejemplo Go y Node.js.

La primera petición es un ejemplo de configuración de Yuanbao que no ejecutamos. La segunda es la que enviamos a las 00:19:14, hora de Singapur. La búsqueda china va escrita como secuencias de escape JSON, para que puedas pegarla en cualquier terminal; el servidor las lee como texto chino normal.

# Ejemplo de configuración, no ejecutado: Yuanbao Standard, últimos 7 días, 20 resultados
curl -s https://api.wsa.cloud.tencent.com/SearchPro \
  -H "Authorization: Bearer $WSA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"Query":"羽绒服 测评","Freshness":"d7","Cnt":20}'
# Cada elemento de Pages es una cadena JSON: hay que analizarla otra vez

# Petición real: búsqueda de Douyin en EveryInfra, más likes, última semana
curl -s https://api.everyinfra.com/api/v1/social \
  -H "Authorization: Bearer $EVERYINFRA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"platform":"douyin","action":"search","params":{"keyword":"羽绒服 测评","sort":"most_liked","publish_time":"one_week"}}'
# Devuelve count, results[] (like_count, comment_count, collect_count, share_count, posted_at) y billing.charged_usd

La respuesta de EveryInfra es un objeto JSON normal. results es una lista y cada fila tiene los campos de response_fields del catálogo. billing.charged_usd es lo que se cobró en esa llamada. pagination.has_more indica si hay otra página, y para pedirla devuelves next_page_token como page_token. Para llamadas lentas, añade "mode":"async" al cuerpo: recibes un 202 y un job_id al momento, y consultas /api/v1/jobs/{job_id}. Una llamada síncrona tiene 85 segundos. El catálogo se lee gratis.

Errores y cobro en cada lado

Los agentes reintentan, así que conviene conocer las reglas de cobro antes de conectar uno. La facturación de Yuanbao dice que las llamadas fallidas no se cobran, y la referencia lista seis códigos de error. InternalError e InvalidParameter son generales. RequestLimitExceeded indica demasiadas peticiones. ResourceNotFound indica que el servicio no está activado, y la página MCP dice que la activación tarda unos minutos. ResourceUnavailable suele indicar deuda en la cuenta, y UnauthorizedOperation, una clave errónea o borrada. EveryInfra no deja cobro en una llamada fallida o vacía, y para una llamada con un parámetro mal escrito antes de cobrar nada.

Nuestra llamada de prueba de las 00:19:57, hora de Singapur, envió sort=hot a propósito. El error decía que sort debe ser most_liked, newest o relevance, y did_you_mean proponía most_liked. La primera línea de next_steps pedía cambiar solo sort, reenviar, y aclaraba que no se había cobrado nada. Un modelo puede leer ese mensaje y corregir la llamada solo. El código 429 está definido en el RFC 6585, y lo correcto es esperar, no reintentar enseguida; nuestros dos 429 llegaron en las llamadas a Xiaohongshu y Douyin, con retry_after de 8 y 1 segundos y el motivo key_limit, el límite propio de esta clave de prueba. Haz que tu lógica de reintento espere lo que diga retry_after y luego reenvíe; nosotros reenviamos las dos unos 74 segundos después y ambas devolvieron resultados. Las reglas generales de los códigos de estado están en el RFC 9110.

Coste por cada 1000 preguntas

Por cada 1000 llamadas, Yuanbao Standard cuesta unos 2,978 USD. web/search de EveryInfra cuesta 1,389 USD; bilibili/search cuesta 0,556 USD, menos que Yuanbao. xiaohongshu/search cuesta 5,556 USD, unas 1,9 veces Yuanbao Standard; wechat_oa/article_search cuesta 8,0 USD y douyin/search, 8,333 USD, unas 2,8 veces. Por cada 1000 filas el orden cambia: Xiaohongshu dio 19 filas por llamada, unos 0,2924 USD por 1000 filas; Douyin dio 10, unos 0,8333 USD; Bilibili dio 20, unos 0,0278 USD; y WeChat dio 36, unos 0,2222 USD. Cada precio está en la página de precios y en las páginas de cada capacidad, como la búsqueda de Xiaohongshu, la de Douyin y la de Bilibili.

Ahora la combinación. Calculamos tres planes por cada 1000 preguntas. El plan A usa Yuanbao Standard una vez por pregunta: 2,978 USD. El plan B llama a Yuanbao y a las cuatro apps en cada pregunta: 25,423 USD. El plan C llama a Yuanbao y a Bilibili en cada pregunta, a Xiaohongshu en el 40 % y a Douyin y WeChat en el 20 % cada uno: 9,023 USD. El 40 % y el 20 % son supuestos nuestros, no valores medidos; tu reparto real depende de cuántas preguntas sean del tipo «qué dice la gente».

Con 3000 preguntas al mes en el plan C, 2000 llamadas a Yuanbao entran en la cuota gratis y las otras 1000 cuestan unos 2,978 USD. Las llamadas a las apps cuestan 3 veces 6,045 USD, es decir, 18,135 USD, y el total ronda los 21,113 USD. La cuota gratis es temporal: sin ella, las 3000 llamadas a Yuanbao cuestan unos 8,934 USD y el total sube a unos 27,069 USD; con web/search como paso web, 3000 llamadas cuestan 4,167 USD y el total queda en unos 22,302 USD. Mientras dura la cuota gratis, casi todo el coste está del lado de las apps. El mayor ahorro está en llamar a las dos capacidades más caras, la búsqueda de Douyin y la de WeChat, solo cuando la pregunta lo pide; la de Bilibili es tan barata que se puede llamar siempre.

Cómo citar el origen de cada dato en la respuesta

Cuando los resultados web y los datos de las apps comparten una respuesta, el lector tiene que ver qué frase viene de las noticias y cuál de los usuarios. Montamos un ejemplo de formato con nuestras filas reales; la parte de Yuanbao no se ejecutó, así que solo muestra un hueco. El primer párrafo da contexto, por ejemplo cambios en las normas o los precios de los plumíferos, y cita los resultados web de Yuanbao con el nombre del sitio y el date de cada línea.

El segundo párrafo da la voz de los usuarios. Entre los 10 vídeos de Douyin con más likes de la última semana, uno sobre la calidad de Bosideng tenía 15 377 likes y 15 860 compartidos. La comparativa más vista de Bilibili tenía 1 695 719 reproducciones y su comentario destacado, 3999 likes. Cada línea indica la app, la fecha de publicación y el momento en que leímos el dato. El tercer párrafo recoge las reseñas largas, como el artículo de Laoba Pingce del 2025-11-19, con más de 100 000 lecturas y 1455 «wow». La última línea dice «datos de las apps a las 00:20, hora de Singapur, del 2026-11-06», porque las cifras cambian en la siguiente llamada.

Este formato tiene dos ventajas. Cada cifra lleva a una llamada concreta, así que un lector o un revisor puede abrir el enlace y comprobarla. Además, el modelo solo necesita título, enlace, unas pocas cifras y la fecha de cada fila, no la página entera, y la entrada queda corta. Los resúmenes passage y content de Yuanbao encajan en el párrafo de contexto, y las filas de las apps en los párrafos de pruebas. Con los huecos fijos, el modelo escribe respuestas con una estructura estable.

En qué se diferencia de nuestro artículo sobre DeepSeek Search

Nuestro artículo sobre DeepSeek Search API del 2026-11-03 parte del mismo punto: una API de búsqueda web no devuelve cifras de interacción. Se diferencian en tres cosas. La API de búsqueda: aquel trata DeepSeek Search y Fetch, abiertas el 2026-10-17 a 5 yuanes por cada 1000 peticiones correctas, y este trata Yuanbao Search, que suma Tencent News, Sogou Baike y las cuentas Penguin y excluye WeChat, por eso aquí WeChat tiene su propia sección. La integración: aquel escribe cuatro funciones y un bucle tool_calls, y este pone dos servidores MCP remotos lado a lado, sin código de reparto. Y las apps: aquel cubre Xiaohongshu, Zhihu y Weibo, sobre todo texto y preguntas; este cubre Xiaohongshu, Douyin, Bilibili y WeChat, con vídeo, reproducciones, comentarios sobre la imagen, compartidos y seguidores.

Si tu agente funciona con un modelo de DeepSeek y quieres controlar cada paso, usa el patrón de funciones del artículo de DeepSeek. Si usas Claude Code, Cursor u otro cliente MCP, usa la configuración de este. También puedes conectar las dos API de búsqueda y repartir según precio y fuente de contenido.

Límites y avisos

No llamamos a Yuanbao Search. Todo lo que contamos de ella viene de su documentación y de la prensa, y cada petición y configuración de Yuanbao aquí es un ejemplo de configuración. La documentación tiene pequeñas contradicciones: la tabla de la página MCP y su esquema incrustado no coinciden en el filtro de tiempo, y el campo de imágenes se llama images en un ejemplo y pics en la referencia. La prensa da dos tasas de recuperación distintas, 94 % en MyDrivers y 93 % en Eastmoney. La cuota gratis es una oferta limitada que sale de la prensa, no de la página de facturación; vuelve a comprobarla después de noviembre.

Del lado de EveryInfra, hicimos una sola búsqueda. La cobertura de campos y la frescura son una foto de un momento, no una regla para todos los temas. Las marcas de patrocinio y de verificación vinieron todas en false y la de anuncio de Douyin vino vacía, así que no muestran la proporción real de anuncios. Las 100001 lecturas de WeChat son seguramente un mínimo. La búsqueda de Douyin no devolvió reproducciones. Las cifras de las apps cambian entre llamadas, así que cada respuesta debe decir cuándo se leyeron los datos.

En cumplimiento normativo, sigue las reglas del lugar donde operas y donde están tus usuarios. En China continental, el Reglamento de gestión de la seguridad de los datos de red está en vigor desde el 2025-01-01. Un servicio público de IA generativa en China continental debe cumplir además las Medidas provisionales para servicios de IA generativa y las Medidas de etiquetado del contenido generado por IA, en vigor desde el 2025-09-01. Si una respuesta cita comentarios de usuarios, oculta los apodos personales y deja solo los nombres de marcas e instituciones. Si tu equipo trata datos personales de residentes en la Unión Europea, revisa también tus obligaciones allí con tu asesor legal.

Cada app tiene además una plataforma abierta, pero para otros fines. La plataforma abierta de Xiaohongshu atiende a tiendas y herramientas de comercio electrónico; la de Douyin, a apps y webs que conectan cuentas de Douyin; la de Bilibili, a creadores y proveedores de servicios; y la documentación para desarrolladores de WeChat cubre la cuenta oficial que tú gestionas. Ninguna ofrece búsqueda por palabra clave en todas las notas y vídeos públicos. Para comparar las plataformas oficiales con las API de terceros, lee nuestra comparativa de la API de Xiaohongshu.

Cambios recientes

2026-10-09: la «API de búsqueda web» pasó a llamarse Yuanbao Search (novedades del producto). Para ti significa que las guías antiguas y los paquetes de los SDK siguen usando el nombre wsa para el mismo servicio.

2026-10-17: DeepSeek abrió sus API Search y Fetch a 5 yuanes por cada 1000 peticiones correctas (noticias de DeepSeek, guía de búsqueda de DeepSeek). Para ti significa que ya hay dos API chinas de búsqueda web con pago por llamada; Yuanbao Standard cuesta 4 veces más por llamada, pero tiene cuota gratis y contenido de Tencent.

2026-10-20: Tencent abrió Yuanbao Search a desarrolladores externos con 2000 llamadas gratis al mes (MyDrivers). Para ti significa que dar búsqueda web china a un agente ya solo requiere una clave, y la cuota gratis alcanza para una primera prueba.

2026-10-27: Tencent actualizó la referencia de SearchPro, incluida la sintaxis de Freshness (referencia de SearchPro). Para ti significa que el filtro de tiempo todavía cambia, así que fíate de tu propio tools/list.

2026-11-02: se actualizó la documentación de MCP de Claude Code, que dice que streamable-http es un alias de http (documentación de Claude Code). Para ti significa que debes revisar cómo se escribe type cuando copias la configuración de un proveedor.

2026-11-04: Tencent actualizó su página de acceso para herramientas de IA, que lista MCP, Skill y un servidor MCP propio compilado desde el código fuente (acceso para herramientas de IA). Para ti significa que un equipo que no quiera enviar tráfico a un punto final MCP remoto puede montar su propio servidor.

Otros proveedores van en la misma dirección. Kimi y Zhipu documentan herramientas de búsqueda web en sus plataformas para desarrolladores, y la herramienta de búsqueda web de Anthropic cuesta 10 USD por cada 1000 búsquedas. La búsqueda web se está volviendo una pieza estándar de las plataformas de modelos; los datos de dentro de las apps siguen necesitando su propia conexión.

Preguntas frecuentes

¿Yuanbao Search API es gratis y cuántas llamadas incluye?

Hay una cuota gratis limitada. La prensa del 2026-10-20 habla de 2000 llamadas al mes, compartidas entre Skill, MCP y API, y de hasta 6000 al mes con código de invitación en octubre y noviembre. La página de facturación de Tencent no menciona la cuota. Después, el pago por uso cuesta 14, 20 o 26 yuanes por cada 1000 llamadas. (Origen de la pregunta: sugerencias de búsqueda «yuanbao search free» y «tencent yuanbao api». Base: MyDrivers, Eastmoney, facturación.)

¿Cómo añado el servidor MCP de Yuanbao a Claude Code o Cursor?

El punto final es api.wsa.cloud.tencent.com/Mcp por HTTPS, con tu clave de Yuanbao en una cabecera Authorization: Bearer. Cursor y clientes parecidos pueden usar el ejemplo de Tencent. En Claude Code, pon type en http, porque el valor del ejemplo no está en la lista de Claude Code. Ejecuta tools/list al conectar. (Origen de la pregunta: sugerencia de búsqueda «tencent yuanbao mcp». Base: página del servidor MCP de Yuanbao, documentación de Claude Code.)

¿Puedo usar Yuanbao Search API desde España o América Latina?

La documentación que leímos solo está en el sitio en chino de Tencent Cloud, y el alta pide verificación de identidad real, personal o de empresa. No probamos el alta desde fuera de China continental, así que no podemos confirmarlo. La API en sí es HTTPS normal con una clave Bearer. (Origen de la pregunta: sugerencia de búsqueda «tencent yuanbao api». Base: guía de la clave de API.)

¿Cuántas notas de Xiaohongshu devuelve una llamada a la API?

xiaohongshu/search devuelve páginas de 20 filas y usa page_token para la siguiente. Cada llamada cuesta 0,005556 USD. Nuestra llamada «más recientes, últimos 30 días» devolvió 19 notas, cada una con likes, comentarios, guardados y fecha. (Origen de la pregunta: sugerencia de búsqueda sobre el volumen de notas de la API de Xiaohongshu. Base: catálogo de Xiaohongshu.)

¿Hay alguna API gratuita de buscador chino?

Yuanbao Search tiene una cuota gratis limitada de 2000 llamadas al mes. DeepSeek Search cuesta 5 yuanes por cada 1000 peticiones correctas, y no vimos una cuota gratis aparte en su documentación. El catálogo de EveryInfra y el tools/list del servidor MCP se leen gratis; las llamadas se cobran una a una, y las fallidas o vacías no dejan cobro. (Origen de la pregunta: sugerencia de búsqueda «api de buscador gratis». Base: MyDrivers, guía de búsqueda de DeepSeek, catálogo de Bilibili.)

Cómo empezar

Primero, crea una clave de API en la guía rápida de EveryInfra. Lee el catálogo gratis y revisa los parámetros y precios de xiaohongshu/search, douyin/search, bilibili/search y bilibili/comments. Las páginas de la API de Xiaohongshu, la de Douyin y la de Bilibili dan la visión general, y la configuración MCP está en la página del servidor MCP.

Después, activa Yuanbao Search en Tencent Cloud y crea una clave. Guarda las dos claves en variables de entorno y copia el .mcp.json de arriba en la raíz de tu proyecto. Por último, añade la tabla de reparto a tu prompt de sistema, prueba con una pregunta y calcula el coste mensual con tu volumen de preguntas. Para ver una configuración parecida en otra herramienta de agentes, lee los conectores de WorkBuddy para Xiaohongshu, Douyin y JD.

Referencias

1. Descripción del producto Yuanbao Search (en chino), documentación de Tencent Cloud, actualizada el 2026-10-26, leída el 2026-11-06, https://cloud.tencent.com/document/product/1806/121794
2. Facturación de Yuanbao Search (en chino), documentación de Tencent Cloud, actualizada el 2026-10-09, leída el 2026-11-06, https://cloud.tencent.com/document/product/1806/121798
3. Reembolsos de Yuanbao Search (en chino), documentación de Tencent Cloud, actualizada el 2026-10-09, leída el 2026-11-06, https://cloud.tencent.com/document/product/1806/121801
4. Novedades de Yuanbao Search (en chino), documentación de Tencent Cloud, actualizada el 2026-10-09, leída el 2026-11-06, https://cloud.tencent.com/document/product/1806/121792
5. Preguntas frecuentes de Yuanbao Search (en chino), documentación de Tencent Cloud, actualizada el 2026-10-09, leída el 2026-11-06, https://cloud.tencent.com/document/product/1806/121804
6. Referencia de SearchPro (en chino), documentación de la API de Tencent Cloud, actualizada el 2026-10-27, leída el 2026-11-06, https://cloud.tencent.com/document/api/1806/121811
7. Guía de la clave de API de Yuanbao Search (en chino), documentación de Tencent Cloud, actualizada el 2026-10-09, leída el 2026-11-06, https://cloud.tencent.com/document/product/1806/130615
8. Acceso para herramientas de IA de Yuanbao Search (en chino), documentación de Tencent Cloud, actualizada el 2026-11-04, leída el 2026-11-06, https://cloud.tencent.com/document/product/1806/140541
9. Página del servidor MCP de Yuanbao (en chino), directorio MCP de Tencent Cloud, leída el 2026-11-06, https://cloud.tencent.com/developer/mcp/server/11764
10. Skill de Yuanbao Search (en chino), SkillHub, leída el 2026-11-06, https://skillhub.cn/skills/tencent-yuanbao-standard-search
11. tencentcloud-sdk-python wsa_client.py, TencentCloud en GitHub, leído el 2026-11-06, https://github.com/TencentCloud/tencentcloud-sdk-python/blob/master/tencentcloud/wsa/v20250508/wsa_client.py
12. tencentcloud-sdk-python wsa models.py, TencentCloud en GitHub, leído el 2026-11-06, https://github.com/TencentCloud/tencentcloud-sdk-python/blob/master/tencentcloud/wsa/v20250508/models.py
13. tencentcloud-sdk-go wsa client.go, TencentCloud en GitHub, leído el 2026-11-06, https://github.com/TencentCloud/tencentcloud-sdk-go/blob/master/tencentcloud/wsa/v20250508/client.go
14. tencentcloud-sdk-nodejs wsa_client.ts, TencentCloud en GitHub, leído el 2026-11-06, https://github.com/TencentCloud/tencentcloud-sdk-nodejs/blob/master/src/services/wsa/v20250508/wsa_client.ts
15. Tencent abre Yuanbao Search a usuarios externos con 2000 llamadas gratis al mes (en chino), MyDrivers, 2026-10-20, https://news.mydrivers.com/1/1158/1158971.htm
16. Tencent mejora Yuanbao Search y lo abre a través de Tencent Cloud (en chino), MyDrivers, 2026-10-20, https://news.mydrivers.com/1/1159/1159052.htm
17. Tencent Yuanbao Search se abre a usuarios externos (en chino), Phoenix Tech, 2026-10-20, https://tech.ifeng.com/c/8xNUpH50e2g
18. Tencent Cloud abre por completo la API de Yuanbao Search (en chino), Eastmoney Caifuhao, 2026-10-22, https://caifuhao.eastmoney.com/news/20261022114426222792250
19. Tencent Cloud anuncia Yuanbao Search para usuarios externos (en chino), columna de Zhihu, leída el 2026-11-06, https://zhuanlan.zhihu.com/p/2096309245318787504
20. Noticias de DeepSeek, versión del 2026-10-17 (en chino), documentación de la API de DeepSeek, leída el 2026-11-06, https://api-docs.deepseek.com/zh-cn/news/news261017
21. Guía de búsqueda y lectura web (en chino), documentación de la API de DeepSeek, leída el 2026-11-06, https://api-docs.deepseek.com/zh-cn/guides/search
22. robots.txt, Xiaohongshu, leído el 2026-11-06 a las 00:23 hora de Singapur, https://www.xiaohongshu.com/robots.txt
23. robots.txt, Douyin, leído el 2026-11-06 a las 00:23 hora de Singapur, https://www.douyin.com/robots.txt
24. robots.txt, Bilibili, leído el 2026-11-06 a las 00:23 hora de Singapur, https://www.bilibili.com/robots.txt
25. robots.txt, plataforma de cuentas oficiales de WeChat, leído el 2026-11-06 a las 00:23 hora de Singapur, https://mp.weixin.qq.com/robots.txt
26. Tipo central del renminbi (en chino), Administración Estatal de Divisas, datos del 2026-11-05, https://www.safe.gov.cn/safe/rmbhlzjj/index.html
27. Reglamento de gestión de la seguridad de los datos de red (en chino), portal del Gobierno chino, publicado el 2024-09-30, https://www.gov.cn/zhengce/content/202409/content_6977766.htm
28. Medidas provisionales para la gestión de servicios de IA generativa (en chino), Administración del Ciberespacio de China, 2023-07-13, https://www.cac.gov.cn/2023-07/13/c_1690898327029107.htm
29. Medidas de etiquetado del contenido sintético generado por IA (en chino), Administración del Ciberespacio de China, 2025-03-14, https://www.cac.gov.cn/2025-03/14/c_1743654684782215.htm
30. RFC 9309: Robots Exclusion Protocol, RFC Editor, 2022-09, https://www.rfc-editor.org/rfc/rfc9309.html
31. Transports (2025-06-18), especificación de Model Context Protocol, leída el 2026-11-06, https://modelcontextprotocol.io/specification/2025-06-18/basic/transports
32. Lifecycle (2025-06-18), especificación de Model Context Protocol, leída el 2026-11-06, https://modelcontextprotocol.io/specification/2025-06-18/basic/lifecycle
33. Tools (2025-06-18), especificación de Model Context Protocol, leída el 2026-11-06, https://modelcontextprotocol.io/specification/2025-06-18/server/tools
34. Authorization (2025-06-18), especificación de Model Context Protocol, leída el 2026-11-06, https://modelcontextprotocol.io/specification/2025-06-18/basic/authorization
35. Key Changes (2025-06-18), especificación de Model Context Protocol, leída el 2026-11-06, https://modelcontextprotocol.io/specification/2025-06-18/changelog
36. MCP Inspector, modelcontextprotocol en GitHub, leído el 2026-11-06, https://github.com/modelcontextprotocol/inspector
37. Connect Claude Code to tools via MCP, documentación de Claude Code, actualizada el 2026-11-02, https://code.claude.com/docs/en/mcp
38. Web search tool, documentación de Claude, leída el 2026-11-06, https://docs.claude.com/en/docs/agents-and-tools/tool-use/web-search-tool
39. Uso de la búsqueda web (en chino), documentación de la plataforma de Kimi, leída el 2026-11-06, https://platform.moonshot.cn/docs/guide/use-web-search
40. Herramienta de búsqueda web (en chino), documentación de la plataforma de Zhipu, leída el 2026-11-06, https://docs.bigmodel.cn/cn/guide/tools/web-search
41. Plataforma abierta de Xiaohongshu (en chino), Xiaohongshu, leída el 2026-11-06, https://open.xiaohongshu.com/
42. Plataforma abierta de Bilibili (en chino), Bilibili, leída el 2026-11-06, https://open.bilibili.com/
43. Descripción de la plataforma abierta de Douyin (en chino), plataforma abierta de Douyin, leída el 2026-11-06, https://developer.open-douyin.com/docs/resource/zh-CN/dop/overview/introduction
44. Documentación para desarrolladores de WeChat (en chino), WeChat, leída el 2026-11-06, https://developers.weixin.qq.com/doc/
45. RFC 6585: Additional HTTP Status Codes, RFC Editor, 2012-04, https://www.rfc-editor.org/rfc/rfc6585.html
46. RFC 6750: OAuth 2.0 Bearer Token Usage, RFC Editor, 2012-10, https://www.rfc-editor.org/rfc/rfc6750.html
47. RFC 9110: HTTP Semantics, RFC Editor, 2022-06, https://www.rfc-editor.org/rfc/rfc9110.html
48. Catálogo de capacidades de Xiaohongshu, API de EveryInfra, leído el 2026-11-06, https://api.everyinfra.com/api/v1/social/catalog?platform=xiaohongshu
49. Catálogo de capacidades de Douyin, API de EveryInfra, leído el 2026-11-06, https://api.everyinfra.com/api/v1/social/catalog?platform=douyin
50. Catálogo de capacidades de Bilibili, API de EveryInfra, leído el 2026-11-06, https://api.everyinfra.com/api/v1/social/catalog?platform=bilibili
51. Catálogo de capacidades de cuentas oficiales de WeChat, API de EveryInfra, leído el 2026-11-06, https://api.everyinfra.com/api/v1/social/catalog?platform=wechat_oa
52. Catálogo de la capacidad de búsqueda web, EveryInfra API, leído el 2026-11-06, https://api.everyinfra.com/api/v1/social/catalog?platform=web