# Fumamx Crm

> Use when 需要操作孚盟MX CRM（查客户/创建客户/查报价/查订单/同步数据）时。路由：孚盟CRM同步走此技能（内置去重+数据映射），禁止直接调 fumamx_* 工具（会绕过同步逻辑）

- Skill: `wike-chi/fumamx-crm` (Agent Skill, multi-file: 15 files)
- Install (CLI): `npx skillmds@latest add wike-chi/fumamx-crm`
- Raw SKILL.md: https://api.skillmd.com/api/skills/wike-chi/fumamx-crm/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: wike-chi (https://skillmd.com/u/wike-chi)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/wike-chi/fumamx-crm

---


## 架构 (v2.0 B+C)

```
Agent (holo-desktop)
  │
  ├─ MCP 工具调用 (首选) ──── fumamx-mcp-server ──── HTTP API ──── 孚盟后端
  │                          (23 tools, Zod schema)    (逆向中)
  │
  └─ CDP 浏览器自动化 (降级) ── Chrome CDP ── 孚盟 SPA 页面
                                (scripts/*.ts)
```

**B 路线 (API 逆向)**: `scripts/capture-api.py` 捕获孚盟内部 API → `ApiFumamxClient` 直调 HTTP
**C 路线 (MCP Server)**: `mcp-server/` 将 10 大模块封装为 23 个 MCP 结构化工具

### MCP Server 工具清单

启动: `cd mcp-server && npm start`

| # | 工具名 | 模块 | 操作 |
|---|--------|------|------|
| 1 | `fumamx_search_customers` | 客户 | 按条件搜索客户 |
| 2 | `fumamx_get_customer` | 客户 | 查看客户详情 |
| 3 | `fumamx_create_customer` | 客户 | 创建客户 |
| 4 | `fumamx_update_customer` | 客户 | 更新客户信息 |
| 5 | `fumamx_delete_customer` | 客户 | 删除客户（回收站） |
| 6 | `fumamx_check_duplicate` | 客户 | 客户查重 |
| 7 | `fumamx_list_contacts` | 联系人 | 查看联系人列表 |
| 8 | `fumamx_add_contact` | 联系人 | 新增联系人 |
| 9 | `fumamx_update_contact` | 联系人 | 更新联系人 |
| 10 | `fumamx_list_followups` | 跟进 | 查看跟进历史 |
| 11 | `fumamx_add_followup` | 跟进 | 添加跟进记录 |
| 12 | `fumamx_list_quotations` | 报价单 | 查看报价单列表 |
| 13 | `fumamx_create_quotation` | 报价单 | 新建报价单 |
| 14 | `fumamx_list_orders` | 销售订单 | 查看订单列表 |
| 15 | `fumamx_create_order` | 销售订单 | 新建销售订单 |
| 16 | `fumamx_send_email` | 邮件 | 发送邮件 |
| 17 | `fumamx_check_inbox` | 邮件 | 检查收件箱 |
| 18 | `fumamx_add_to_nurture` | 培育 | 加入培育序列 |
| 19 | `fumamx_get_nurture_status` | 培育 | 查看培育状态 |
| 20 | `fumamx_claim_public_customer` | 公海 | 领取公海客户 |
| 21 | `fumamx_get_daily_tasks` | 任务 | 查看今日任务 |
| 22 | `fumamx_complete_task` | 任务 | 完成任务 |
| 23 | `fumamx_get_stats` | 统计 | 销售数据概览 |

### API 逆向 (capture-api.py)

```bash
# 1. 启动 Chrome 远程调试

> **Skill Graph：** 领域 → [[_index-conversion|报价与转化领域]] | 上游 ← [[crm|通用CRM]] ← [[_index-conversion|转化领域]] | 下游 → [[fumamx-update|CRM客户更新]]

chrome.exe --remote-debugging-port=9222

# 2. 登录孚盟
# 打开 https://fumamx.com/#/login 并登录

# 3. 运行捕获脚本
cd scripts && python capture-api.py

# 4. 在 Chrome 中操作孚盟各个模块
# (查客户 → 建报价单 → 发邮件 → ...)

# 5. Ctrl+C 停止，输出 captured-apis.json
```

捕获的 API 端点用于填充 `ApiFumamxClient` 的端点路径，替换占位符 URL。

---

## CDP 降级路径 (v1.x 保留)

当 MCP Server 不可用或 API 端点未知时，降级使用 CDP 浏览器自动化:

| 脚本 | 功能 |
|------|------|
| `scripts/query-customer.ts` | 查询客户 |
| `scripts/create-customer.ts` | 创建客户 |
| `scripts/update-customer.ts` | 更新客户 |
| `scripts/batch-operations.ts` | 批量操作 |
| `scripts/add-to-nurture.ts` | 添加到培育 |
| `scripts/selectors.ts` | DOM 选择器配置 (Element Plus) |

### 安全策略
- 私人信息（手机号、邮箱、客户详情）永不在消息中暴露
- 每次CRM操作后记录操作日志
- 定期备份（每两周）
- 批量操作（>10条）需管理员审批

### 孚盟访问信息

| 配置项 | 值 |
|------|-----|
| **登录URL** | https://fumamx.com/#/login |
| **UI 框架** | Vue + Element Plus (el-*) |
| **路由模式** | SPA hash routing (/#/...) |
| **API 端点** | 待捕获 (运行 capture-api.py) |