Metadata-Version: 2.4
Name: huimei
Version: 0.6.25
Summary: 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
Author-email: HuiMei Team <chenjianan@smaroot.tech>
License: MIT
Project-URL: Homepage, https://huimei.smaroot.tech
Project-URL: Documentation, https://huimei.smaroot.tech/developer
Project-URL: Repository, https://codeup.aliyun.com/6832d8ec9c32f0e37238744f/huimei-cli
Project-URL: Bug Tracker, https://codeup.aliyun.com/6832d8ec9c32f0e37238744f/huimei-cli/issues
Project-URL: Changelog, https://codeup.aliyun.com/6832d8ec9c32f0e37238744f/huimei-cli/blob/main/CHANGELOG.md
Keywords: 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
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: End Users/Desktop
Classifier: Intended Audience :: Information Technology
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Internet
Classifier: Topic :: Internet :: WWW/HTTP
Classifier: Topic :: Internet :: WWW/HTTP :: Dynamic Content
Classifier: Topic :: Multimedia
Classifier: Topic :: Multimedia :: Video
Classifier: Topic :: Office/Business
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: <3.14,>=3.10
Description-Content-Type: text/markdown
Requires-Dist: typer>=0.12.0
Requires-Dist: httpx>=0.27.0
Requires-Dist: rich>=13.0.0
Requires-Dist: playwright==1.61.0
Requires-Dist: pydantic>=2.0.0
Requires-Dist: pycryptodome>=3.20.0
Requires-Dist: keyring>=25.0.0
Requires-Dist: mcp<2.0.0,>=1.28.0
Requires-Dist: websockets>=12.0
Requires-Dist: certifi>=2026.6.17
Requires-Dist: jsonpath==0.82.2
Requires-Dist: jsonschema<5.0.0,>=4.23.0
Requires-Dist: packaging<27,>=24.2
Requires-Dist: tzdata>=2025.2; sys_platform == "win32"
Requires-Dist: tomli>=2.0.0; python_version < "3.11"
Provides-Extra: dev
Requires-Dist: pytest>=8.0.0; extra == "dev"
Requires-Dist: pytest-asyncio>=0.23.0; extra == "dev"
Requires-Dist: build; extra == "dev"
Requires-Dist: twine; extra == "dev"

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

[![PyPI version](https://img.shields.io/pypi/v/huimei)](https://pypi.org/project/huimei/)
[![Python](https://img.shields.io/pypi/pyversions/huimei)](https://pypi.org/project/huimei/)
[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)

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)

```bash
pipx install huimei
```

### Option 2: One-line install script

```bash
curl -fsSL https://huimei.smaroot.tech/install.sh | bash
```

### Option 3: pip inside a virtual environment

```bash
python3 -m venv .venv
source .venv/bin/activate
python -m pip install huimei
```

## Quick Start

```bash
# 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 <task-id> --json
```

## MCP Server Integration

[MCP (Model Context Protocol)](https://modelcontextprotocol.io/) 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):

```json
{
  "mcpServers": {
    "huimei": {
      "command": "huimei-mcp-server",
      "args": []
    }
  }
}
```

### Hermes Agent

Add to your Hermes config:

```yaml
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

```text
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.

## Links

- **Homepage:** [huimei.smaroot.tech](https://huimei.smaroot.tech)
- **PyPI:** [pypi.org/project/huimei](https://pypi.org/project/huimei/)
- **Documentation:** [huimei.smaroot.tech/docs](https://huimei.smaroot.tech/docs)
- **Changelog:** [CHANGELOG.md](https://github.com/huimei-engine/huimei-cli/blob/main/CHANGELOG.md)

## License

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