# 微生活会员 MCP

WorkBuddy 连接器，自动登录微生活管理系统(manage.acewill.net)，查询会员、储值、消费、优惠券、营销活动等全维度经营数据。

## ✨ 特点

- **零配置** — 无需 API Key、无需管理员，安装即用
- **自动登录** — 首次使用弹出 Chrome 浏览器，登录后 Cookie 自动保存
- **免安装浏览器** — 自动检测系统已有的 Chrome/Edge，不下载额外软件
- **22个报表** — 储值、消费、优惠券、会员、营销、积分全覆盖

## 🚀 安装

### 1. 安装依赖（国内镜像加速）

```bash
# 方式A：一键安装（推荐）
bash install.sh

# 方式B：手动安装
pip install -i https://mirrors.cloud.tencent.com/pypi/simple -r requirements.txt
```

国内可用镜像源：
| 镜像 | 地址 |
|------|------|
| 腾讯云 | `https://mirrors.cloud.tencent.com/pypi/simple` |
| 清华 | `https://pypi.tuna.tsinghua.edu.cn/simple` |
| 阿里云 | `https://mirrors.aliyun.com/pypi/simple` |

### 2. 配置 WorkBuddy

打开 `~/.workbuddy/mcp.json`，添加：

```json
{
  "mcpServers": {
    "微生活会员": {
      "type": "stdio",
      "command": "python3",
      "args": ["路径/server.py"],
      "description": "微生活会员系统数据分析"
    }
  }
}
```

### 3. 刷新 WorkBuddy 连接器 → 信任 → 开始使用

### 🔄 更新到最新版本

```bash
cd 安装目录/welife-mcp
bash update.sh
# 或直接: bash install.sh （自动先 git pull）
```

WorkBuddy 下次调用 MCP 时自动加载新代码，无需重启。

## 📊 可用报表

| 分类 | 报表 |
|------|------|
| 储值 | 储值流水、储值统计 |
| 消费 | 消费流水 |
| 优惠券 | 卡券汇总、券门店核销汇总、券统计分析、券核销明细、券码核销、商城券核销 |
| 会员 | 会员复购、会员等级分析、会员画像、会员发展汇总 |
| 营销 | 营销活动统计 |
| 积分 | 积分统计 |
| 其他 | 日常统计、二维码统计、会员等级售卖、储值卡售卖、手工调账 |

## 🛠 可用工具

| 工具 | 说明 |
|------|------|
| `login` | 弹出浏览器登录微生活后台 |
| `report` | 直接访问指定报表（传入报表名称） |
| `fetch` | 访问任意页面提取数据 |
| `dashboard` | 首页仪表盘 KPI |
| `check` | 检查登录状态 |
| `logout` | 退出登录 |

## 💡 使用示例

```
"登录微生活"           → 弹出 Chrome 完成登录
"查储值统计"           → 按门店查看储值汇总表
"券门店核销汇总"       → 各门店优惠券使用情况
"6月 vs 5月储值对比"   → 自动筛选月份对比计算
"最近一季度营销活动"    → 活动效果分析报告
"查会员手机号138xxx"   → 搜索指定会员信息
"我的储值余额"         → 查看储值余额
"消费记录"             → 查看消费明细
"会员等级分析"         → 会员结构分析
```

## 🎯 支持的操作技能（7大类 50+ 操作）

### 会员管理
会员列表、会员查询、会员详情、会员卡/开卡/批量开卡、储值充值/批量充值、储值余额、消费记录、积分管理/批量积分、会员等级/升降级、会员分组、会员标签、会员注销/锁定/审核、会员还款

### 卡券管理
优惠券列表、新建优惠券、券包管理、发券记录

### 营销活动
活动列表、新建活动、消费有礼、积分活动、裂变活动、秒杀活动、开卡关怀、精准营销、定向发券、评价有礼、签到活动、拼团活动、活动统计、消息推送

### 数据分析报表（22个）
储值流水/统计、消费流水、卡券汇总/核销明细、券门店核销汇总、会员复购/等级分析/画像、营销活动统计、积分统计等

### 机构管理
门店管理、员工管理、角色权限

### 运营工具
二维码管理、消息管理、自动回复、商城管理

## 📁 文件结构

```
welife-mcp/
├── server.py          # MCP 主服务（7个工具）
├── browser.py         # 浏览器 + HTTP 客户端
├── reports.py         # 22个报表 URL
├── skills.py          # 7大类 50+ 操作技能定义
├── install.sh         # 一键安装脚本
├── cookies/           # Cookie 本地存储
└── requirements.txt   # Python 依赖
```