HuiMei — Social Media Automation MCP Server

Plateforme d'automatisation des médias sociaux native IA — publiez du contenu sur plus de 12 plateformes (Douyin, XHS/Xiaohongshu, Bilibili, Kuaishou, Weibo, Zhihu, TikTok, Toutiao, WeChat Channels et plus) avec un seul appel d'outil MCP. Prend en charge la publication de vidéos, d'images et d'articles avec une gestion complète des comptes.

Voir sur pypi.org

Documentation

huimei 0.6.69

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

pip install huimei

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 --wait --json

Synchronize, list and inspect work statistics

huimei works sync --platform zhihu --wait --json huimei works list --json huimei works detail --json

Publish using the stable account ID (recommended)

huimei publish -p zhihu --account-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 --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

Project links

Bug Tracker
Changelog
Documentation
Homepage
Repository

Key dates

PyPI data

Data sourced directly from PyPI's database.

Released: Aug 12, 2026 Latest release

1 maintainer

PyPI data

edward.aming

Credits

Author: HuiMei Team

License

MIT License (MIT)

Requires

Python <3.15, >=3.10

Provides Extra

dev

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
- Python :: 3.14
Topic
- Internet
- Internet :: WWW/HTTP
- Internet :: WWW/HTTP :: Dynamic Content
- Multimedia
- Multimedia :: Video
- Office/Business
- Software Development :: Libraries :: Python Modules

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.69-py3-none-any.whl (255.0 kB view details)

Uploaded Aug 12, 2026Python 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

Algorithm	Hash digest
SHA256	a2571946d0f70e2b1c1b8ecabc3ac4bfc36f701472ddd5a0cd1b69764b4b81e8	Copy
MD5	b937bd272b440f666e7aa18bf85e7a45	Copy
BLAKE2b-256	427dce790f72c47855a082cd8f6c3c47733a0f18d84cbb855ec0f48cab07e04a	Copy

See more details on using hashes here.

Release history Release notifications | RSS feed

This release

0.6.69

Aug 12, 2026

0.6.67

Aug 4, 2026

0.6.66

Aug 4, 2026

0.6.65

Aug 3, 2026

0.6.64

Aug 3, 2026

0.6.63

Aug 3, 2026

0.6.62

Aug 3, 2026

0.6.61

Aug 2, 2026

0.6.60

Aug 1, 2026

0.6.59

Jul 30, 2026

0.6.58

Jul 25, 2026

0.6.57

Jul 25, 2026

0.6.51

Jul 25, 2026

0.6.50

Jul 24, 2026

0.6.49

Jul 24, 2026

0.6.48

Jul 24, 2026

0.6.47

Jul 24, 2026

0.6.46

Jul 24, 2026

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

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 Sentry Error logging StatusPage Status page

HuiMei — Social Media Automation MCP Server

Documentation

huimei 0.6.69

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

Actively refresh account status and related work data

Synchronize, list and inspect work statistics

Publish using the stable account ID (recommended)

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 links

Key dates

1 maintainer

Credits

License

Requires

Provides Extra

Tags

Classifiers

Download files

Source Distributions

Built Distribution

File details

File metadata

File hashes

Release history Release notifications | RSS feed