HuiMei — Social Media Automation MCP Server

huimei 0.5.0

pip install huimei

Latest release

Released: May 9, 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

Meta

• License: MIT License (MIT)

• Author: HuiMei Team

• 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

• Requires: Python >=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

• 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

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.

• 🔄 Hybrid execution — Cloud for convenience, local for safety. Auto mode gives you the best of both — tries your local browser first, falls back to cloud if offline.

• ⚡ Zero-config worker — Login once, CLI stays connected. Your WebUI can dispatch tasks to your local machine with no extra setup.

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) ✅ ✅

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

Execution Modes

HuiMei supports three execution modes, configurable via WebUI (Profile → Publish Settings) or CLI:

Mode Description Best For ☁️ Cloud Server-side engine publishes Zero-config, batch publishing 💻 Local CLI opens local browser Residential IP, lower risk 🔄 Auto (default) CLI-first, cloud fallback Best of both worlds

Switch via CLI

huimei login --server prod # Connect to production

Or change in WebUI: Profile → Publish Settings

When using Local or Auto mode, the CLI background worker automatically:

• Connects to backend via WebSocket

• Receives publish tasks from WebUI

• Downloads media files from cloud storage

• Opens local browser with your cookies

• Executes the publish automation

• Reports results back to WebUI

No manual worker management needed — it starts on login and reconnects automatically.

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) │◀──WS──▶│ Java Backend (Cloud) │
│ │──HTTP──▶│ │
│ ▸ Playwright browser │ │ ▸ Account management │
│ ▸ Encrypted cookies │ │ ▸ Task scheduling │
│ ▸ Residential IP │ │ ▸ Execution routing │
│ ▸ MCP Server │ │ ▸ Settings sync │
│ ▸ Background worker │ │ ▸ Subscription billing │
└─────────────────────────┘ └─────────────────────────┘
 "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.

🔄 Settings Sync — Settings changed in WebUI instantly sync to CLI via WebSocket.

Links

• Homepage: huimei.smaroot.tech

• PyPI: pypi.org/project/huimei

• Documentation: huimei.smaroot.tech/docs

• Changelog: CHANGELOG.md

License

MIT © 2026 Beijing HuiGen ZhiYan Technology Co., Ltd (北京慧根智研科技有限责任公司)

Project details

Meta

Release history Release notifications | RSS feed

This version

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 Distribution

huimei-0.5.0.tar.gz (57.2 kB view details)

Uploaded May 9, 2026 Source

Built Distribution

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

huimei-0.5.0-py3-none-any.whl (72.3 kB view details)

Uploaded May 9, 2026 Python 3

File details

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

File metadata

• Download URL: huimei-0.5.0.tar.gz

• Upload date: May 9, 2026

• Size: 57.2 kB

• Tags: Source

• Uploaded using Trusted Publishing? No

• Uploaded via: twine/6.2.0 CPython/3.11.8

File hashes

Algorithm Hash digest SHA256 78b89a473d7fb7319936d2c42e811d4001b123b51e2fb0c74a05f2bcf3e209f0 Copy MD5 7469cdd7d8b7153e8d4f2b9d06c5ae63 Copy BLAKE2b-256 00ea57d800071186e6c2a5f104c661d7bcb18a1075c6750e6ce4e031ea9e5a2b Copy

See more details on using hashes here.

File details

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

• Download URL: huimei-0.5.0-py3-none-any.whl

• Upload date: May 9, 2026

• Size: 72.3 kB

• Tags: Python 3

• Uploaded using Trusted Publishing? No

• Uploaded via: twine/6.2.0 CPython/3.11.8

File hashes

Algorithm Hash digest SHA256 4b7ae2179b7a7c9ad26fef71a3cd358c9e210e079476ad87856cf8597d33f2fe Copy MD5 a7727e7ff349a94e54363b48b4c4ba0f Copy BLAKE2b-256 7424f47b82a1fba8203a8b469b66dae640b853f03795ecd3dd15bffd1f98ee13 Copy

• 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

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