Donner à Qwen Code un accès au Web via Bright Data

Dans ce tutoriel, vous apprendrez :

• Ce qu’est Qwen Code et ce qu’il offre.
• Pourquoi l’étendre avec un accès web aide à surmonter les limitations des LLM sous-jacents.
• Comment Bright Data permet à Qwen Code de rechercher, scraper et découvrir du contenu web, entre autres capacités.
• Comment exposer les capacités de Bright Data à Qwen Code via MCP.
• Comment équiper Qwen Code de la connaissance des solutions Bright Data via les Agent Skills.
• La puissance de la combinaison de Qwen Code avec Bright Data à travers un exemple complet.

Plongeons dans le vif du sujet !

Qu’est-ce que Qwen Code ?

Qwen Code est un agent IA open-source qui s’exécute directement dans votre terminal. Il est optimisé pour les modèles Qwen et vous aide à mieux comprendre les grandes bases de code, automatiser les tâches répétitives et livrer des logiciels plus rapidement.

Il bénéficie d’une forte adoption par la communauté, comme le montrent ses étoiles GitHub en rapide croissance (plus de 20 000 étoiles et ce n’est pas fini) :

Les principales fonctionnalités offertes par Qwen Code sont :

• Agent IA orienté terminal : S’exécute directement en ligne de commande, permettant des flux de développement rapides et ciblés sans quitter le terminal.
• Support multi-protocoles : Fonctionne avec les API compatibles OpenAI, Anthropic, Gemini ou des fournisseurs personnalisés via des clés API.
• Flux de travail agentiques : Inclut des Skills et SubAgents intégrés pour automatiser des tâches complexes à plusieurs étapes.
• Open-source et co-évolutif : L’outil et les modèles Qwen évoluent ensemble grâce aux contributions de la communauté et aux mises à jour fréquentes.
• Intégration IDE : Prend en charge VS Code, Zed et les IDE JetBrains pour une assistance IA transparente dans votre éditeur.
• Modes interactif et headless : Utilisez une interface de terminal interactive pour l’exploration ou exécutez dans des scripts/CI pour l’automatisation.

Explorez la documentation officielle pour plus de détails.

Pourquoi Qwen Code a besoin d’outils de récupération et de découverte de données web

Qwen Code se heurte inévitablement à une barrière universelle inhérente à tous les grands modèles de langage : la « date limite de connaissance ». Puisqu’un LLM est construit à partir d’un jeu de données massif mais fini, figé au moment de l’entraînement, l’intelligence qu’il fournit est intrinsèquement limitée.

Dans des environnements numériques en rapide évolution, ce qui est considéré comme une bonne pratique aujourd’hui peut rapidement devenir obsolète. S’appuyer sur un agent qui ne dispose que de connaissances internes statiques introduit de vrais risques. Il peut manquer des mises à jour récentes ou suggérer des approches qui ne reflètent plus les réalités actuelles.

Pour surmonter ces problèmes, vous devez faire évoluer votre assistant CLI en une entité capable d’interaction web en temps réel. C’est précisément là qu’intervient Bright Data !

En tirant parti de l’infrastructure optimisée pour l’IA fournie par Bright Data, vous permettez à Qwen Code de naviguer, explorer et récupérer des informations sur Internet. En détail, l’intégration de Bright Data dans Qwen Code permet à votre agent de :

• Effectuer des recherches en temps réel sur le web pour recueillir des informations à jour sur n’importe quel sujet ou domaine.
• Recouper plusieurs sources en ligne pour garantir l’exactitude et la cohérence des informations récupérées.
• Collecter des informations structurées provenant de différents domaines de connaissance pour soutenir l’analyse, la recherche ou la prise de décision.
• Enrichir des documents, rapports ou bases de connaissances en récupérant et intégrant les derniers contenus publiquement disponibles.

