Meta

• License: MIT License (MIT)
• Author: HuiMei Team
• Tags mcp , mcp-server , social-media , automation , cli , ai-agent , model-context-protocol , claude , chatgpt , llm-tools , agentic , ai-automation , ai-workflow , computer-use , tiktok , instagram , youtube , twitter , x , threads , linkedin , douyin , xiaohongshu , xhs , bilibili , kuaishou , weibo , zhihu , wechat , toutiao , baijiahao , playwright , rpa , browser-automation , cross-posting , content-publishing , social-media-management , creator-tools , multi-platform , scheduling , marketing-automation
• Requires: Python >=3.10
• Provides-Extra: dev

Classifiers

• Development Status
  • 3 - Alpha
• Environment
  • Console
• Intended Audience
  • Developers
  • End Users/Desktop
  • Information Technology
• License
  • OSI Approved :: MIT License
• Operating System
  • OS Independent
• Programming Language
  • Python :: 3
  • Python :: 3.10
  • Python :: 3.11
  • Python :: 3.12
  • Python :: 3.13
• Topic
  • Internet
  • Internet :: WWW/HTTP
  • Internet :: WWW/HTTP :: Dynamic Content
  • Multimedia
  • Multimedia :: Video
  • Office/Business
  • Software Development :: Libraries :: Python Modules

HuiMei 慧媒 — Chinese Social Media Automation CLI & MCP Server

👁 PyPI version
👁 Python
👁 License: MIT

The first MCP Server for Chinese social media — let AI agents publish to Douyin, XHS, Bilibili, Kuaishou, Weibo, and 6 more platforms through one unified interface.

Why HuiMei?

• 🌏 Only MCP Server for Chinese social media — Covers 11 platforms including 抖音 (Douyin), 小红书 (XHS), B站 (Bilibili), 快手 (Kuaishou), 微博 (Weibo), and more. No other tool does this.
• 🔀 CLI + MCP dual interface — Humans use the terminal (huimei publish), AI agents use the MCP protocol. Same engine, two entry points.
• 🔒 Local-first execution — Playwright runs on your device. Cookies are encrypted and stored locally. Your credentials never leave your machine.
• 🔄 Hybrid execution — Cloud for convenience, local for safety. Auto mode gives you the best of both — tries your local browser first, falls back to cloud if offline.
• ⚡ Zero-config worker — Login once, CLI stays connected. Your WebUI can dispatch tasks to your local machine with no extra setup.

Supported Platforms

Platform ID	Name	Video	Image
douyin	抖音 (Douyin)	✅	✅
xhs	小红书 (Xiaohongshu/RED)	✅	✅
bilibili	B站 (Bilibili)	✅	✅
ks	快手 (Kuaishou)	✅	✅
weibo	微博 (Weibo)	✅	✅
tencent	视频号 (WeChat Channels)	✅	❌
tk	TikTok	✅	❌
toutiao	头条 (Toutiao)	✅	✅
baijiahao	百家号 (Baijiahao)	✅	❌
weixingongzhonghao	微信公众号 (WeChat MP)	❌	✅
zhihu	知乎 (Zhihu)	✅	✅

Installation

Option 1: pip (recommended)

pipinstallhuimei
playwrightinstallchromium

Option 2: pipx (isolated environment)

pipxinstallhuimei
playwrightinstallchromium

Option 3: One-line install script

curl-fsSLhttps://raw.githubusercontent.com/huimei-engine/huimei-cli/main/install.sh|bash

Quick Start

# Log in to your account
huimeilogin

# List supported platforms
huimeiplatforms

# List linked social media accounts
huimeiaccountlist

# Check CLI and connection status
huimeistatus

Execution Modes

HuiMei supports three execution modes, configurable via WebUI (Profile → Publish Settings) or CLI:

Mode	Description	Best For
☁️ Cloud	Server-side engine publishes	Zero-config, batch publishing
💻 Local	CLI opens local browser	Residential IP, lower risk
🔄 Auto (default)	CLI-first, cloud fallback	Best of both worlds

# Switch via CLI
huimeilogin--serverprod# Connect to production
# Or change in WebUI: Profile → Publish Settings

When using Local or Auto mode, the CLI background worker automatically:

• Connects to backend via WebSocket
• Receives publish tasks from WebUI
• Downloads media files from cloud storage
• Opens local browser with your cookies
• Executes the publish automation
• Reports results back to WebUI

