huimei

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

Metadata

Release files for huimei 0.6.69

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Built distribution (wheel)

Table of built distributions (wheels) for huimei 0.6.69
File	Interpreter	ABI	Platform	Reset
huimei-0.6.69-py3-none-any.whl 255.0 kB Aug 12, 2026 Without provenance	Python 3	none	any	Details

Release files / huimei-0.6.69-py3-none-any.whl

Download URL	huimei-0.6.69-py3-none-any.whl
Size	255.0 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`a2571946d0f70e2b1c1b8ecabc3ac4bfc36f701472ddd5a0cd1b69764b4b81e8`
BLAKE2b-256 checksum How to use checksums	`427dce790f72c47855a082cd8f6c3c47733a0f18d84cbb855ec0f48cab07e04a`
Upload date	Aug 12, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/6.2.0 CPython/3.13.14`

Security for huimei 0.6.69

Report project as malware

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.