Skip to main content

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

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.

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: pipx (recommended)

pipx install huimei

Option 2: One-line install script

curl -fsSL https://huimei.smaroot.tech/install.sh | bash

Option 3: pip inside a virtual environment

python3 -m venv .venv
source .venv/bin/activate
python -m pip install huimei

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

License

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

Project details


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.3.tar.gz (72.6 kB view details)

Uploaded Source

Built Distribution

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

huimei-0.5.3-py3-none-any.whl (81.7 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: huimei-0.5.3.tar.gz
  • Upload date:
  • Size: 72.6 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.11.15

File hashes

Hashes for huimei-0.5.3.tar.gz
Algorithm Hash digest
SHA256 cdffa93504e4572581de090b1330f29107f67e521ff1e9d266453aee59f75f2f
MD5 0964e710fe9e411bf4d34efcd8d5bd49
BLAKE2b-256 025025d41f3a8c25b268da95e42d574ddefe2ccf40e76d71ed6ac44aa9469578

See more details on using hashes here.

File details

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

File metadata

  • Download URL: huimei-0.5.3-py3-none-any.whl
  • Upload date:
  • Size: 81.7 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.11.15

File hashes

Hashes for huimei-0.5.3-py3-none-any.whl
Algorithm Hash digest
SHA256 58a2a71edfe104cbc8b49783c852442533dd49c4b7467eef28d1af0f1963caab
MD5 62973786a04f98efeabd4754ef1e1cce
BLAKE2b-256 b28f18ded56f63ee874d46873f6a895cdbdbb29af94d3814b00c9e460da99582

See more details on using hashes here.

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