follow-up-boss

Follow Up Boss CLI 是一款专为房地产销售团队设计的命令行工具，提供对 Follow Up Boss CRM 系统的完整 API 接入能力。该工具采用原生 Node.js 构建，零外部依赖，支持人员管理、任务跟踪、交易管道、事件记录等核心 CRM 功能，使团队能够通过脚本自动化日常客户跟进流程。

核心用法方面，用户通过设置 FUB_API_KEY 环境变量完成身份验证后，可使用 node fub.js <command> 格式执行操作。工具涵盖四大功能模块：客户管理（people/person）、活动记录（notes/events/calls/textmessages/emails）、任务系统（tasks）以及交易管理（deals/pipelines）。特别值得注意的是，事件创建（events create）会触发 Follow Up Boss 的自动化工作流，而文本和邮件记录功能仅用于存档，不会实际发送消息。

显著优点包括极致的轻量化和安全性。作为单文件脚本，它仅使用 Node.js 内置的 fetch API，无第三方依赖风险。敏感凭证通过环境变量管理，避免硬编码泄露。功能覆盖全面，从全局搜索到 Webhook 管理，几乎涵盖 FUB 平台的所有核心能力，适合构建自动化工作流。

潜在缺点主要集中在错误处理和输入验证方面。代码中多处使用 JSON.parse() 解析用户输入但缺乏 try-catch 保护，无效 JSON 会导致进程崩溃。URL 查询参数直接字符串拼接，存在编码风险。此外，错误信息可能暴露内部实现细节，且缺乏交互式帮助和版本查看功能。

适合的目标群体主要是房地产经纪人、销售团队负责人和 CRM 系统管理员。对于需要批量处理客户数据、自动化生成报告或集成其他业务系统的技术型销售团队尤为适用。同时，开发者可利用此工具快速原型化与 Follow Up Boss 平台的集成方案。

使用风险包括 API 速率限制（GET /events 仅 20 请求/10 秒），高频操作可能触发限制。数据操作具有不可逆性，删除或更新操作无二次确认机制。由于输入验证薄弱，自动化脚本中传递错误格式的数据可能导致意外行为。建议在生产环境使用前进行充分测试，并实施输入预验证机制。