Cómo añadir búsqueda web a Qwen Code: Integración Scrapeless MCP para agentes de terminal.

Resumen Clave:

• Qwen Code no tiene búsqueda web incorporada: MCP es cómo ve la web. La herramienta web_search incorporada fue eliminada en una versión temprana; la documentación oficial es explícita en que la búsqueda web se proporciona mediante la conexión a un servidor MCP. Dirija esa conexión a Scrapeless y el agente de terminal obtiene búsqueda en Google en vivo, renderizado de páginas y un navegador completo en la nube en un solo movimiento.
• Un bloque en ~/.qwen/settings.json lo conecta todo. Agregue una única entrada scrapeless al objeto mcpServers y el agente obtiene un raspador de SERP de Google, un raspador de Tendencias, ayudantes de HTML/Markdown/Captura de pantalla, y 16 herramientas de automatización de navegador — sin código SDK, sin servicio que alojar.
• El agente busca, renderiza y controla un navegador a partir de comandos simples. Pregunte en lenguaje natural para buscar en Google, leer una página rica en JavaScript como markdown limpio, o seguir un flujo de múltiples pasos, y Qwen Code compone las llamadas a las herramientas correctas turno a turno en lugar de estar limitado al conocimiento del corte de entrenamiento y archivos locales.
• Los proxies residenciales y la detección anti-sondeo se manejan del lado de la nube. Cada solicitud se enruta a través del navegador en la nube anti-detección de Scrapeless con proxies residenciales en más de 195 países, por lo que el agente obtiene una respuesta renderizada y utilizable en sitios comerciales sin necesidad de configuración de proxy o huella digital en su máquina.
• 21 herramientas en SERP, raspado sin estado y automatización de navegador. El servidor MCP de Scrapeless expone google_search, google_trends, scrape_html/scrape_markdown/scrape_screenshot, además de 16 herramientas browser_* — un espacio de nombres del que el planificador del agente extrae en cada turno.
• Transporte stdio o HTTP transmitible. Inicie el servidor localmente con npx, o dirija la misma configuración al punto final HTTP transmisible para contenedores de desarrollo remotos y ejecutores de CI.
• Gratis para comenzar. Las nuevas cuentas de Scrapeless incluyen un tiempo de ejecución de navegador de raspado gratuito: regístrese en Scrapeless.

Introducción: un agente de codificación en terminal que finalmente puede leer la web en vivo

Qwen Code es un agente de IA de código abierto que vive en su terminal, optimizado para la serie de modelos Qwen. Lee grandes bases de código, edita archivos, ejecuta comandos y automatiza las partes tediosas de un proyecto — todo sin salir de la consola. Lo que no puede hacer por sí solo es ver la web en vivo. Su conocimiento se detiene en el corte de entrenamiento del modelo y los archivos en disco.

Ese vacío es inusualmente explícito en Qwen Code. La herramienta incorporada web_search fue eliminada en una versión temprana, y la documentación oficial establece claramente que "la búsqueda web se proporciona al conectarse a servidores MCP externos" en lugar de una herramienta integrada. En otras palabras, el acceso a la web en tiempo real en Qwen Code no es una idea de último momento que se agrega: es el punto de extensión previsto. Hasta que conecte uno, el agente no puede extraer un SERP actual, leer la página de precios de un competidor, verificar el último registro de cambios o renderizar una aplicación solo de JavaScript.

Esta publicación cierra esa brecha al conectar el servidor MCP de Scrapeless a Qwen Code. Un bloque en ~/.qwen/settings.json proporciona al agente búsqueda en Google, renderizado de JavaScript y un navegador completo en la nube anti-detección, todo accesible a través de los mismos comandos en lenguaje natural que ya utiliza para el código. Para la misma superficie de Scrapeless a través de otros clientes MCP, consulte la guía de Google Antigravity y la integración de Pi Agent.

Lo Que Puedes Hacer Con Esto

