Agent Bridge

Vue d’ensemble

Agent Bridge permet aux agents IA (Claude Code, Cursor, Cowork, etc.) de contrôler à distance l’extension Chrome Web2MD pour convertir des URL en lot — en particulier Reddit, les pages rendues en JS et celles protégées par connexion, qui bloquent l’accès à l’API côté serveur. Plutôt que d’appeler l’API Web2MD (que Reddit bloque), l’agent IA envoie des commandes à votre extension Chrome locale via la messagerie native. L’extension ouvre chaque page dans un onglet en arrière-plan en utilisant votre véritable session de navigateur — avec vos cookies et votre état de connexion —, extrait le contenu, le convertit en Markdown et renvoie le résultat.

Agent Bridge nécessite un plan PRO et l’hôte de messagerie native installé sur votre machine. L’extension doit être ouverte dans Chrome.

Architecture

AI Agent ←MCP/stdio→ MCP Server ←TCP:12315→ Native Host ←NM→ Chrome Extension → Any Website

Composant	Rôle
Agent IA	Claude Code, Cursor, Cowork — appelle les outils MCP
Serveur MCP	Traduit les appels d’outils MCP en messages TCP
Hôte natif	Relaie entre TCP et la messagerie native de Chrome
Extension Chrome	Ouvre les onglets, extrait le HTML, convertit en Markdown

Toute la communication est locale — rien ne quitte votre machine. L’hôte natif écoute uniquement sur localhost:12315.

Configuration

Étape 1 : Construire le serveur MCP

cd packages/mcp-server
pnpm build

Étape 2 : Installer l’hôte de messagerie native

cd packages/mcp-server
./install.sh <your-extension-id>

Trouvez votre ID d’extension sur chrome://extensions avec le mode développeur activé. Recherchez Web2MD et copiez la chaîne d’ID (par exemple ijmgpkkfgpijifldbjafjiapehppcbcn).

Après l’installation, vous devez quitter complètement Chrome (Cmd+Q sur Mac) et le rouvrir. Chrome ne lit les manifestes de messagerie native qu’au démarrage — recharger l’extension ne suffit pas.

Le script d’installation :

Copie les fichiers de l’hôte vers ~/.web2md/ (évite les restrictions TCC de macOS sur ~/Desktop)
Résout le chemin absolu de node (Chrome se lance avec un PATH minimal)
Écrit le manifeste NM dans le répertoire NativeMessagingHosts de Chrome

Étape 3 : Configurer MCP

Claude Code
Cursor
Claude Desktop

Ajoutez à ~/.claude/settings.json :

{
  "mcpServers": {
    "web2md-agent": {
      "command": "node",
      "args": ["/path/to/packages/mcp-server/dist/index.js"],
      "env": {
        "WEB2MD_API_KEY": "w2m_your_key_here"
      }
    }
  }
}

Ajoutez à ~/.cursor/mcp.json :

{
  "mcpServers": {
    "web2md-agent": {
      "command": "node",
      "args": ["/path/to/packages/mcp-server/dist/index.js"],
      "env": {
        "WEB2MD_API_KEY": "w2m_your_key_here"
      }
    }
  }
}

Ajoutez à votre configuration Claude Desktop :

{
  "mcpServers": {
    "web2md-agent": {
      "command": "node",
      "args": ["/path/to/packages/mcp-server/dist/index.js"],
      "env": {
        "WEB2MD_API_KEY": "w2m_your_key_here"
      }
    }
  }
}

Étape 4 : Vérifier

Dans Chrome, ouvrez chrome://extensions → cliquez sur le lien « Service Worker » de Web2MD → vérifiez la console :

[Web2MD] Service worker started
[Web2MD] Connected to native host
[Web2MD] Native host TCP relay ready on port 12315

Si vous voyez ces trois lignes, Agent Bridge fonctionne.

Outils disponibles

Agent Bridge expose trois outils MCP — choisissez selon le transport et vos besoins de traitement en lot. Les trois sont documentés en détail sur la page Serveur MCP ; voici la comparaison rapide.

Outil	Transport	Traitement en lot
`bridge_convert_url`	HTTP (l’extension récupère le HTML, le serveur convertit)	URL unique
`agent_convert`	Messagerie native (architecture de cette page)	URL unique, paramètre `skill` optionnel
`agent_batch_convert`	Messagerie native	Jusqu’à 50 URL, séquentiel

agent_convert