Le véritable avantage de Bright Data réside dans son infrastructure de niveau entreprise. Celle-ci s’appuie sur un vaste pool de plus de 400 millions de proxys résidentiels couvrant 195 pays. Le résultat est un agent capable de mettre à l’échelle ses efforts de collecte de données avec une fiabilité de 99,99 % et des taux de succès de 99,95 %.

En ancrant Qwen Code dans des faits actuels et vérifiables, vous le transformez d’un outil de référence statique en un véritable partenaire IA fiable !

Booster Qwen Code avec Bright Data : 2 approches

Bright Data prend en charge Qwen Code via deux approches complémentaires :

• Bright Data Web MCP : Le serveur MCP officiel de Bright Data, exposant plus de 70 outils pour le Scraping web, la recherche, la découverte, l’interaction, et plus encore. Il offre un niveau gratuit avec des outils utiles, tandis que les outils avancés ne sont disponibles qu’en mode Pro.
• Bright Data skills : Une collection de fichiers conformes aux Agent Skills pour aider votre agent IA à apprendre à utiliser les produits Bright Data plus efficacement.

Important : Ces deux approches sont synergiques et fonctionnent mieux lorsqu’elles sont utilisées ensemble. En particulier, les Bright Data skills incluent une compétence dédiée pour mieux orchestrer et sélectionner les outils Web MCP.

Étapes communes

Avant d’explorer l’intégration de Bright Data dans Qwen Code via MCP ou Agent Skills, prenez soin de réaliser quelques étapes prérequises communes !

Prérequis

Pour suivre ce tutoriel, assurez-vous de disposer d’une machine avec :

• Un système d’exploitation Unix (macOS, Linux ou WSL).
• Node.js 20+ installé localement.

Vous aurez également besoin de :

• Un plan Alibaba Cloud Coding ou une clé API standard Alibaba Cloud Model Studio (ici, nous ferons référence à la configuration par clé API).
• Un compte Bright Data avec une clé API configurée.

Pour générer une clé API Bright Data, suivez le guide officiel.

Étape n°1 : Installer Qwen Code

Exécutez la commande suivante pour lancer le script d’installation :

curl -fsSL https://qwen-code-assets.oss-cn-hangzhou.aliyuncs.com/installation/install-qwen.sh | bash

Vous devriez voir quelque chose comme ceci :

En coulisses, le script d’installation de Qwen Code :

1. Vérifie les prérequis.
2. Installe Qwen Code via le package npm @qwen-code/qwen-code.
3. Rend le CLI disponible via la commande qwen.

Bravo ! Qwen Code est maintenant configuré localement.

Étape n°2 : Finaliser la configuration de Qwen Code

Dans cet exemple, nous supposerons que votre projet se trouve dans un dossier appelé bright-data-qwen-code-example/. Remplacez-le par le nom réel de votre répertoire de projet.

Accédez au répertoire du projet dans votre terminal :

cd bright-data-qwen-code-example

Ensuite, démarrez Qwen Code avec :

qwen

Complétez la configuration en connectant le CLI à votre compte Alibaba à l’aide de la commande suivante :

/auth

Il vous sera demandé de sélectionner une méthode d’authentification. Dans ce cas, procédez avec l’option clé API :

Pour accéder aux modèles Qwen, sélectionnez l’option « Alibaba Cloud Model Studio Standard API Key » :

Collez votre clé API standard Alibaba Cloud Model Studio. Ensuite, configurez les modèles disponibles à l’aide d’une liste d’identifiants de modèles séparés par des virgules, par exemple :

qwen3.6-flash,qwen3.5-plus,glm-5,kimi-k2.5

Ce seront les modèles disponibles dans votre configuration Qwen Code. Incroyable ! Le CLI est maintenant connecté à votre compte et propulsé par les LLM Qwen.

Étape n°3 : Configurer Qwen Code

Changez le modèle par défaut utilisé par Qwen Code avec cette commande :

/model

Par exemple, sélectionnez qwen3.6-flash :