• Investigación de SERP en vivo en la terminal. Pida al agente que ejecute google_search para una consulta y devuelva los mejores resultados como JSON, para que la investigación ocurra en la consola en lugar de en una pestaña de navegador separada.
• Instantáneas de competidores y precios. Introduzca una URL en el comando y haga que el agente renderice la página y extraiga nombres de planes, precios y características en un registro estructurado que puede colocar junto a su código.
• Consultas de documentos y registro de cambios que alimentan el código. Pida al agente que obtenga la documentación actual de una biblioteca o notas de lanzamiento como markdown limpio y escriba contra el texto renderizado en lugar de una memoria desactualizada de la API.
• Verificaciones de mercado y tendencias. Use google_trends para extraer señales de interés sobre un tema en una región objetivo, luego alimente esta evidencia en copias de características, planes de contenido o ideas de experimentos.
• Extracción de páginas de JavaScript en un registro tipado. Dirija al agente a una aplicación de página única; el navegador en la nube la hidrata y el agente analiza el resultado en un objeto tipado para el script que está construyendo.
• Flujos de navegador de múltiples pasos. Encadene browser_goto, browser_click, browser_type y browser_scroll para que el agente recorra la paginación, expanda paneles o pase por un asistente antes de extraer.
• Captura de pantalla para revisión. Use scrape_screenshot o browser_screenshot para grabar una página renderizada como una imagen que el agente puede guardar en el espacio de trabajo.
• Pipelines de búsqueda y lectura. Combina google_search con scrape_markdown para que el agente encuentre los mejores resultados, lea cada uno y los resuma en una única vuelta de terminal.

En Scrapeless, solo accedemos a datos públicamente disponibles mientras cumplimos estrictamente con las leyes, regulaciones y políticas de privacidad de los sitios web aplicables. El contenido de esta publicación es solo para fines de demostración.

Por qué el servidor MCP de Scrapeless

El servidor MCP de Scrapeless es un puente personalizable y anti-detección entre un agente de IA y la web en vivo. Para Qwen Code específicamente, trae:

• Un navegador en la nube anti-detección con representación de JavaScript. Las páginas se hidratan en un Navegador de Scraping de Scrapeless completo antes de la extracción, por lo que las SPA, feeds de desplazamiento infinito y paneles cargados de manera perezosa se convierten en objetivos de primera clase para browser_goto + browser_get_html.
• Proxies residenciales en más de 195 países. Las consultas geolocalizadas devuelven los listados que un usuario local vería, con la salida del proxy manejada completamente del lado de Scrapeless.
• Un comando de stdio a través de npx, sin código SDK. El servidor se inicia como un proceso hijo desde npx -y scrapeless-mcp-server; no hay nada que construir, hospedar o importar a tu proyecto.
• 21 herramientas que abarcan SERP, scraping sin estado y automatización completa del navegador. google_search y google_trends cubren datos SERP, scrape_html/scrape_markdown/scrape_screenshot cubren recuperaciones de página en un solo intento, y 16 herramientas browser_* cubren navegación con estado, clics, escritura, desplazamiento y capturas de pantalla.
• Un complemento al propio web_fetch de Qwen Code. Qwen Code ofrece un simple web_fetch para la recuperación de páginas simples, pero no renderiza JavaScript ni lleva consigo anti-detección. Las herramientas de Scrapeless llenan exactamente ese vacío: búsqueda que el agente nunca tuvo, además de acceso a páginas renderizadas y a través de proxies.

El plan gratuito es suficiente para configurar esto y ejecutar comandos reales; compara las cuotas en la página de precios cuando superes este límite. Obtén tu clave API en el plan gratuito en Scrapeless.

Requisitos previos

• Node.js 22 o superior en la estación de trabajo — Qwen Code requiere Node 22+, y el servidor MCP de stdio se inicia con npx.
• Qwen Code instalado y un proveedor de modelo configurado. Qwen Code se autentica contra un backend de LLM; el bucle del agente necesita un modelo funcional antes de que se ejecute cualquier llamada a herramienta.
• Una cuenta de Scrapeless y clave API — regístrate en el plan gratuito en app.scrapeless.com y copia la clave de Configuración → Gestión de Claves API.
• Familiaridad básica con la terminal — toda la configuración consiste en un puñado de comandos más un pequeño archivo JSON.

Instalación

La configuración tiene cinco sub-pasos; cada uno es verificable de forma independiente.

1. Instala Qwen Code

Instala la CLI globalmente desde npm, luego verifica la versión:

npm install -g @qwen-code/qwen-code
qwen --version

También puedes ejecutarlo sin una instalación global a través de npx -y @qwen-code/qwen-code@latest.

2. Conectar un proveedor de modelo

