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: 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

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.1.tar.gz (72.0 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.1-py3-none-any.whl (80.9 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: huimei-0.5.1.tar.gz
  • Upload date:
  • Size: 72.0 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.1.tar.gz
Algorithm Hash digest
SHA256 3a15faf2157093100a70b8300e26e7e7e70b2a62fe64f826359d1d62ec6b85b8
MD5 b27bcde64277635a7226e85bac239081
BLAKE2b-256 489a29916ed68ba41e5dd3bbef930be210dc3eedef992e326c3734270f9a0e71

See more details on using hashes here.

File details

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

File metadata

  • Download URL: huimei-0.5.1-py3-none-any.whl
  • Upload date:
  • Size: 80.9 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.1-py3-none-any.whl
Algorithm Hash digest
SHA256 b0f4eeb26a9df9154c4e24dc9ec7806ba13d5f10e208f4dcd4289fca911a1f1c
MD5 8696b91e528ca6a0883fbc400fa3bb6c
BLAKE2b-256 d975fc715c6ea4d252df187f0475498107d1959922901b1d5d45b034be07c1c4

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