| name | fumamx-crm |
| version | 2.0.0 |
| description | Use when 需要操作孚盟MX CRM（查客户/创建客户/查报价/查订单/同步数据）时。路由：孚盟CRM同步走此技能（内置去重+数据映射），禁止直接调 fumamx_* 工具（会绕过同步逻辑） |
| always | false |
| triggers | ["孚盟CRM","添加到CRM","搜索客户","创建客户","更新客户","删除客户","批量添加到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 | 公海 | 领取公海客户 |
|
API 逆向 (capture-api.py)
> **Skill Graph：** 领域 → [[_index-conversion|报价与转化领域]] | 上游 ← [[crm|通用CRM]] ← [[_index-conversion|转化领域]] | 下游 → [[fumamx-update|CRM客户更新]]
chrome.exe --remote-debugging-port=9222
cd scripts && python capture-api.py
捕获的 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条）需管理员审批
孚盟访问信息