Qwen Code se comunica con un backend de LLM. Admite un modo compatible con OpenAI, por lo que cualquier endpoint compatible con OpenAI funciona — establece el tipo de autenticación, la clave API, la URL base y el modelo:

export OPENAI_API_KEY="tu_clave_proveedor_aqui"
export OPENAI_BASE_URL="https://tu-endpoint-compatible-con-openai/v1"
qwen --auth-type openai -m "tu-id-de-modelo"

Los mismos valores pueden ser pasados como flags --openai-api-key y --openai-base-url. Escoge un modelo que maneje bien las llamadas a herramientas; Qwen Code está construido alrededor del uso de herramientas de agente, por lo que un modelo de codificador de la serie Qwen actual es una buena elección.

3. Añadir el servidor MCP de Scrapeless (stdio)

Qwen Code lee los servidores MCP desde ~/.qwen/settings.json (alcance de usuario) o .qwen/settings.json en la raíz del proyecto. Añade un bloque scrapeless al objeto mcpServers:

{
  "mcpServers": {
    "scrapeless": {
      "command": "npx",
      "args": ["-y", "scrapeless-mcp-server"],
      "env": { "SCRAPELESS_KEY": "$SCRAPELESS_KEY" },
      "timeout": 60000,
      "trust": true
    }
  }
}

Dos detalles son importantes aquí. Primero, el servidor MCP de Scrapeless lee su clave de SCRAPELESS_KEY, no de SCRAPELESS_API_KEY — el CLI y SDK de Scrapeless usan SCRAPELESS_API_KEY, pero el servidor MCP es la excepción documentada. Segundo, Qwen Code expande $VAR y ${VAR} dentro del objeto env, por lo que puedes mantener la clave en tu entorno (export SCRAPELESS_KEY=...) y referenciarla como $SCRAPELESS_KEY en lugar de pegar el valor literal en el archivo. La fuente del servidor está en github.com/scrapeless-ai/scrapeless-mcp-server.

También puedes añadir el servidor desde la CLI en lugar de editar el JSON a mano:

qwen mcp add --transport stdio --scope user --env SCRAPELESS_KEY=$SCRAPELESS_KEY --trust scrapeless npx -y scrapeless-mcp-server

4. O usar el modo HTTP transmitible.

Si el anfitrión no puede generar de manera confiable npx — un contenedor de desarrollo alojado, un espacio de trabajo remoto o un sandbox de CI — dirija Qwen Code al punto final HTTP de Scrapeless en lugar del proceso local. Para el transporte HTTP, Qwen Code utiliza la clave httpUrl con un objeto headers opcional:

{
  "mcpServers": {
    "scrapeless": {
      "httpUrl": "https://api.scrapeless.com/mcp",
      "headers": { "x-api-token": "TU_CLAVE_SCRAPELESS" }
    }
  }
}

El mismo valor de clave funciona en ambos modos; el modo HTTP transmisible lo pasa como el encabezado x-api-token en lugar de la variable de entorno SCRAPELESS_KEY. Stdio es el valor predeterminado correcto en una estación de trabajo de desarrollo; HTTP transmisible es el valor predeterminado correcto donde un proceso hijo de larga duración es incómodo de mantener activo.

5. Verifica la conexión

Enumera los servidores MCP configurados:

qwen mcp list

El servidor scrapeless debería informar Conectado, lo que significa que Qwen Code lanzó el proceso stdio y completó el apretón de manos MCP. Desde allí, el agente puede enumerar las 21 herramientas del servidor — las herramientas de datos de Google (google_search, google_trends), los ayudantes de página de un solo uso (scrape_html, scrape_markdown, scrape_screenshot), y los primitivos del navegador en la nube (browser_create, browser_goto, browser_get_html, browser_get_text, browser_click, browser_type, browser_press_key, browser_scroll, browser_scroll_to, browser_screenshot, browser_snapshot, browser_wait, browser_wait_for, browser_go_back, browser_go_forward, browser_close).

Cómo usar esto: pídele a tu agente Qwen Code

Después de configurar el servidor MCP, obtienes datos web en vivo hablando con Qwen Code en la terminal — no escribiendo llamadas a herramientas manualmente. El agente lee la lista de herramientas que expone el servidor MCP de Scrapeless y elige google_search, scrape_markdown, o las herramientas browser_* según sea necesario, componiéndolas turno a turno desde el aviso en lenguaje natural. No hay JSON de herramienta que autorizar de tu parte. Qwen Code ejecuta los avisos interactivamente en una sesión, o no interactivamente pasando el aviso como un argumento posicional (o canalizándolo en stdin) para ejecuciones de un solo uso y scripting.

