SuperAPI AI 工具集

sales-reporting

营销与增长

查看项目

更新于 10-15 22:15

技能介绍

用途:通过 hubspot 命令行从终端生成销售运营报表,包括每日简报、管线快照和赢/丢单分析。以 hubspot <command> --help 为权威说明,构建在 bulk-operations/SKILL.md 的 JSONL 结构与分页规则之上。

主要能力:搜索待成交与近期更新商机;按阶段或负责人聚合未关闭管线的数量与金额;按时间段统计成单/丢单、按销售代表的赢单率与成单金额;按成交月份汇总收入;调用 hubspot reports 系列在服务端运行已保存报表与 CRM-SQL 报表;用 hubspot sequences enrollments 查看联系人序列报名历史以辅助归因。

用法要点:search/list 每次最多返回 100 行,恰好 100 行通常被截断,聚合前需按 bulk-operations/SKILL.md 分页。CRM 属性值均为字符串,布尔如 hs_is_closed_won 为 "true"/"false",金额为数字字符串;客户端筛选比较字符串,arithmetic 用 tonumber。数值属性可能为 null 或空字符串,tonumber 前须用 select(. != null and . != "") 保护。--properties 返回 {"id","properties":{...}} 嵌套结构,jq 中以 .properties.amount 引用。--filter 中可直接写 hs_is_closed_won=true、hs_is_closed!=true。dealstage 为门户专属 ID,需用 hubspot pipelines stages 映射,或读取 pipelines list/get 内嵌的阶段数组。hubspot_owner_id 为数字字符串,可用 hubspot owners list 解析姓名。日期窗口在 macOS 与 GNU date 下语法不同。

限制:hubspot pipelines 仅支持 app-token,在 user OAuth 下会 403;hubspot owners list 在 user OAuth 与 service key 下均可用。无 team 对象,只能按 hubspot_owner_id 分组后在客户端解析名称。pipelines 不可用时保留原始 ID 并提示,不要让报表失败。reports delete 不可逆,需先 --dry-run,再以 --digest <hash> --confirm "<报表名>" 执行。具体收费、价格与完整平台支持范围资料未提供。