geo-prospect

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

GEO Prospect Manager

GEO 潜在客户管理器

Purpose

用途

Manage GEO agency prospects and clients through the full sales lifecycle. All data is stored in

~/.geo-prospects/prospects.json

(persistent across sessions).

通过完整的销售生命周期管理GEO代理的潜在客户与正式客户。所有数据存储在

~/.geo-prospects/prospects.json

中（跨会话持久化保存）。

Commands

命令

Command	What It Does
`/geo prospect new <domain>`	Create new prospect (interactive prompts)
`/geo prospect list`	Show all prospects with pipeline status
`/geo prospect list <status>`	Filter: lead, qualified, proposal, won, lost
`/geo prospect show <id-or-domain>`	Full prospect detail with history
`/geo prospect audit <id-or-domain>`	Run quick GEO audit and save to prospect record
`/geo prospect note <id-or-domain> "<text>"`	Add interaction note with timestamp
`/geo prospect status <id-or-domain> <new-status>`	Move through pipeline
`/geo prospect won <id-or-domain> <monthly-value>`	Mark as won, set contract value
`/geo prospect lost <id-or-domain> "<reason>"`	Mark as lost with reason
`/geo prospect pipeline`	Visual pipeline summary with revenue forecast

命令	功能说明
`/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`	生成可视化销售流程汇总与收入预测

Data Structure

数据结构

Each prospect is stored as a JSON record:

json

{
  "id": "PRO-001",
  "company": "Electron Srl",
  "domain": "electron-srl.com",
  "contact_email": "info@electron-srl.com",
  "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"
}

每个潜在客户以JSON记录的形式存储：

json

{
  "id": "PRO-001",
  "company": "Electron Srl",
  "domain": "electron-srl.com",
  "contact_email": "info@electron-srl.com",
  "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"
}

Orchestration Instructions

流程执行说明

/geo prospect new <domain>

/geo prospect new <domain>

Check if
```
~/.geo-prospects/prospects.json
```
exists, create if not (empty array)
Auto-detect company name from domain (e.g.,
```
electron-srl.com
```
→
```
Electron Srl
```
)
Assign next sequential ID:
```
PRO-001
```
,
```
PRO-002
```
, etc.
Ask user for:
- Contact name (optional)
- Contact email
- Monthly contract value estimate (optional)
Set status to
```
lead
```
Save to JSON file
Suggest next step: "Run
```
/geo prospect audit electron-srl.com
```
to score this prospect"

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

/geo prospect list

/geo prospect list

Read

~/.geo-prospects/prospects.json

and render a summary table:

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

/geo prospect audit <id-or-domain>

Run
```
/geo quick <domain>
```
to get GEO snapshot score
Save score to prospect record:
```
geo_score
```
,
```
audit_date
```

Save audit output to

~/.geo-prospects/audits/<domain>-<date>.md

Update
```
audit_file
```
path in prospect record
Add auto-note: "Quick audit run. GEO Score: XX/100."
If score < 55: suggest "Score indicates strong sales opportunity. Run
```
/geo proposal <domain>
```
to generate proposal."

运行
```
/geo quick <domain>
```
获取GEO快照评分
将评分保存到潜在客户记录的
```
geo_score
```
、
```
audit_date
```
字段

将审核输出保存到

~/.geo-prospects/audits/<domain>-<date>.md

更新潜在客户记录中的
```
audit_file
```
路径
添加自动备注：“已完成快速审核。GEO评分：XX/100。”
若评分<55：建议“评分显示该客户为优质销售机会。运行
```
/geo proposal <domain>
```
生成提案。”

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

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

Find prospect by ID or domain
Append note with current ISO date
Save back to JSON
Confirm: "Note added to Electron Srl (PRO-001)"

通过ID或域名查找潜在客户
添加带当前ISO日期的备注
保存回JSON文件
确认提示：“已为Electron Srl（PRO-001）添加备注”

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

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

Valid statuses:

lead

qualified

proposal

won

lost

Update status field
Add auto-note: "Status changed to <status>"
Save and confirm

有效状态：

lead

、

qualified

、

proposal

、

won

、

lost

更新状态字段
添加自动备注：“状态已更新为<status>”
保存并发送确认

/geo prospect pipeline

/geo prospect pipeline

Visual revenue-focused pipeline summary:

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

Storage Location

存储位置

All data stored in

~/.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

Create directory if it does not exist:

mkdir -p ~/.geo-prospects/audits ~/.geo-prospects/proposals

所有数据存储在

~/.geo-prospects/

目录下：

~/.geo-prospects/
├── prospects.json          # 主CRM数据库
├── audits/                 # 快速审核快照
│   └── electron-srl.com-2026-03-12.md
└── proposals/              # 生成的提案文件
    └── electron-srl.com-proposal.md

若目录不存在则创建：

mkdir -p ~/.geo-prospects/audits ~/.geo-prospects/proposals

Pipeline Stage Definitions

销售流程阶段定义

Status	Meaning	Typical Next Action
`lead`	Discovered, not yet contacted	Run quick audit, assess opportunity
`qualified`	Audit done, confirmed pain points	Generate proposal
`proposal`	Proposal sent, awaiting decision	Follow up, answer questions
`won`	Contract signed, active client	Run full audit, start onboarding
`lost`	Deal closed lost	Log reason for future reference

状态	含义	典型后续操作
`lead`	已发现但尚未联系	运行快速审核，评估机会
`qualified`	已完成审核，确认存在痛点	生成提案
`proposal`	已发送提案，等待决策	跟进，解答疑问
`won`	已签署合同，活跃客户	完成全面审核，启动入职流程
`lost`	交易失败	记录原因以备未来参考

Output

输出

All commands print confirmation + current prospect status to terminal
No external files unless explicitly saving audits/proposals
JSON database is the single source of truth

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