huimei 0.4.0

pip install huimei

Latest version

Released: Apr 21, 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.

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

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

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)  │──HTTP──▶│   Java Backend (Cloud)  │
│                         │          │                         │
│  ▸ Playwright browser   │          │  ▸ Account management   │
│  ▸ Encrypted cookies    │          │  ▸ Task scheduling      │
│  ▸ Residential IP       │          │  ▸ Subscription billing │
│  ▸ MCP Server           │          │  ▸ Content validation   │
└─────────────────────────┘          └─────────────────────────┘
        "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.

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.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.4.0.tar.gz (48.5 kB view details)

Uploaded Apr 21, 2026 Source

Built Distribution

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

huimei-0.4.0-py3-none-any.whl (62.2 kB view details)

Uploaded Apr 21, 2026 Python 3

File details

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

File metadata

• Download URL: huimei-0.4.0.tar.gz
• Upload date: Apr 21, 2026
• Size: 48.5 kB
• Tags: Source
• Uploaded using Trusted Publishing? No
• Uploaded via: twine/6.2.0 CPython/3.11.8

File hashes

Algorithm	Hash digest
SHA256	ed226d35c29e08701bcb57f275ac14b9ef9019cec2ca6657fdcdcb34bf35966e	Copy
MD5	3cd4539e51cc3485f293bf67b345f34c	Copy
BLAKE2b-256	bbda090e5426380120fb4e28ecf5bdc97b0c77b16027ed02486f10a3cec48b53	Copy

See more details on using hashes here.

File details

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

• Download URL: huimei-0.4.0-py3-none-any.whl
• Upload date: Apr 21, 2026
• Size: 62.2 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	544fffe555393a9e2798d5e9a98c623fc455426c8e1f92e7408442d44e432d3b	Copy
MD5	617adf655cc5119e1c09f781f866a6e3	Copy
BLAKE2b-256	258dce11bef73fc354707e3caf6176fb508c0fd2d4f75575a6a6ad1e87570c23	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