Convertit une seule URL en utilisant l’extension Chrome via la messagerie native.

Paramètre	Type	Description
`url`	string	L’URL à convertir
`skill`	string (optionnel)	Id ou nom du Skill — son contenu est ajouté au Markdown renvoyé

Renvoie : Contenu Markdown avec titre, URL source, nombre de mots et temps de lecture. Idéal pour : les fils Reddit, les pages protégées par connexion, les sites rendus en JS.

agent_batch_convert

Convertit en lot jusqu’à 50 URL. Les URL sont traitées séquentiellement — l’extension ouvre chaque page dans un onglet en arrière-plan, extrait le contenu, ferme l’onglet, puis passe à la suivante.

Paramètre	Type	Description
`urls`	string[]	Tableau d’URL à convertir (max 50)

Renvoie : Les résultats par URL diffusés au fur et à mesure, plus un résumé. Idéal pour : les workflows de recherche — convertir en lot des fils Reddit, des discussions HN ou des pages concurrentes pour analyse IA.

bridge_convert_url

Convertit une seule URL en récupérant son HTML via l’extension via un pont HTTP local (au lieu de la messagerie native), puis en convertissant côté serveur. Fonctionnellement similaire à agent_convert pour des conversions ponctuelles, mais ne nécessite pas l’hôte de messagerie native — seule l’extension doit être installée et en cours d’exécution.

Paramètre	Type	Description
`url`	string	L’URL à convertir
`extensionId`	string (optionnel)	Remplace l’ID de l’extension (découvert automatiquement à partir de votre clé API si omis)

Toutes les conversions réussies sont automatiquement enregistrées dans votre historique du tableau de bord, avec des résumés et des tags générés par IA.

Exemples d’utilisation

Convertir un fil Reddit

Vous : Convertis ce fil Reddit en Markdown : https://www.reddit.com/r/LangChain/comments/1siwh6q/…Agent : (appelle agent_convert) Voici le fil converti avec 7 commentaires discutant de la précision RAG pour les documents juridiques…

Conversion en lot pour la recherche

Vous : Convertis en lot ces 5 URL Reddit et résume les points clés :

Agent : (appelle agent_batch_convert) 5/5 URL converties avec succès. Voici les points clés…

Convertir des pages protégées par connexion

Vous : Convertis la page du wiki interne de mon entreprise à https://wiki.internal.com/architectureAgent : (appelle agent_convert) Comme vous êtes connecté à ce site dans Chrome, j’ai pu extraire le contenu complet…

Sites pris en charge

Agent Bridge utilise les mêmes 27 extracteurs spécifiques par site que l’extension — chacun sait comment extraire un contenu propre depuis le DOM ou l’API d’un site plutôt que de se rabattre sur le HTML brut de la page.

Réseaux sociaux & discussion (7)

Reddit · Hacker News · Twitter/X · Quora · Xiaohongshu (小红书) · Zhihu (知乎) · Instagram

Exports de conversations IA (2)

Conversations Claude · Autres plateformes de chat IA (ChatGPT, Gemini, etc. via un extracteur DOM partagé)

Docs & bases de connaissances (6)

Wikipedia · arXiv · OpenAI Docs · Sites de docs basés sur Mintlify · Notion · Google Docs

Dev & code (3)

GitHub Issues/PR · Stack Overflow · dev.to

Publication (3)

Medium · Substack · Product Hunt

Plateformes CJK (4)

WeChat (微信公众号) · Bilibili (哔哩哔哩) · Feishu (飞书) — en plus de Xiaohongshu et Zhihu ci-dessus. Le code marque cette catégorie entière comme son groupe d’extracteurs à plus forte différenciation — peu de concurrents gèrent ces plateformes.

Vidéo & média (1)

YouTube (extraction de transcription)

Travail & productivité (5)

Gmail · LinkedIn · Amazon (pages produit) · Canvas LMS · forums XenForo

Toute URL sans extracteur dédié se rabat sur l’extraction HTML de la page complète — cela fonctionne toujours, mais sans le nettoyage spécifique au site (suppression de la navigation, des publicités, des widgets de commentaires, etc.) qu’appliquent les extracteurs spécialisés. Les sites qui exposent une API publique (Reddit, Hacker News, GitHub, Stack Overflow) sont récupérés via cette API lorsque c’est possible — plus rapide et plus fiable que l’ouverture d’un onglet en arrière-plan. Tout le reste ouvre la page dans un onglet en arrière-plan et extrait depuis le DOM rendu.

