HuiMei — Social Media Automation MCP Server

AI-native social media automation platform — publish content to 12+ platforms (Douyin, XHS/Xiaohongshu, Bilibili, Kuaishou, Weibo, Zhihu, TikTok, Toutiao, WeChat Channels & more) with a single MCP tool call. Supports video, image, and article publishing with full account management.

View on pypi.org

Documentation

huimei 0.5.0

pip install huimei

Latest release

Released: May 9, 2026

MCP Server & CLI for social media automation — let AI agents publish to TikTok, Instagram, YouTube, Douyin, XHS, Bilibili and 15+ platforms via Model Context Protocol

Navigation

Verified details

These details have been verified by PyPI

Maintainers

edward.aming

Unverified details

These details have not been verified by PyPI

Project links

Bug Tracker
Changelog
Documentation
Homepage
Repository

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

Project description

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

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)

pip install huimei playwright install chromium

Option 2: pipx (isolated environment)

pipx install huimei playwright install chromium

Option 3: One-line install script

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

Quick Start

Log in to your account

huimei login

List supported platforms

huimei platforms

List linked social media accounts

huimei account list

Check CLI and connection status

huimei status

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

huimei login --server prod # 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.

License

Project details

Release history Release notifications | RSS feed

This version

0.5.0

May 9, 2026

0.4.9

May 9, 2026

0.4.8

May 8, 2026

0.4.7

May 8, 2026

0.4.6

May 8, 2026

0.4.5

May 8, 2026

0.4.4

May 8, 2026

0.4.3

May 8, 2026

0.4.2

May 8, 2026

0.4.1

May 8, 2026

0.4.0

Apr 21, 2026

0.3.2

Apr 20, 2026

0.3.1

Apr 20, 2026

0.3.0

Apr 20, 2026

0.2.0

Apr 20, 2026

0.1.3

Apr 20, 2026

0.1.2

Apr 20, 2026

0.1.1

Apr 20, 2026

0.1.0

Apr 19, 2026

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

huimei-0.5.0.tar.gz (57.2 kB view details)

Uploaded May 9, 2026 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

huimei-0.5.0-py3-none-any.whl (72.3 kB view details)

Uploaded May 9, 2026 Python 3

File details

Details for the file huimei-0.5.0.tar.gz.

File metadata

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

File hashes

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

See more details on using hashes here.

File details

Details for the file huimei-0.5.0-py3-none-any.whl.

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

File hashes

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

English
español
français
日本語
português (Brasil)
українська
Ελληνικά
Deutsch
中文 (简体)
中文 (繁體)
русский
עברית
Esperanto
한국어

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page

HuiMei — Social Media Automation MCP Server

Documentation

huimei 0.5.0

Navigation

Verified details

Maintainers

Unverified details

Project links

Meta

Classifiers

Project description

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

Why HuiMei?

Supported Platforms

Installation

Option 1: pip (recommended)

Option 2: pipx (isolated environment)

Option 3: One-line install script

Quick Start

Log in to your account

List supported platforms

List linked social media accounts

Check CLI and connection status

Execution Modes

Switch via CLI

Or change in WebUI: Profile → Publish Settings

MCP Server Integration

Claude Code / Claude Desktop

Hermes Agent

Available MCP Tools

Architecture

Use Cases

Links

License

Project details

Meta

Release history Release notifications | RSS feed

Download files

Source Distribution

Built Distribution

File details

File metadata

File hashes

File details

File hashes