Metadata-Version: 2.4
Name: huimei
Version: 0.5.3
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.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>=1.0.0
Requires-Dist: websockets>=12.0
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)

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

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

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