Notez que les modèles disponibles sont ceux configurés lors des étapes précédentes. Excellent ! Qwen Code est maintenant installé, authentifié et configuré pour une utilisation locale.

Comment connecter Qwen Code au Web MCP de Bright Data

Cette section vous montrera comment configurer une instance locale du Web MCP de Bright Data dans Qwen Code.

Remarque : Si vous cherchez à intégrer Qwen-Agent avec Web MCP, consultez notre guide dédié.

Prérequis

Pour suivre cette section, vous devriez avoir :

• Une certaine compréhension du fonctionnement de MCP.
• Une familiarité de base avec les outils exposés par le Web MCP de Bright Data.

Notez également que les prérequis décrits dans la section « Étapes communes » s’appliquent toujours.

Étape n°1 : Lancer le Web MCP de Bright Data

Tout d’abord, vérifiez que le serveur MCP de Bright Data peut s’exécuter correctement sur votre machine.

Commencez par vous connecter à votre compte Bright Data. Pour une configuration rapide, vous pouvez suivre l’assistant dans la section « MCP » du panneau de contrôle :

Vous pouvez également suivre les instructions étape par étape ci-dessous pour une configuration plus guidée.

Ensuite, installez le Web MCP globalement en utilisant le package @brightdata/mcp :

npm install -g @brightdata/mcp

Pour vérifier que le serveur MCP démarre localement, exécutez :

API_TOKEN="<YOUR_BRIGHT_DATA_API>" npx -y @brightdata/mcp

Remplacez <YOUR_BRIGHT_DATA_API> par votre clé API Bright Data réelle. La commande ci-dessus définit la variable d’environnement API_TOKEN requise et lance une instance locale du serveur Web MCP.

Si tout fonctionne correctement, vous devriez voir une sortie similaire à celle-ci :

Au premier lancement, le package @brightdata/mcp crée automatiquement les Zones suivantes dans votre compte Bright Data :

• mcp_unlocker : Une Zone pour Web Unlocker.
• mcp_browser : Une Zone pour l’API Browser.

Ces deux Zones alimentent tous les outils exposés par le serveur Web MCP. Vous pouvez également configurer des Zones personnalisées si nécessaire, comme décrit dans le dépôt.

Pour confirmer que les Zones standard ont été créées, accédez à la page « Proxies & Scraping Infrastructure » dans le panneau de contrôle Bright Data. Vous devriez voir les deux Zones listées dans le tableau :

Désormais, avec le niveau gratuit du Web MCP, vous n’avez accès qu’à ces outils :

• search_engine (+ sa version batch)
• scrape_as_markdown (+ sa version batch)
• discover

Pour débloquer les 70+ outils, vous devez activer le mode Pro. Pour ce faire, définissez la variable d’environnement PRO_MODE="true" :

API_TOKEN="<YOUR_BRIGHT_DATA_API>" PRO_MODE="true" npx -y @brightdata/mcp