Dépannage

« Native host not installed » ou « not found »

Chrome n’a pas chargé le manifeste NM. Quittez complètement Chrome (Cmd+Q) et rouvrez-le. Recharger simplement l’extension ne suffit pas.

« Native host has exited » immédiatement

Chrome ne peut pas exécuter le script hôte. Causes courantes :

node introuvable — réexécutez ./install.sh qui utilise le chemin absolu de node
L’hôte se trouve dans un répertoire protégé par TCC (~/Desktop, ~/Documents) — réexécutez l’installation pour déplacer vers ~/.web2md/

« Agent connection error » depuis MCP

Le serveur TCP de l’hôte natif n’est pas en cours d’exécution. Vérifiez que :

Chrome est ouvert
L’extension Web2MD est chargée
La console du Service Worker affiche « TCP relay ready on port 12315 »

« Failed to extract content from the page »

L’extension n’est pas connectée. Ouvrez le popup Web2MD dans Chrome et connectez-vous à votre compte PRO.

« Tab load timeout »

La page cible met trop de temps à charger. C’est normal pour les sites lents. L’extension attend jusqu’à 15 secondes par onglet. Reddit utilise l’extracteur d’API JSON et n’a pas besoin d’onglet, donc les timeouts sur Reddit signifient généralement que l’URL du post est invalide (404).

Les conversions n'apparaissent pas dans l'historique du tableau de bord

L’enregistrement dans l’historique nécessite que l’extension soit connectée avec un compte PRO. L’enregistrement est fire-and-forget — si l’appel API échoue silencieusement, les conversions n’apparaîtront pas. Vérifiez que votre jeton d’authentification est valide.

Différences avec le serveur MCP

Fonctionnalité	`convert_url`	`bridge_convert_url`	`agent_convert` / `agent_batch_convert`
Où ça s’exécute	Appel API côté serveur	L’extension récupère le HTML, le serveur convertit	Votre navigateur Chrome local (messagerie native)
Support Reddit	❌ Bloqué par Reddit	✅ Utilise une vraie session de navigateur	✅ Utilise une vraie session de navigateur
Pages protégées par connexion	❌ Aucun accès	✅ Utilise vos cookies	✅ Utilise vos cookies
Pages rendues en JS	❌ Pas de JavaScript	✅ Rendu Chrome complet	✅ Rendu Chrome complet
Configuration requise	Clé API uniquement	Extension installée + en cours d’exécution	Extension + hôte de messagerie native installés
Traitement en lot	—	URL unique uniquement	Jusqu’à 50 URL (`agent_batch_convert`)
Chrome ouvert requis	Non	Oui	Oui

Règle générale : Utilisez convert_url pour les pages publiques. Utilisez bridge_convert_url quand vous voulez la session de navigateur de l’extension sans installer l’hôte de messagerie native. Utilisez agent_convert / agent_batch_convert pour Reddit, les pages authentifiées, les sites riches en JS, ou quand vous devez traiter en lot — ou souhaitez appliquer un Skill via le paramètre skill d’agent_convert.

Premiers pas

Fonctionnalités principales

Avancé

Forfaits

Vue d’ensemble

Architecture

Configuration

Étape 1 : Construire le serveur MCP

Étape 2 : Installer l’hôte de messagerie native

Étape 3 : Configurer MCP

Étape 4 : Vérifier

Outils disponibles

agent_convert

agent_batch_convert

bridge_convert_url

Exemples d’utilisation

Sites pris en charge

Dépannage

Différences avec le serveur MCP

​Vue d’ensemble

​Architecture

​Configuration

​Étape 1 : Construire le serveur MCP

​Étape 2 : Installer l’hôte de messagerie native

​Étape 3 : Configurer MCP

​Étape 4 : Vérifier

​Outils disponibles

​agent_convert

​agent_batch_convert

​bridge_convert_url

​Exemples d’utilisation

​Sites pris en charge

​Dépannage

​Différences avec le serveur MCP

Vue d’ensemble

Architecture

Configuration

Étape 1 : Construire le serveur MCP

Étape 2 : Installer l’hôte de messagerie native

Étape 3 : Configurer MCP

Étape 4 : Vérifier

Outils disponibles

agent_convert

agent_batch_convert

bridge_convert_url

Exemples d’utilisation

Sites pris en charge

Dépannage

Différences avec le serveur MCP