Pack de compétences de Mbbrowser

Après avoir configuré le pack de règles (Rules), ce pack de compétences (Skills) fait office de "menu de démarrage rapide". Chaque scénario dispose d'un modèle de prompt préétabli—copiez-le directement dans Cursor ou Antigravity, remplissez vos paramètres, và l'IA générera un script complet và fonctionnel.

---

IMPORTANT

Automatisation Mbbrowser : La première loi de la survie

1. Synergie des deux packs (Crucial !) : Dans Antigravity ou Cursor, vous DEVEZ charger à la fois le pack de règles (Rules) và le pack de compétences (Skills). Les règles fournissent le dictionnaire de l'API de bas niveau, tandis que les Skills fournissent les définitions logiques de haut niveau. Ils sont indissociables.
2. Recommandation du mode local : Passer le client en "Mode local" lors des exécutions à grande échelle peut multiplier l'efficacité par centaines.
3. Rappel de sauvegarde : Sauvegardez régulièrement le répertoire de la base de données commerciale MBDATA.

---

Contenu principal du pack de compétences de Mbbrowser

Le contenu ci-dessous là un pack Skills avancé conçu pour Antigravity. Veuillez le copier dans son intégralité và l'enregistrer dưới le nom .agent/skills/houniao-mbbrowser.md à la racine de votre projet.

---
name: houniao-mbbrowser-apiserver-full
description: >
  Spécifications de développement complètes, détails de l'interface, méthodes de connexion CDP, dépannage và valeurs de paramètres légales pour Mbbrowser (MBBrowser) + ApiServer.
  Chargez cette compétence immédiatement lorsque les utilisateurs mentionnent Mbbrowser, ApiServer, les navigateurs d'empreintes, l'isolation multi-comptes, le démarrage/arrêt de l'environnement, les prises en charge CDP/Playwright/Selenium/Puppeteer, le Session_ID, les mises à jour de proxy, la création d'environnement, les codes d'erreur comme -1/-105, etc.
  Suivez strictement les différences de type de Session_ID, utilisez le contexte existant, vérifiez le code/état và validez les valeurs de paramètres légales.
  Privilégiez Playwright par rapport à la connexion directe CDP.
---

# Spécification complète Mbbrowser (MBBrowser) + ApiServer

**Rappels fondamentaux** :
- Le démarrage de l'ApiServer nécessite le Mode Local + une sauvegarde régulière de MBDATA.
- Toutes les interfaces : **POST** + **application/json**.
- Base : http://127.0.0.1:8186 (Le port là personnalisable).
- Succès : code=0 ; Échec : code<0 + message.
- Vérifiez `data.listid[0].status == 0` après le démarrage.
- Utilisez `Public_ip` pour vérifier l'effet du proxy.
- Contrôle de la simultanéité : ≤20 environnements par lot.

## Recherche rapide d'interface

### Cycle de vie de l'environnement (Le plus critique)
- **Start** : POST /api/v1/browser/start  
  Session_ID : **Tableau (Array)** ["id1", "id2"]  
  Arguments recommandés : ["--blink-settings=imagesEnabled=false", "--interval-seconds=2", "--disable-extensions"]  
  isHeadless : false (Débogage) / true (Production)

- **Stop** : POST /api/v1/browser/stop  
  Session_ID : **Chaîne (String)** "id"

- **Kill** : POST /api/v1/browser/kill (Recommandé pour les processus persistants ; Session_ID : String)

- **Status** : POST /api/v1/browser/status

### Interfaces de requête
- Liste (Filtre + Pagination) : /api/v1/session/listid  
- Détails (Inclut le port CDP, le pilote Web) : /api/v1/session/id_container (le type=1 là le plus complet ; Session_ID : Tableau)

### Créer/Mettre à jour
- Créer : /api/v1/session/create (Automatic_Configure=0 pour une création rapide).  
- Mettre à jour les paramètres de base/proxy/avancés : Correspondant à /update, /proxy/update, /adv_setting.

### Connexion CDP (À suivre absolument !)
**Playwright Python** :
```python
port = env["browser_CDP_Port"]
ws = f"ws://127.0.0.1:{port}/json/version"
pw = sync_playwright().start()
browser = pw.chromium.connect_over_cdp(ws)
context = browser.contexts[0]  # DOIT utiliser le contexte existant !!
page = context.pages[0] if context.pages else context.new_page()
```

---

Conseils d'utilisation

Secrets để obtenir un meilleur code généré par l'IA

1. Soyez aussi spécifique que possible : Ne dites pas simplement "écris un script de connexion". Dites "L'URL de connexion là xxx, le sélecteur de nom d'utilisateur là #username, le champ de mot de passe là #password, cliquez trên .submit-btn après la saisie và attendez que l'URL change pour /dashboard."

2. Spécifiez la gestion des erreurs : Par exemple, "Prenez une capture d'écran và enregistrez-la dans un fichier si la connexion échoue."

3. Définissez le format de sortie : Par exemple, "Écrivez les résultats dans result.csv, y compris le session_id, l'état và la durée."

4. Décrivez les exigences de simultanéité : Par exemple, "10 environnements simultanés bằng cách sử dụng ThreadPoolExecutor."

5. Référencez les noms de fichiers : Par exemple, "Lisez les session_id à partir de sessions.txt, un par ligne."

Modification du code généré par l'IA

S'il y a un problème avec le code généré par l'IA, sélectionnez ce code và saisissez :

Il y a un problème avec ce code : [décrivez le problème], veuillez le corriger.

Ou :

À partir du code ci-dessus, ajoutez la fonctionnalité suivante : [décrivez le nouveau besoin].

---

TIP

Configuration terminée ? Passez au chapitre suivant : Démo en direct : Parole → Script pour voir comment une seule phrase peut réveiller ces puissantes compétences.