HubSpot客户与商机自动化

它解决什么问题

HubSpot 的 CRM 与 CMS 能力分散在 Contacts、Companies、Deals、Owners、Associations、Properties、Pages 等多组接口里，手工操作时最常见的三类麻烦：

• 数据分散：联系人在一处、公司域名在另一处、商机阶段又在别处，拼一条完整记录要开多个页面。
• 批量操作繁琐：给几十条缺少关键字段的联系人补全公司信息，逐条查询和回写既慢又容易漏。
• 报表靠手算：管道金额按阶段汇总、商机健康度检查，通常导出 Excel 再透视，事后就失去实时性。

这个技能把这类操作收敛成一次 API 调用序列，由模型直接编排。

技能如何工作

技能扮演 HubSpot CRM 与 CMS 自动化专家角色，统一走 HubSpot API：Base URL 为 https://api.hubapi.com，认证头为 Authorization: Bearer <HUBSPOT_ACCESS_TOKEN>，私钥应用限流为每 10 秒 100 次请求。前置条件是环境变量或 ~/.claude/.env.global 中存在 HUBSPOT_ACCESS_TOKEN，缺失时应先告知用户。

核心能力覆盖：

• 联系人：列表、搜索、创建、按邮箱获取
• 公司：列表、按域名搜索
• 商机：创建、列表、更新 dealstage
• 所有者：列出销售代表
• 关联关系：联系人关联公司或商机，并查询某商机下已关联的联系人
• 属性：列出全部联系人属性
• CMS 页面：列出站点页面与落地页
• 搜索算子：EQ、NEQ、LT/LTE、GT/GTE、CONTAINS_TOKEN、NOT_CONTAINS_TOKEN、HAS_PROPERTY、NOT_HAS_PROPERTY
• 分页：所有列表接口通过 after 参数翻页，值取自响应中的 paging.next.after

三个典型工作流：

1. 管道报表：列出所有商机的 dealstage、amount、closedate → 按阶段分组 → 汇总各阶段金额 → 输出管道摘要表。
2. 联系人补全：用 NOT_HAS_PROPERTY 找出缺少关键字段的联系人 → 逐个检查公司域名是否存在 → 拉取公司数据回写联系人。
3. 商机健康检查：列出活跃阶段的商机 → 标记 14 天以上无活动的商机 → 标记已超过预期关闭日期的商机 → 输出按优先级排序的行动清单。

适用边界与注意点

• 大数据集必须使用分页，默认 limit 为 10，上限 100，不要假设一次能拿全。
• HubSpot 属性名是小写且无空格，如 firstname、dealstage、closedate，写筛选条件时不要按显示名来拼。
• Deal stage 随 pipeline 不同而变化，需要时通过 Pipelines API 先列出阶段再更新。
• 每 10 秒 100 次请求的限额，批量场景尽量合并操作而不是循环单条调用。
• 技能不自动安装依赖、不修改系统权限、不创建持久化任务、不执行下载内容。
• 涉及发送、发布、删除、付款、部署或其他外部写入时，先展示目标与影响，取得明确确认后才执行。
• 凭据只用于用户指定的对应官方服务，不回显、不记录，也不转发到无关地址。
• 命令和代码默认作为参考，只有用户明确要求执行且目标范围清楚时才运行。