N’oubliez pas que le mode Pro n’est pas inclus dans le niveau gratuit et [entraîne des frais supplémentaires](https://github.com/brightdata/brightdata-mcp?tab=readme-ov-file#-pricing, modes).

Parfait ! Vous venez de vérifier que le serveur Web MCP s’exécute sur votre machine. Ensuite, vous allez configurer Qwen Code pour s’y connecter.

Étape n°2 : Configurer le Web MCP dans Qwen Code

Pour configurer les serveurs MCP dans Qwen Code, commencez par créer un dossier .qwen dans le répertoire racine de votre projet. À l’intérieur, ajoutez un fichier settings.json, qui définit la configuration au niveau du projet pour Qwen Code :

bright-data-qwen-code-example/
├── .qwen/
│    └── settings.json
└── ...

Assurez-vous que le fichier .qwen/settings.json contient ce qui suit :

{
  "mcpServers": {
    "bright-data-web-mcp": {
      "command": "npx",
      "args": [
        "@brightdata/mcp"
      ],
      "env": {
        "API_TOKEN": "<YOUR_BRIGHT_DATA_API_KEY>",
        "PRO_MODE": "true"
      }
    }
  }
}

La configuration ci-dessus reflète la commande npx testée précédemment, en utilisant des variables d’environnement pour l’authentification et la configuration :

• API_TOKEN : Obligatoire. Définissez-le sur votre clé API Bright Data.
• PRO_MODE : Optionnel. Définissez-le sur "false" ou supprimez-le si vous ne souhaitez pas activer le mode Pro.

Désormais, au démarrage, Qwen Code utilisera cette configuration pour lancer une instance locale du serveur Web MCP et s’y connecter. Pour rendre la configuration globale, ajoutez la même configuration au fichier ~/.qwen/settings.json.

Remarque : Vous pouvez également vous connecter au Web MCP distant de Bright Data via Streamable HTTP en utilisant une configuration différente, comme décrit dans la documentation officielle. Cette approche est mieux adaptée aux configurations de niveau entreprise ou si vous ne souhaitez pas qu’un serveur local s’exécute sur votre machine.

Super ! Le Web MCP devrait maintenant être disponible dans Qwen Code.

Étape n°3 : Vérifier la connexion

Ouvrez à nouveau Qwen Code :

qwen

Cette fois, vous devriez voir un message « Connexion aux serveurs MCP… » au démarrage. Une fois le processus terminé, lancez :

/mcp

Dans la liste des serveurs MCP disponibles, vous devriez voir l’entrée bright-data-web-mcp :

Appuyez sur Entrée pour l’explorer, puis sélectionnez l’option « Voir les outils » :

En mode Rapid (niveau gratuit, lorsque PRO_MODE est omis ou défini sur "false"), vous verrez un ensemble limité d’outils. En mode Pro (tel que configuré ci-dessus), vous aurez accès à l’ensemble complet de 70+ outils.

Félicitations ! Cela confirme que le Web MCP de Bright Data expose correctement les outils à Qwen Code. (Plus tard, nous démontrerons le Web MCP en action avec les Bright Data skills.)

Comment ajouter les Skills de Bright Data à Qwen Code

Dans ce chapitre, vous serez guidé tout au long du processus d’installation des Bright Data skills dans votre configuration locale de Qwen Code. La procédure sera gérée automatiquement via le CLI skills de Vercel.

Remarque : Si vous préférez une configuration manuelle, commencez par cloner le dépôt Bright Data Skills. Ensuite, copiez simplement les fichiers requis dans le dossier .qwen/skills/ de votre projet :

git clone https://github.com/brightdata/skills
cp -r skills/skills/* <PATH_TO_YOUR_PROJECT>/.qwen/skills/

Pour une approche plus guidée et fiable, suivez les instructions ci-dessous !

Prérequis

Avant de commencer, il est recommandé d’avoir :

• Une compréhension de base du fonctionnement du standard Agent Skills.
• Une familiarité avec le fonctionnement des standards Agent Skills.
• Une certaine connaissance des Bright Data skills.

En plus des prérequis listés dans la section « Étapes communes », vous aurez également besoin de :

• Une Zone API Web Unlocker configurée dans votre compte Bright Data.
• La bibliothèque jq installée localement.

Pour installer jq (un outil en ligne de commande pour traiter le JSON) sur les systèmes Debian, exécutez :

sudo apt-get install curl jq

Alternativement, sur macOS, exécutez :

brew install curl jq

Pour une configuration rapide de la Zone API Web Unlocker, consultez le guide « Créez votre première API Unlocker », ou passez à l’étape suivante.

Étape n°1 : Ajouter une Zone API Web Unlocker

Commencez par vous connecter à votre compte Bright Data. Dans le panneau de contrôle, accédez à la page « Proxies & Scraping » et inspectez le tableau « My Zones » :

Si une Zone API Web Unlocker existe déjà, comme web_unlocker, parfait !

Sinon, faites défiler jusqu’à la section « Unblocker API » et appuyez sur « Créer une zone » :

Choisissez un nom clair pour votre Zone et suivez l’assistant de configuration jusqu’à son activation complète. C’est fait !

Étape n°2 : Configurer les Bright Data Skills

Les Bright Data skills nécessitent deux variables d’environnement :

• BRIGHTDATA_API_KEY : Utilisée pour authentifier les requêtes HTTP sous-jacentes aux API Bright Data.
• BRIGHTDATA_UNLOCKER_ZONE : Utilisée pour se connecter à votre Zone API Web Unlocker (utilisée pour les tâches de scraping et de recherche, car elle peut également fonctionner comme une Zone API SERP).

Définissez-les dans votre environnement :

export BRIGHTDATA_API_KEY="<YOUR_BRIGHT_DATA_API_KEY>"
export BRIGHTDATA_UNLOCKER_ZONE="<YOUR_BRIGHT_DATA_WEB_UNLOCKER_API_ZONE_NAME>"

Remplacez les valeurs de remplacement et vous êtes prêt à ajouter les Bright Data skills !

Étape n°3 : Installer les Bright Data Skills

Depuis votre répertoire de projet, pour installer les Bright Data skills, exécutez :

npx skills add brightdata/skills -a qwen-code

Cette commande installe le CLI skills de Vercel (s’il n’est pas déjà installé) et lance une configuration interactive qui va :

• Récupérer les Bright Data skills depuis l’Annuaire officiel des Agent Skills.
• Les configurer dans votre projet IBM Bob.

Vous verrez d’abord un écran pour sélectionner les skills à installer :

Pour les installer tous, activez chaque option à l’aide de la barre d’espace, puis appuyez sur Entrée.

Choisissez la portée de l’installation (le niveau projet est recommandé) et continuez :

Les sections « Résumé d’installation » et « Évaluation des risques de sécurité » vous seront présentées. Examinez-les et appuyez sur Entrée pour confirmer.

Une fois le processus terminé, vous recevrez un message de confirmation final comme celui-ci :

Les Bright Data skills seront ajoutées à votre projet dans le répertoire .qwen/skills :

bright-data-qwen-code-example/
├── .qwen/
│    ├── skills/
│    │   ├── brd-browser-debug/
│    │   ├── bright-data-best-practices/
│    │   ├── bright-data-mcp/
│    │   ├── brightdata-cli/
│    │   ├── competitive-intel/
│    │   ├── data-feeds/
│    │   ├── design-mirror/
│    │   ├── python-sdk-best-practices/
│    │   ├── scrape/
│    │   ├── scraper-builder/
│    │   └── search/
│    └── settings.json
└── ...

Fantastique ! Les Bright Data skills sont maintenant installées dans votre configuration locale de Qwen Code.

Étape n°4 : Vérifier la disponibilité des Skills

Redémarrez Qwen Code pour vous assurer que les modifications prennent effet. Ensuite, vérifiez que les Bright Data skills sont disponibles dans votre configuration Qwen Code avec :

/skills

Vous devriez voir quelque chose comme ceci :

Notez que la liste inclut à la fois les Bright Data skills et certaines skills intégrées de Qwen Code.

Mission accomplie ! Il ne reste plus qu’à tester l’intégration Qwen Code + Bright Data.

Qwen Code + Bright Data : l’intégration en action

Vous avez maintenant Bright Data intégré dans Qwen Code via MCP et les skills. Il est temps de voir ce que cette configuration permet en pratique. Nous allons parcourir un exemple concret du monde réel, bien que de nombreux autres cas d’usage soient possibles.

Imaginez que vous souhaitez mettre à jour les données d’une table products avec des informations produits du monde réel. L’objectif est de découvrir les dernières nouveautés sur Zara pour hommes et femmes, de scraper leurs données et de les ajouter à votre base de données.

Au lieu de rechercher manuellement des produits et de collecter les données vous-même, vous pouvez déléguer l’intégralité de la tâche à votre assistant CLI. Faites-le avec une invite comme celle-ci :

Search online for the Zara US New Arrivals page for men and select only the most relevant source. Then repeat the process for the Zara US New Arrivals page for women, again selecting only the most relevant source.

Using these two New Arrivals pages (men and women), scrape their content in Markdown format. From the scraped data, extract high-level product information and generate a SQL script to update an existing `products` table with the following columns: `product_url`, `type` ("male" | "female"), `image_url`, `name`, `price`.

Finally, save the SQL script to disk.

Remarque : Aucun modèle Qwen (ni aucun autre LLM) ne serait capable d’accomplir cette tâche. C’est parce qu’elle nécessite la découverte web, la navigation et le Scraping web. Ce sont des capacités que les modèles IA n’ont pas par défaut. Vous les obtenez en connectant votre modèle Qwen à l’infrastructure de Bright Data.

Exécutez l’invite, et voici ce que vous devriez voir :

Voici comment l’agent Qwen Code a géré la tâche :

1. Utilisé l’outil search_engine deux fois pour interroger « Zara US New Arrivals men 2026 » et « Zara US New Arrivals women 2026 » sur Google, respectivement.
2. Récupéré des résultats Google SERP structurés (grâce à l’API SERP Web de Bright Data) et sélectionné les pages correctes des Nouveautés Zara Hommes (https://www.zara.com/us/en/man-new-in-l711.html) et Femmes (https://www.zara.com/us/en/woman-new-in-l1180.html).
3. Passé les deux URL de produits à l’outil scrape_as_markdown (alimenté par l’API Web Unlocker de Bright Data).
4. Converti le Markdown scrapé en données produits structurées via Qwen.
5. Utilisé les données scrapées pour générer un script zara_new_arrivals_update.sql.

Jetez un œil au fichier zara_new_arrivals_update.sql généré :

Il contient des instructions INSERT où les données produits proviennent directement des pages de nouveautés Zara. Si vous avez des doutes, visitez les pages sélectionnées dans votre navigateur.

Supposons maintenant que vous souhaitiez extraire des données plus détaillées sur un produit spécifique. Exécutez une invite comme celle-ci :

Extract structured data from the following Zara product page and save it as a JSON file: "https://www.zara.com/us/en/paisley-print-bandana-p03534410.html"

Remarque : L’URL du produit dans l’invite provient directement de la première instruction INSERT dans le script SQL.

Cette fois, si vous utilisez le mode Pro avec Web MCP, l’outil web_data_zara_products sera appelé :

Cela se connecte au Scraper Zara de Bright Data pour récupérer des données structurées depuis une page Zara, en contournant les systèmes anti-bot et anti-scraping.

Le résultat est un fichier JSON comme celui-ci :

Il contient exactement les données de la page produit Zara, mais structurées et prêtes à être utilisées pour des simulations, des analyses ou des traitements en aval :

Et voilà ! Cet exemple simple montre clairement à quel point Qwen Code devient puissant lorsqu’il est combiné avec les capacités d’accès web de Bright Data.

Conclusion

Dans cet article de blog, vous avez appris ce que Qwen Code apporte au développement logiciel alimenté par l’IA en ligne de commande. En particulier, vous avez vu pourquoi et comment l’étendre en le connectant à Bright Data via Web MCP et les Agent Skills.

Cette intégration équipe Qwen Code d’outils prêts pour l’entreprise pour la recherche web, la découverte, l’extraction de données structurées, les interactions web automatisées, et bien plus encore. Ces fonctionnalités améliorent considérablement son efficacité.

Pour des flux de travail encore plus avancés, vous pouvez explorer la gamme complète des services prêts pour l’IA dans l’écosystème Bright Data.