HuiMei — Social Media Automation MCP Server

AI-native social media automation platform — publish content to 12+ platforms (Douyin, XHS/Xiaohongshu, Bilibili, Kuaishou, Weibo, Zhihu, TikTok, Toutiao, WeChat Channels & more) with a single MCP tool call. Supports video, image, and article publishing with full account management.

View on pypi.org

Documentation

huimei 0.6.45

pip install huimei

Latest release

Released: Jul 23, 2026

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

Navigation

Verified details

These details have been verified by PyPI

Maintainers

edward.aming

Unverified details

These details have not been verified by PyPI

Project links

Bug Tracker
Changelog
Documentation
Homepage
Repository

Classifiers

Development Status
- 3 - Alpha
Environment
- Console
Intended Audience
- Developers
- End Users/Desktop
- Information Technology
License
- OSI Approved :: MIT License
Operating System
- OS Independent
Programming Language
- Python :: 3
- Python :: 3.10
- Python :: 3.11
- Python :: 3.12
- Python :: 3.13
Topic
- Internet
- Internet :: WWW/HTTP
- Internet :: WWW/HTTP :: Dynamic Content
- Multimedia
- Multimedia :: Video
- Office/Business
- Software Development :: Libraries :: Python Modules

Project description

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.

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

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

Project details

Release history Release notifications | RSS feed

This version

0.6.45

Jul 23, 2026

0.6.42

Jul 23, 2026

0.6.41

Jul 23, 2026

0.6.40

Jul 23, 2026

0.6.39

Jul 23, 2026

0.6.37

Jul 23, 2026

0.6.36

Jul 22, 2026

0.6.35

Jul 22, 2026

0.6.34

Jul 22, 2026

0.6.30

Jul 21, 2026

0.6.29

Jul 20, 2026

0.6.28

Jul 20, 2026

0.6.27

Jul 20, 2026

0.6.26

Jul 19, 2026

0.6.25

Jul 19, 2026

0.6.24

Jul 18, 2026

0.6.23

Jul 15, 2026

0.6.22

Jul 15, 2026

0.6.21

Jul 15, 2026

0.6.20

Jul 15, 2026

0.6.19

Jul 15, 2026

0.6.18

Jul 15, 2026

0.6.17

Jul 15, 2026

0.6.16

Jul 15, 2026

0.6.15

Jul 14, 2026

0.6.14

Jul 14, 2026

0.6.13

Jul 14, 2026

0.6.12

Jul 14, 2026

0.6.11

Jul 14, 2026

0.6.10

Jul 14, 2026

0.6.9

Jul 14, 2026

0.6.8

Jul 14, 2026

0.6.7

Jul 14, 2026

0.6.6

Jul 14, 2026

0.6.5

Jul 13, 2026

0.6.4

Jul 13, 2026

0.6.3

Jul 13, 2026

0.6.2

Jul 13, 2026

0.6.1

Jul 13, 2026

0.6.0

Jul 13, 2026

0.5.9

Jul 11, 2026

0.5.8

Jul 11, 2026

0.5.7

Jul 11, 2026

0.5.6

Jul 10, 2026

0.5.5

Jul 10, 2026

0.5.4

Jul 10, 2026

0.5.3

Jul 10, 2026

0.5.2

Jul 10, 2026

0.5.1

Jul 10, 2026

0.5.0

May 9, 2026

0.4.9

May 9, 2026

0.4.8

May 8, 2026

0.4.7

May 8, 2026

0.4.6

May 8, 2026

0.4.5

May 8, 2026

0.4.4

May 8, 2026

0.4.3

May 8, 2026

0.4.2

May 8, 2026

0.4.1

May 8, 2026

0.4.0

Apr 21, 2026

0.3.2

Apr 20, 2026

0.3.1

Apr 20, 2026

0.3.0

Apr 20, 2026

0.2.0

Apr 20, 2026

0.1.3

Apr 20, 2026

0.1.2

Apr 20, 2026

0.1.1

Apr 20, 2026

0.1.0

Apr 19, 2026

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.

huimei-0.6.45-py3-none-any.whl (223.2 kB view details)

Uploaded Jul 23, 2026 Python 3

File details

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

File metadata

Download URL: huimei-0.6.45-py3-none-any.whl
Upload date: Jul 23, 2026
Size: 223.2 kB
Tags: Python 3
Uploaded using Trusted Publishing? No
Uploaded via: twine/6.2.0 CPython/3.13.14

File hashes

Algorithm	Hash digest
SHA256	f11e96f237f6f431ad688940178a892d5e6b147862f65de7f13d03f2545522d6	Copy
MD5	498a2dac96a3829136755c42f6368bbf	Copy
BLAKE2b-256	c027bdd88d8bb749027e3c5b408f77425b9598f84bd820a8de7fefe28b0f1208	Copy

See more details on using hashes here.

English
español
français
日本語
português (Brasil)
українська
Ελληνικά
Deutsch
中文 (简体)
中文 (繁體)
русский
עברית
Esperanto
한국어

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

HuiMei — Social Media Automation MCP Server

Documentation

huimei 0.6.45

Navigation

Verified details

Maintainers

Unverified details

Project links

Meta

Classifiers

Project description

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

Why HuiMei?

Supported Platforms

Installation

Option 1: pipx (recommended)

Option 2: One-line install script

Option 3: pip inside a virtual environment

Quick Start

Log in to your account

List supported platforms

List linked social media accounts

Check CLI and connection status

View or update the global publish mode saved on the server

客户端发布固定使用 headless；账号登录仍会打开有头浏览器

Machine-readable capabilities and asynchronous task status for AI Agents

MCP Server Integration

Claude Code / Claude Desktop

Hermes Agent

Available MCP Tools

Architecture

Use Cases

Links

License

Project details

Meta

Release history Release notifications | RSS feed

Download files

Source Distributions

Built Distribution

File details

File metadata

File hashes