No manual worker management needed — it starts on login and reconnects automatically.

MCP Server Integration

MCP (Model Context Protocol) allows AI agents to call external tools as if they were native functions. HuiMei ships a built-in MCP server so agents like Claude, Hermes, and GPT can manage your social media directly.

Claude Code / Claude Desktop

Add to your MCP config (~/.claude/claude_code_config.json or Claude Desktop settings):

{
"mcpServers":{
"huimei":{
"command":"huimei-mcp-server",
"args":[]
}
}
}

Hermes Agent

Add to your Hermes config:

mcp_servers:
huimei:
command:huimei-mcp-server

Available MCP Tools

Tool	Description
huimei_login	Launch browser login flow for a platform
huimei_status	Check CLI status and backend connectivity
huimei_logout	Log out and clear local session
huimei_platforms	List all supported platforms and capabilities
huimei_accounts	List all linked social media accounts
huimei_publish	Create a publish task (video/image to platforms)

Architecture

┌─────────────────────────┐ ┌─────────────────────────┐
│ CLI (Your Device) │◀──WS──▶│ Java Backend (Cloud) │
│ │──HTTP──▶│ │
│ ▸ Playwright browser │ │ ▸ Account management │
│ ▸ Encrypted cookies │ │ ▸ Task scheduling │
│ ▸ Residential IP │ │ ▸ Execution routing │
│ ▸ MCP Server │ │ ▸ Settings sync │
│ ▸ Background worker │ │ ▸ Subscription billing │
└─────────────────────────┘ └─────────────────────────┘
 "The Arm" "The Brain"

CLI is the arm, Backend is the brain. The CLI executes browser automation locally. All business logic, scheduling, and orchestration happen on the backend.

Use Cases

📹 Content Creators — Write once, publish everywhere. Record a video, add your caption, and distribute to all 11 platforms with a single command.

🤖 AI Agents — Let Claude or GPT manage your social media via MCP. Your agent can check account status, schedule posts, and publish content autonomously.

📊 Marketing Teams — Automate matrix account publishing across dozens of accounts and platforms. Integrate into your existing CI/CD or content pipeline.

🔄 Settings Sync — Settings changed in WebUI instantly sync to CLI via WebSocket.

Links

• Homepage: huimei.smaroot.tech
• PyPI: pypi.org/project/huimei
• Documentation: huimei.smaroot.tech/docs
• Changelog: CHANGELOG.md

License

MIT © 2026 Beijing HuiGen ZhiYan Technology Co., Ltd (北京慧根智研科技有限责任公司)

Verified details

These details have been verified by PyPI

Maintainers

👁 Avatar for edward.aming from gravatar.com
edward.aming

Unverified details

These details have not been verified by PyPI

Project links

• Bug Tracker
• Changelog
• Documentation
• Homepage
• Repository

• Download URL: huimei-0.5.0.tar.gz
• Upload date: May 9, 2026
• Size: 57.2 kB
• Tags: Source
• Uploaded using Trusted Publishing? No
• Uploaded via: twine/6.2.0 CPython/3.11.8

Hashes for huimei-0.5.0.tar.gz

Algorithm	Hash digest
SHA256	78b89a473d7fb7319936d2c42e811d4001b123b51e2fb0c74a05f2bcf3e209f0
MD5	7469cdd7d8b7153e8d4f2b9d06c5ae63
BLAKE2b-256	00ea57d800071186e6c2a5f104c661d7bcb18a1075c6750e6ce4e031ea9e5a2b

See more details on using hashes here.

• Download URL: huimei-0.5.0-py3-none-any.whl
• Upload date: May 9, 2026
• Size: 72.3 kB
• Tags: Python 3
• Uploaded using Trusted Publishing? No
• Uploaded via: twine/6.2.0 CPython/3.11.8

Hashes for huimei-0.5.0-py3-none-any.whl

Algorithm	Hash digest
SHA256	4b7ae2179b7a7c9ad26fef71a3cd358c9e210e079476ad87856cf8597d33f2fe
MD5	a7727e7ff349a94e54363b48b4c4ba0f
BLAKE2b-256	7424f47b82a1fba8203a8b469b66dae640b853f03795ecd3dd15bffd1f98ee13

See more details on using hashes here.