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

Uploaded Python 3

File details

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

File metadata

  • Download URL: huimei-0.3.1.tar.gz
  • Upload date:
  • Size: 30.4 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.1.tar.gz
Algorithm Hash digest
SHA256 598175dfc11b11001603fd7d70f5e476000de691730b1163f63d25e3d5dcd552
MD5 38e24e7d3f7eab8f2a039150eb0afd64
BLAKE2b-256 81fc3558f1d9e8d5b25fd422039bbcf215c517cf486b3724974e9f191b1ae5a2

See more details on using hashes here.

File details

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

File metadata

  • Download URL: huimei-0.3.1-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

Hashes for huimei-0.3.1-py3-none-any.whl
Algorithm Hash digest
SHA256 d8535a44d6908f9d34771eeb07179a2f9a398bd5024a0c90f6f20ecbe5b2abf1
MD5 ea7834f97d8977aa0145c1a19d85a432
BLAKE2b-256 a206a33556fb3a243f9678369f9e396e42526378b55e4c86ebec3066586bf6a3

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