Proposition : Browser Connector - Automatisation navigateur

Date : 14/01/2026 00:35 Status : IMPLEMENTEE Priorite : HAUTE Effort : ~3h

Concept

Un service avec un vrai navigateur Chrome pour accéder aux contenus personnels que les APIs bloquent.

┌─────────────────────────────────────────────────────────────────┐
│                    BROWSER CONNECTOR                             │
│                                                                  │
│  ┌──────────────────────────────────────────────────────────┐   │
│  │                    CHROME HEADLESS                        │   │
│  │                    (Puppeteer/Playwright)                 │   │
│  └──────────────────────────────────────────────────────────┘   │
│         │                    │                    │              │
│         ▼                    ▼                    ▼              │
│  ┌─────────────┐      ┌─────────────┐      ┌─────────────┐      │
│  │  LINKEDIN   │      │   GMAIL     │      │  TWITTER    │      │
│  │  - Profile  │      │  - Inbox    │      │  - DMs      │      │
│  │  - Connect° │      │  - Send     │      │  - Timeline │      │
│  │  - Messages │      │  - Labels   │      │  - Likes    │      │
│  └─────────────┘      └─────────────┘      └─────────────┘      │
│                                                                  │
│  ┌──────────────────────────────────────────────────────────┐   │
│  │                    SESSION STORE                          │   │
│  │              (Cookies, LocalStorage)                      │   │
│  └──────────────────────────────────────────────────────────┘   │
└─────────────────────────────────────────────────────────────────┘

Fonctionnalites

Login & Sessions

• Login manuel une fois via VNC/noVNC (interface web)
• Sauvegarde des cookies/sessions dans Redis
• Restauration automatique des sessions
• Detection d'expiration et notification

Par service

LinkedIn (full access) :

• GET /browser/linkedin/profile - Profil complet
• GET /browser/linkedin/connections - Liste des connexions
• GET /browser/linkedin/messages - Conversations
• POST /browser/linkedin/message - Envoyer un message
• GET /browser/linkedin/notifications - Notifications

Gmail (full access) :

• GET /browser/gmail/inbox - Emails
• GET /browser/gmail/email/:id - Contenu email
• POST /browser/gmail/send - Envoyer email
• GET /browser/gmail/contacts - Contacts

Twitter/X :

• GET /browser/twitter/dms - Messages prives
• GET /browser/twitter/timeline - Timeline
• POST /browser/twitter/tweet - Poster

Stack technique

• Browser : Chrome/Chromium headless
• Automation : Playwright (plus moderne que Puppeteer)
• VNC : noVNC pour login manuel via web
• Runtime : Bun + Elysia
• Port API : 5401
• Port VNC : 5900 (interne) / 6080 (noVNC web)

Architecture Docker

services:
  browser-connector:
    image: mcr.microsoft.com/playwright:v1.40.0-jammy
    ports:
      - "5401:5401"   # API
      - "6080:6080"   # noVNC web
    environment:
      - DISPLAY=:99
    volumes:
      - browser-data:/data  # Sessions, cookies

Workflow Login

1. Acceder a https://browser.33800.nowhere84.com (noVNC)
2. Se connecter manuellement a LinkedIn/Gmail/etc
3. L'API capture et sauvegarde les cookies
4. Les requetes suivantes utilisent ces sessions

Securite

• Acces VNC protege par mot de passe
• Sessions stockees chiffrees dans Redis
• Rotation des sessions pour eviter detection
• User-Agent realiste
• Delais humains entre actions

Integration avec Connectors API

Le Browser Connector s'integre avec le Connectors API existant :

connectors-api (5400)     browser-connector (5401)
      │                           │
      ├── /api/linkedin/post      │
      │   (via API officielle)    │
      │                           ├── /browser/linkedin/messages
      │                           │   (via browser automation)
      │                           │
      └───────────┬───────────────┘
                  │
           REDIS (sessions)

Validation

• [ ] Approuver l'architecture
• [ ] Confirmer les services prioritaires (LinkedIn, Gmail, Twitter)
• [ ] Lancer l'implementation