Avisos que puedes pegar

Ejemplo trabajado

Escribes (un solo uso, aviso pasado en stdin):

echo "Usa la herramienta google_search de scrapeless para encontrar los mejores resultados para 'qwen code github' y devuelve los 3 principales como un array JSON de {title, link}." | qwen --approval-mode yolo --allowed-mcp-server-names scrapeless

El plan del agente (en inglés simple):

1. Llama a google_search con q: "qwen code github", hl: "en", gl: "us".
2. Recibe un array de filas de resultados y lee los campos position, title y link.
3. Ordena por position y mantiene las tres primeras filas.
4. Mapea cada fila a un objeto {title, link}.
5. Devuelve el array JSON a la terminal.

Lo que recibes de vuelta (forma ilustrativa — el agente trabaja a partir de filas como estas):

[
  { "title": "Qwen Code es un agente de IA de código abierto para la terminal, ...", "link": "https://qwen.ai/qwencode" },
  { "title": "Resumen de Qwen Code", "link": "https://qwenlm.github.io/qwen-code-docs/en/users/overview/" },
  { "title": "qwen-code/qwen-code-core", "link": "https://www.npmjs.com/package/@qwen-code/qwen-code-core" }
]
// Los nombres de los campos coinciden con la forma de fila de google_search; los valores son muestras ilustrativas.

--allowed-mcp-server-names scrapeless limita la ejecución a las herramientas de Scrapeless, y --approval-mode yolo permite al agente ejecutar la herramienta de confianza sin un aviso interactivo, lo cual es útil para ejecuciones sin cabeza y guionadas. Las herramientas de datos sin estado devuelven su carga útil como un cuerpo precedido por Response:\n\n; el agente desenvuelve ese prefijo antes de analizar el JSON, por lo que nunca lo ves en la respuesta.

Formateando mensajes

Todo lo que sigue es la referencia técnica: la superficie de la herramienta, las formas de retorno exactas y el comportamiento que el agente maneja por ti.

La superficie de la herramienta MCP de Scrapeless

Una vez que el servidor está conectado, Qwen Code ve 21 herramientas que abarcan datos SERP, scraping sin estado, y control completo del navegador en la nube anti-detección.

Obtén tu clave API en el plan gratuito: Scrapeless

Lo que obtienes de vuelta

Una llamada google_search devuelve un array JSON de filas de resultados orgánicos. Cada fila lleva las mismas claves, por lo que el agente puede mapear directamente a título, enlace y fragmento:

// Los nombres de los campos reflejan la salida de la herramienta google_search; los valores son muestras ilustrativas.
[
  {
    "position": 1,
    "title": "Web Scraping Con Python: Una Guía Completa",
    "link": "https://example.com/python-web-scraping",
    "snippet": "Una guía paso a paso para raspar la web con Python y analizar HTML.",
    "source": "example.com"
  },
  {
    "position": 2,
    "title": "Raspado de Sitios Dinámicos",
    "link": "https://example.org/dynamic-scraping",
    "snippet": "Cómo renderizar páginas de JavaScript antes de extraer datos.",
    "source": "example.org"
  }
]

Algunas observaciones honestas una vez que comienzas a ejecutar mensajes:

• Las herramientas sin estado como google_search y scrape_markdown devuelven un cuerpo precedido por Response:\n\n seguido de la carga útil JSON; el agente desenvuelve ese prefijo automáticamente, por lo que trabajas con los datos, no con el envoltorio.
• Las herramientas browser_* devuelven texto plano sin el prefijo Response:\n\n.
• Los argumentos de las herramientas están en camelCase: pasa sessionId, proxyCountry, y campos similares exactamente como se nombran.
• proxyCountry es una solicitud, no una garantía — puede deferir a la región configurada en tu cuenta, así que confirma la región de egreso cuando el geo-targeting importa.
• Los valores en la salida de la herramienta dependen del contenido: el recuento de resultados, el orden y el texto del fragmento varían según la consulta en vivo.

Conclusión: busca, renderiza y navega desde la terminal

