
XiaoHongShu MCP
par mook-wenyu
Serveur MCP d'automatisation de navigateur pour Xiaohongshu (Little Red Book) — isolation multi-comptes, actions de page atomiques et extraction de contenu via Playwright.
Ce qu'il fait
XiaoHongShu MCP connecte les agents IA à Xiaohongshu (Little Red Book), la principale plateforme sociale lifestyle en Chine. En utilisant RoxyBrowser pour l'isolation persistante du contexte multi-comptes et Playwright CDP pour une automatisation stable du navigateur, il expose un ensemble minimal d'outils atomiques permettant aux agents de naviguer, de rechercher, d'extraire des notes, d'interagir avec le contenu et de gérer des sessions de navigateur — le tout via une interface standard MCP stdio.
Outils
browser_open/browser_close— ouvrir ou fermer une fenêtre de navigateur (chaquedirIdcorrespond à un BrowserContext persistant)page_create/page_list/page_close— gérer les pages au sein d'un contextepage_navigate— naviguer vers une URLpage_click/page_hover/page_scroll/page_type/page_input_clear— interagir avec les éléments de la page à l'aide de localisateurs sémantiques (role/name/label/text/selector) avec mouvement optionnel semblable à l'humainpage_screenshot— capturer une capture d'écran ; renvoie le chemin du fichier par défaut, ou des données PNG brutes avecreturnImage=truepage_snapshot— renvoie un arbre d'accessibilité (a11y) avec url, titre et statistiques d'interactionxhs_session_check— vérifier que la session Xiaohongshu actuelle est authentifiéexhs_navigate_home/xhs_navigate_discover— naviguer vers les sections de Xiaohongshuxhs_search_keyword— effectuer une recherche par mot-clé dans l'application avec une saisie humaniséexhs_collect_search_results— collecter les N premières cartes de notes à partir des résultats de recherchexhs_select_note— faire correspondre et cliquer sur une carte de note par mots-clés sur la page actuellexhs_note_extract_content— extraire le contenu complet d'une note (titre, corps, tags, auteur, statistiques d'interaction) en utilisant l'interception API avec fallback DOMxhs_note_like/xhs_note_unlike/xhs_note_collect/xhs_note_uncollect— interagir avec une notexhs_user_follow/xhs_user_unfollow— suivre ou ne plus suivre l'auteur d'une notexhs_comment_post— poster un commentaire sur la note actuelleresources_listArtifacts/resources_readArtifact— lire les captures d'écran et les snapshots depuis le magasin d'artefactsroxy_workspaces_list/roxy_windows_list/roxy_window_create— gérer les espaces de travail et les fenêtres RoxyBrowser
Installation
Nécessite Node.js ≥ 18, une instance RoxyBrowser en cours d'exécution et un ROXY_API_TOKEN valide.
# Cloner et installer
git clone https://github.com/mook-wenyu/XiaoHongShuMCP
cd XiaoHongShuMCP
npm install # installe également Playwright Chromium via postinstall
# Configurer
cp .env.example .env
# Définir ROXY_API_TOKEN et ROXY_API_BASEURL dans .env
# Démarrer le serveur MCP (stdio)
npm run mcp
claude_desktop_config.json:
{
"mcpServers": {
"xiaohongshu": {
"command": "node",
"args": ["/path/to/XiaoHongShuMCP/dist/mcp/server.js"],
"env": {
"ROXY_API_TOKEN": "your-token",
"ROXY_API_BASEURL": "http://localhost:PORT"
}
}
}
}
Hôtes supportés
Confirmé pour les clients MCP stdio. Claude Desktop est l'hôte de référence principal.






