用途:HubSpot CLI 是面向 HubSpot CRM 的命令行工具,用于管理联系人、公司、交易、工单与互动记录,适合在终端中查询或操作 CRM 数据。
主要能力:支持列出与搜索联系人、公司、交易、工单;查看单条记录详情;创建或更新联系人;按管道或阶段筛选交易;查看管道与阶段;列出与创建笔记、任务;查看或创建对象之间的关联。
安装与认证:全局安装命令为 npm install -g @skillhq/hubspot。首次使用需在 HubSpot 中创建 Private App 获取访问令牌(以 pat- 开头),随后运行 hubspot auth 并粘贴令牌。可用 hubspot check 验证认证,hubspot whoami 查看门户信息。
使用方式:多数命令直接调用,如 hubspot contacts、hubspot contact-search "john"、hubspot deals --pipeline-name "WCP"、hubspot task-create --subject "Follow up" --due "2024-12-31" --priority HIGH。列表命令支持 -n 限制数量与 --after 游标分页。所有命令支持 --json 与 --markdown 输出,JSON 可直接通过 jq 处理。
限制:不支持按 HubSpot 保存视图 ID 筛选。若给出类似 /views/57091019/ 的视图 URL,需手动确认其过滤的管道并使用 --pipeline <id>;视图 ID 与管道 ID 不同。ID 为 HubSpot 对象的数字字符串,日期使用 ISO 格式,优先级取 LOW、MEDIUM、HIGH,任务状态取 NOT_STARTED、IN_PROGRESS、COMPLETED。