Toda la integración se reduce a un bloque MCP más mensajes en lenguaje natural. Con la entrada scrapeless en ~/.qwen/settings.json y tu clave en el entorno, Qwen Code gana búsqueda en vivo de Google, renderizado de JavaScript, y un navegador en la nube anti-detección completo — exactamente la capa web que el agente no envía por su cuenta. Tú describes la tarea; el agente elige la herramienta.
Si estás conectando otros agentes, el mismo servidor MCP de Scrapeless se integra con ellos también: consulta las integraciones de Google Antigravity y Pi Agent, así como la visión general del servidor MCP de Scrapeless para una referencia completa de la herramienta. Mantén tu clave API en SCRAPELESS_KEY, preferiblemente usa transporte stdio para CLIs locales y HTTP-streamable para agentes alojados, y deja que el agente elija las herramientas. Referencia completa en docs.scrapeless.com.

¿Listo para construir tu pipeline de datos potenciado por IA?

Únete a nuestra comunidad para reclamar un plan gratuito y conectar con desarrolladores que construyen agentes de Qwen Code + Scrapeless MCP: Discord · Telegram.

Regístrate en Scrapeless para obtener la ejecución gratuita de Scraping Browser y adapta la integración anterior a los SERPs, páginas y regiones que tu equipo necesita. Referencia completa en docs.scrapeless.com.

Preguntas Frecuentes

¿Por qué Qwen Code necesita un servidor MCP para la búsqueda web?

Porque no tiene búsqueda web incorporada. La herramienta central web_search fue eliminada en una versión temprana, y la documentación oficial rutea la búsqueda web a través de servidores MCP en su lugar. Conectar Scrapeless le da al agente esa capacidad de búsqueda que falta, además de acceso a páginas renderizadas y un navegador completo en la nube.

¿En qué se diferencia esto de web_fetch incorporado en Qwen Code?

web_fetch realiza una recuperación simple de una URL. No renderiza JavaScript y no tiene capa de anti-detección o proxy, por lo que tiene dificultades en aplicaciones de una sola página y sitios protegidos contra bots. Las herramientas de Scrapeless añaden la búsqueda que falta (google_search), texto renderizado limpio (scrape_markdown), y un navegador anti-detección con estado (browser_*) en proxies residenciales.

¿Qué variable de entorno mantiene la clave de Scrapeless?

SCRAPELESS_KEY. Esta es la excepción documentada: la CLI y SDK de Scrapeless leen SCRAPELESS_API_KEY, pero el servidor MCP lee SCRAPELESS_KEY. Qwen Code puede expandirlo desde tu entorno a través de $SCRAPELESS_KEY dentro del objeto env de la configuración.

¿De dónde lee Qwen Code la configuración de MCP?

Desde ~/.qwen/settings.json para el ámbito del usuario, o .qwen/settings.json en la raíz del proyecto para el ámbito del proyecto. Ambos utilizan el objeto mcpServers. También puedes agregar un servidor con qwen mcp add e inspeccionar las conexiones con qwen mcp list.

stdio vs HTTP streamable: ¿cuándo deberías usar cada uno?

Usa stdio cuando el servidor se ejecuta localmente junto a la CLI: Qwen Code lanza scrapeless-mcp-server como un proceso hijo y se comunica con él a través de entrada/salida estándar. Usa HTTP streamable (la clave httpUrl apuntando a https://api.scrapeless.com/mcp con el encabezado x-api-token) cuando el agente está alojado o remoto y no puede iniciar un proceso local.

¿Aplicará siempre proxyCountry?

No necesariamente. proxyCountry es una preferencia que puede aplazarse a la región configurada en tu cuenta. Si el geo-targeting importa, confirma la región de salida en lugar de asumir que el valor por llamada siempre prevalece.

¿Es legal el web scraping a través del agente?

El scraping de datos públicamente disponibles es generalmente permisible, pero eres responsable de cómo lo uses. Revisa los Términos de Servicio de cada sitio y respeta robots.txt, y recuerda que las reglas sobre datos personales y acceso varían según la jurisdicción. Cuando tengas dudas, obtén asesoría legal para tu caso específico.

¿Puedes usar esto sin un agente de IA?

Sí. El servidor MCP de Scrapeless es un servidor MCP estándar, por lo que cualquier cliente compatible con MCP puede llamarlo, o puedes controlarlo directamente a través de JSON-RPC (initialize, luego tools/list y tools/call). El agente es una conveniencia, no un requisito.