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 秒），高频操作可能触发限制。数据操作具有不可逆性，删除或更新操作无二次确认机制。由于输入验证薄弱，自动化脚本中传递错误格式的数据可能导致意外行为。建议在生产环境使用前进行充分测试，并实施输入预验证机制。

核心用法

Follow Up Boss (CLI) 技能是一个基于 Node.js 的命令行工具，旨在为房地产专业人士和销售团队提供高效、便捷的客户关系管理（CRM）途径。通过该技能，用户可以直接从终端与 Follow Up Boss 平台的 API 进行交互，无需打开网页后台。

其核心功能覆盖了销售工作的全流程：
1. 线索与联系人管理：使用 people create 或 events create 命令快速录入新线索，并自动触发平台内的自动化规则；通过 people 命令搜索、筛选和查看所有联系人详情。
2. 销售活动记录：可记录与客户的所有交互，包括创建 notes（备注）、calls（通话）、emails（邮件）和 textmessages（短信），确保客户沟通历史完整、可追溯。
3. 任务与交易推进：创建和完成待办 tasks（任务），管理 deals（交易）及其所在 pipelines（管道），帮助用户聚焦于即将成交的业务。
4. 系统管理：支持管理 webhooks（网络钩子）、查询 users（用户）和 sources（线索来源），具备一定的管理能力。

显著优点

• 极致轻量与安全：该技能的一个巨大优势是其零外部依赖的特性。它仅使用 Node.js 内置模块，不包含任何第三方库，从而极大地缩小了供应链攻击面，确保了代码环境的纯净与安全。
• 原生集成与自动化：通过官方的 /events 端点创建记录，不仅仅是数据录入，更能直接触发 Follow Up Boss 平台配置好的智能自动化流程（如自动分配代理人、发送欢迎邮件等），实现真正意义上的提效。
• 操作透明高效：对于习惯命令行的开发者和高级用户，这比图形界面操作更快捷。所有命令和数据结构清晰明了，可以轻松集成到脚本或自动化工作流中，实现批量操作。
• 网络安全可信：所有数据传输都经由 HTTPS 发送到官方 SaaS 平台 api.followupboss.com，不经过第三方服务器，确保了客户数据在传输过程中的安全性和隐私性。

潜在缺点或局限性

• 文档与合规缺失：项目由个人开发者维护，未包含开源许可证（LICENSE）文件，对于企业用户来说，存在法律合规风险。
• 来源可信度较低（T3）：相较于由知名公司或基金会背书的项目，社区个人项目的长期稳定性和安全性保证较弱，未来版本更新可能引入未知风险。
• 纯记录而非真实发送：需特别注意，创建短信 (textmessages) 和邮件 (emails) 的命令只是记录日志，并不能真正发送消息。实际发送仍需依赖 Follow Up Boss 内置功能或其它集成服务，新手容易对此产生误解。
• 缺乏输入校验：CLI 接收用户提供的 JSON 数据，但代码本身未对 JSON 字段进行严格的结构或白名单校验，用户可能因拼写错误或格式不当导致 API 调用失败，甚至意外发送不支持的字段。

适合的目标群体

1. 房地产团队队长与技术型经纪人：习惯于使用脚本和自动化工具来管理大量线索，希望将 CRM 操作集成到自己的工作流中，提升团队整体效率。
2. 运维与集成工程师：需要将 Follow Up Boss 的数据与内部系统进行对接，或通过脚本进行批量数据维护和清洗。
3. 具有命令行经验的中小企业主：希望以最直接、可编程的方式深度使用 Follow Up Boss，而不满足于标准 Web 界面的功能限制。

使用风险提示

• 凭证泄露风险：技能必须从环境变量 FUB_API_KEY 中读取 API 密钥。若运行环境被攻破，该密钥可能被窃取，用于未授权访问完整的 CRM 数据，造成客户信息泄露。建议遵循最小权限原则创建 API 密钥，并考虑定期轮换。
• 平台依赖与速率限制：该技能是 Follow Up Boss 平台的专属工具，其可用性完全依赖于官方服务的稳定性和 API 速率限制（如 GET /events 为 20 次/10 秒），大量的操作可能触发限制导致任务中断。
• 误操作风险：由于是命令行，没有图形界面的确认弹窗，一个错误的 DELETE 或 POST 命令可能导致关键数据丢失或污染。使用者必须对所执行命令有明确认知。