用途:通过 HubSpot 命令行按条件构建目标联系人分群,导出 JSONL 供营销活动或后续操作使用。
主要能力:使用 hubspot objects search --type contacts 配合 --filter 做筛选。单个 --filter 为一个 AND 组,多个 --filter 之间为 OR。运算符支持 =、!=、>、>=、<、<=、~(整词匹配,非子串)、@=(IN)、@!=(NOT_IN);HAS_PROPERTY 用裸属性名或 name?,NOT_HAS_PROPERTY 用 !name,日期格式 YYYY-MM-DD。搜索 API 限制:最多 5 个 --filter,每个最多 6 个条件,总计最多 18 个条件;枚举列表优先用 @= / @!=。~ 不支持正则,需先宽搜再用 jq 后过滤。常用字段:lifecyclestage、hubspot_owner_id、hs_email_optout、hs_email_last_open_date、jobtitle、country、city、num_associated_deals。
使用方式:保存分群即保存 JSONL 文件,可复用于更新、导出或重新获取。示例:hubspot objects search --type contacts --filter "lifecyclestage=lead AND hs_email_optout!=true" --properties email,firstname,lastname,jobtitle > segments/opted_in_leads.jsonl。更新前先按 bulk-operations/SKILL.md 做 --dry-run。也可持久化到 HubSpot:segments create/get/members-list/members-add/members-remove/update-filters 管理列表,views create 等管理视图;用 hubspot objects count --type contacts --filter "..." 先估算规模。跨对象场景先筛公司再经 associations list 取联系人 ID,再一次性批量 objects get,需按 --limit/--after 分页,否则超过 100 条会静默截断。
适用场景:近期线索、按职位识别决策者、已互动未成 MQL、地域等分群,以及跨对象公司行业到联系人。
限制:~ 为整词匹配;枚举选项通过 hubspot properties options-list 获取;associations list 无批量 --from 且默认每页 100;超过 100 条结果需按分页循环处理。buyer-intent 为只读信号,需 OAuth 登录,不支持服务密钥。