用途:在 HubSpot CRM 中查找具体记录并沿关联关系还原完整账户视图。该技能为只读操作。命令行为准以 hubspot <command> --help 为准;使用前应先阅读 bulk-operations/SKILL.md,它负责 JSONL 管道、分页、批量获取及查询后写入的安全流程。
主要能力:按 ID 批量获取(单次最多约 100 个 ID);按邮箱或域名精确匹配(需小写归一,多个 --filter 之间为 OR);按名称片段用 ~(CONTAINS_TOKEN,匹配完整空格分词,如 dealname~acme 可匹配 Acme Renewal 但不匹配 AcmeCorp),子串匹配需借助 jq 在客户端收窄;通过 associations list 加 objects get 两次调用获取全部关联记录。属性需从实时 schema 选取,可用 hubspot properties list --type <type> 查看;广告归因字段位于 hs_analytics_*(如 hs_analytics_source、hs_analytics_source_data_1/_2 等)。
使用方式示例(保持原样):hubspot objects get --type contacts 12345 67890 --properties email,firstname,lastname;hubspot objects search --type contacts --filter "email=jane@acme.com" --properties email,firstname;关联查询如 hubspot associations list --from companies:67890 --to contacts | jq -c '{id}' | hubspot objects get --type contacts --properties email,firstname。--from 用复数形式(如 contacts:12345)。
限制:搜索每页最多返回 100 条,更多结果需按 bulk-operations/SKILL.md 的分页循环处理;~ 为分词匹配,子串过滤在 jq 中完成;不存在跨所有字段的全文检索,需指定属性。若查询结果用于后续写入(更新、删除、合并),须遵循 bulk-operations/SKILL.md 中的 --dry-run → digest → --confirm 流程。资料来源未提供更多细节。