geo-prospect

GEO 潜在客户管理器

目的

在整个销售周期内管理 GEO 代理机构的潜在客户和客户。 所有数据均存储在 ~/.geo-prospects/prospects.json 中（跨会话持久保存）。

---

命令

命令	功能
/geo prospect new <domain>	创建新的潜在客户（通过交互式提示收集信息）
/geo prospect list	显示所有潜在客户及其销售管道状态
/geo prospect list <status>	筛选：lead、qualified、proposal、won、lost
/geo prospect show <id-or-domain>	查看潜在客户的完整详情和历史记录
/geo prospect audit <id-or-domain>	执行快速 GEO 审计并保存到潜在客户记录中
/geo prospect note <id-or-domain> "<text>"	添加带时间戳的互动备注
/geo prospect status <id-or-domain> <new-status>	推进销售管道阶段
/geo prospect won <id-or-domain> <monthly-value>	标记为已赢单并设置合同金额
/geo prospect lost <id-or-domain> "<reason>"	标记为已失单并填写原因
/geo prospect pipeline	以可视化方式汇总销售管道及收入预测

---

数据结构

每个潜在客户都存储为一条 JSON 记录：

{
  "id": "PRO-001",
  "company": "Electron Srl",
  "domain": "electron-srl.com",
  "contact_email": "[email protected]",
  "contact_name": "",
  "industry": "Educational Equipment Manufacturing",
  "country": "Italy",
  "status": "qualified",
  "geo_score": 32,
  "audit_date": "2026-03-12",
  "audit_file": "~/.geo-prospects/audits/electron-srl.com-2026-03-12.md",
  "proposal_file": "~/.geo-prospects/proposals/electron-srl.com-proposal.md",
  "monthly_value": 0,
  "contract_start": null,
  "contract_months": 0,
  "notes": [
    {
      "date": "2026-03-12",
      "text": "Initial GEO quick scan. Score 32/100 - Critical tier. Strong candidate for GEO services."
    }
  ],
  "created_at": "2026-03-12",
  "updated_at": "2026-03-12"
}

---

编排说明

/geo prospect new <domain>

1. 检查 ~/.geo-prospects/prospects.json 是否存在；若不存在，则创建该文件（内容为空数组）
2. 根据域名自动识别公司名称（例如，electron-srl.com → Electron Srl）
3. 分配下一个连续 ID：PRO-001、PRO-002 等
4. 向用户询问：
   • 联系人姓名（可选）
   • 联系人邮箱
   • 预计月度合同金额（可选）
5. 将状态设为 lead
6. 保存到 JSON 文件
7. 建议下一步：“运行 /geo prospect audit electron-srl.com 为此潜在客户评分”

/geo prospect list

读取 ~/.geo-prospects/prospects.json 并生成汇总表：

GEO Prospect Pipeline — March 2026
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

ID       Domain                  Company           Status      Score  Value
───────  ──────────────────────  ────────────────  ──────────  ─────  ──────
PRO-001  electron-srl.com        Electron Srl      Qualified   32/100  €4.5K
PRO-002  acme.com                ACME Corp         Lead        —       —
PRO-003  bigshop.it              BigShop           Won         41/100  €6.0K

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Pipeline: 1 lead | 1 qualified | 0 proposals | 1 won | 0 lost
Committed MRR: €6,000 | Pipeline Value: €4,500

/geo prospect audit <id-or-domain>

1. 运行 /geo quick <domain> 获取 GEO 快照评分
2. 将评分保存到潜在客户记录中：geo_score、audit_date
3. 将审计输出保存到 ~/.geo-prospects/audits/<domain>-<date>.md
4. 更新潜在客户记录中的 audit_file 路径
5. 自动添加备注：“已执行快速审计。GEO 评分：XX/100。”
6. 如果评分 < 55：建议“该评分表明这是一个很有潜力的销售机会。运行 /geo proposal <domain> 以生成提案。”

/geo prospect note <id-or-domain> "<text>"

1. 根据 ID 或域名查找潜在客户
2. 附加带当前 ISO 日期的备注
3. 保存回 JSON 文件
4. 确认：“已为 Electron Srl (PRO-001) 添加备注”

/geo prospect status <id-or-domain> <status>

有效状态：lead、qualified、proposal、won、lost

1. 更新状态字段
2. 自动添加备注：“状态已更改为 ”
3. 保存并确认

/geo prospect pipeline

以收入为重点的可视化销售管道汇总：

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
GEO AGENCY PIPELINE SUMMARY — March 2026
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

STAGE          COUNT   POTENTIAL VALUE   NOTES
─────────────  ─────   ───────────────   ─────────────────────
Lead             2      €8,000/mo        New discoveries
Qualified        1      €4,500/mo        Ready for proposal
Proposal Sent    1      €6,000/mo        Awaiting signature
Won              3      €18,500/mo       Active clients (MRR)
Lost             1      —                Budget freeze

COMMITTED MRR:        €18,500
PIPELINE (qualified+): €10,500
TOTAL POTENTIAL:      €29,000/mo → €348,000/yr

Next actions:
→ PRO-003 (acme.com): Send proposal — score 38/100 (strong case)
→ PRO-007 (shop.it): Follow up — proposal sent 8 days ago
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

---

存储位置

所有数据均存储在 ~/.geo-prospects/ 中：

~/.geo-prospects/
├── prospects.json          # Main CRM database
├── audits/                 # Quick audit snapshots
│   └── electron-srl.com-2026-03-12.md
└── proposals/              # Generated proposals
    └── electron-srl.com-proposal.md

如果目录不存在，则创建：mkdir -p ~/.geo-prospects/audits ~/.geo-prospects/proposals

---

销售管道阶段定义

状态	含义	典型的下一步操作
lead	已发现，尚未联系	执行快速审计，评估机会
qualified	已完成审计，确认了痛点	生成提案
proposal	已发送提案，等待决定	跟进并解答问题
won	已签订合同，成为正式客户	执行完整审计，开始 onboarding
lost	交易已关闭，未能赢单	记录原因以供日后参考

---

输出

• 所有命令都会在终端打印确认信息和当前潜在客户状态
• 除非明确保存审计或提案，否则不会生成外部文件
• JSON 数据库是唯一可信数据源