huimei 0.5.7

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

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

# 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_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  (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 (北京慧根智研科技有限责任公司)