Skip to main content

AI-powered social media automation CLI & MCP Server — publish to Douyin, XHS, Bilibili, Kuaishou, Weibo and 11 Chinese social platforms from terminal or AI agents

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.3.0.tar.gz (30.2 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.3.0-py3-none-any.whl (39.9 kB view details)

Uploaded Python 3

File details

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

File metadata

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

File hashes

Hashes for huimei-0.3.0.tar.gz
Algorithm Hash digest
SHA256 052b9e40d8f3da36ed514533912f6c105527a895fa268696540be4a0f8b2470d
MD5 002b84b403c6ed695d3e44f252125b5e
BLAKE2b-256 521d09fe96518a77be01496f81c414a327bec128506525360af223bf96011f59

See more details on using hashes here.

File details

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

File metadata

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

File hashes

Hashes for huimei-0.3.0-py3-none-any.whl
Algorithm Hash digest
SHA256 3c7626425cf5b105a8aa79340b34f9f03d23d553a4f3eeef5fe292360a7176c5
MD5 31512876431af05af9e4731c42f104fe
BLAKE2b-256 f27bf3f29ccb3aa777eb2d2a765aff82f283489b5f800dfd7e33758ae3c3872e

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