HuiMei 慧媒 — Chinese Social Media Automation CLI & MCP Server

HuiMei provides a CLI and MCP interface for publishing to supported Chinese social-media platforms through cloud or local browser execution.

Why HuiMei?

🌏 Multi-platform workflow — One command surface for the platforms and content types reported by huimei platforms.
🔀 CLI + MCP dual interface — Humans use the terminal (huimei publish), AI agents use the MCP protocol. Same engine, two entry points.
🔒 Cloud, local, and auto execution — Local mode drives the user's Chrome through a managed Runtime Host; cloud mode runs the same signed automation bundle on the service environment.
🔑 Protected credentials and runtime code — Sensitive payloads use HTTPS/WSS plus application-layer encryption. Local tasks receive short-lived, device-bound encrypted credential envelopes, and automation code is delivered as a signed encrypted Runtime Bundle.
🛡️ Upload-safe preflight — CLI and MCP require a target-bound server Runtime/Catalog preflight before uploading media or creating a publish task.

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

# Actively refresh account status and related work data
huimei account check --account <id> --wait --json

# Synchronize, list and inspect work statistics
huimei works sync --platform zhihu --wait --json
huimei works list --json
huimei works detail <work-id> --json

# Publish using the stable account ID (recommended)
huimei publish -p zhihu --account-id <id> -v ./video.mp4 -t "Title" --json

# Check CLI and connection status
huimei status

# View or update the global publish mode saved on the server
huimei mode
huimei mode auto

# 客户端发布固定使用 headless；账号登录仍会打开有头浏览器
huimei browser show
huimei browser set --chrome-path "/path/to/chrome" --window-size 1440x900

# Machine-readable capabilities and asynchronous task status for AI Agents
huimei agent-context
huimei task-status <task-id> --json

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_account_check`	Refresh account status with batch semantics
`huimei_works_sync`	Synchronize account and work data
`huimei_works_list`	List synchronized works and statistics
`huimei_works_detail`	Read one synchronized work
`huimei_capabilities`	Read the authoritative runtime contract
`huimei_diagnose`	Check local publish-device readiness
`huimei_account_login_start`	Start interactive browser login asynchronously
`huimei_local_task_status`	Query browser-login task status
`huimei_publish`	Create an asynchronous publish task
`huimei_publish_status`	Query the final platform publish status
`huimei_set_mode`	Update the global publish mode

Architecture

CLI / MCP / Web
      │ HTTPS + WSS
      ▼
Huimei Platform ── task, account, device and status coordination
      │
      ├── cloud ──▶ Runtime Host ──▶ managed Python + encrypted Runtime Bundle
      │
      └── local ──▶ Local Worker ──▶ managed Python + encrypted Runtime Bundle ──▶ Chrome

The CLI contains the stable command, transport, Worker, and Runtime Host layers. Platform automation code and its dependency descriptor are versioned independently, so script updates do not normally require a CLI upgrade. Publishing is asynchronous; task creation is not treated as final platform success.

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.

License

mcp mcp-server social-media automation cli ai-agent model-context-protocol claude chatgpt llm-tools agentic ai-automation ai-workflow computer-use tiktok instagram youtube twitter x threads linkedin douyin xiaohongshu xhs bilibili kuaishou weibo zhihu wechat toutiao baijiahao playwright rpa browser-automation cross-posting content-publishing social-media-management creator-tools multi-platform scheduling marketing-automation

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distributions

No source distribution files available for this release.See tutorial on generating distribution archives.

Built Distribution

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

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

huimei-0.6.69-py3-none-any.whl (255.0 kB view details)

Uploaded Aug 12, 2026 Python 3

File details

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

File metadata

Download URL: huimei-0.6.69-py3-none-any.whl
Upload date: Aug 12, 2026
Size: 255.0 kB
Tags: Python 3
Uploaded using Trusted Publishing? No
Uploaded via: twine/6.2.0 CPython/3.13.14

File hashes

Hashes for huimei-0.6.69-py3-none-any.whl
Algorithm	Hash digest
SHA256	`a2571946d0f70e2b1c1b8ecabc3ac4bfc36f701472ddd5a0cd1b69764b4b81e8`
MD5	`b937bd272b440f666e7aa18bf85e7a45`
BLAKE2b-256	`427dce790f72c47855a082cd8f6c3c47733a0f18d84cbb855ec0f48cab07e04a`