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
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.
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
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) │──HTTP──▶│ Java Backend (Cloud) │
│ │ │ │
│ ▸ Playwright browser │ │ ▸ Account management │
│ ▸ Encrypted cookies │ │ ▸ Task scheduling │
│ ▸ Residential IP │ │ ▸ Subscription billing │
│ ▸ MCP Server │ │ ▸ Content validation │
└─────────────────────────┘ └─────────────────────────┘
"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.
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 (北京慧根智研科技有限责任公司)
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file huimei-0.3.2.tar.gz.
File metadata
- Download URL: huimei-0.3.2.tar.gz
- Upload date:
- Size: 30.5 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.11.8
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
26f965a8789a907c209fe62a637a8535a17ffbde3ba22664e6614e1d327499b1
|
|
| MD5 |
76b1cdee13183d5146687a50cfaa98e3
|
|
| BLAKE2b-256 |
eafca088edc33ceeabb6a20a99f7e62a552562c39a858c7b50c2b36d6095310b
|
File details
Details for the file huimei-0.3.2-py3-none-any.whl.
File metadata
- Download URL: huimei-0.3.2-py3-none-any.whl
- Upload date:
- Size: 40.0 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 |
0bcbc1e192dfa925cc08fb5ab9f03013b6a7375e03e073c5a1615236d52f3b26
|
|
| MD5 |
a93903e68784fd4e4aaaf31d0e61893a
|
|
| BLAKE2b-256 |
f1e73332054555eafd0bc11e22d65ef76b839cad2661fcbb2bad79c784c5d97a
|