1. 基本信息
| 项目 | 内容 | 数据来源 |
|---|---|---|
| 名称 | crm-lookup-hubspot-agent-cli-skills | — |
| 项目自述名称 | HubSpot Agent CLI Skills（合集仓库自身名） | GitHub README |
| 作者/维护者 | HubSpot（CRM/营销 SaaS 厂商），官方组织仓库 | GitHub API |
| 来源链接 | https://github.com/HubSpot/agent-cli-skills/tree/main/crm-lookup | — |
| 许可证 | Apache License 2.0 | GitHub API |
| GitHub Stars | 13（合集仓库整体，含 15 个子技能，不代表本技能个体热度） | GitHub API |
| Forks | 6 | GitHub API |
| 最新版本 | 无正式版本标签，持续滚动提交 | GitHub API |
| 安装方式 | npx skills hubspot/agent-cli-skills/crm-lookup（单装）或 npx skills hubspot/agent-cli-skills（全装 15 个技能） |
官方 README |
2. 功能介绍与亮点
crm-lookup 是 HubSpot 官方 agent-cli-skills 仓库中最基础的检索技能，教编程 Agent 用官方 hubspot CLI 按 ID、邮箱、域名或名称片段精确定位一条联系人、公司、交易或工单记录，并沿关联关系把周边信息一并拉出：
- 多维检索：按 ID 批量取（单次最多约 100 个）、按邮箱/域名精确匹配、按名称片段做 token 级模糊匹配；
- 关联穿透：从一家公司拉出全部关联联系人，从一个联系人拉出其名下全部未结交易，两步 CLI 调用完成，文档明确提醒不要用
xargs逐条起进程； - 纯只读：SKILL.md 正文明确声明“This skill is read-only”，不涉及任何写入或删除操作，是同仓库中风险面最低的技能之一；
- 文档记录了实操陷阱：
~是整词匹配而非子串匹配、搜索单页上限 100 条需配合分页、schema 字段需现查而非硬编码。
3. 适用场景
所属分类：集成与工作流自动化
已经把 HubSpot 作为 CRM 中枢的销售、客服与运营人员，在接通电话、回复邮件或处理工单前，想让 Agent 一条指令查清“这个人是谁、在哪家公司、名下有哪些交易或工单”，不必打开网页界面逐个点开关联记录核对。
4. 跨 Agent 兼容性
- Claude Code：✅ 原生支持——HubSpot 官方帮助中心文档《Use the HubSpot Agent CLI》明确将 Claude Code 列为受支持 Agent，安装进项目
.claude/skills/目录 - Codex：✅ 原生支持——同一官方文档明确列出 OpenAI Codex 为受支持 Agent
- OpenClaw：❓ 未验证——已抓取材料未点名提及
- Hermes Agent：❓ 未验证——已抓取材料未点名提及
（官方文档另提及 Claude Cowork、Cursor、Windsurf 等其他编程 Agent 兼容，但不在本报告评估范围内）
5. 推荐理由
HubSpot 官方维护、全程只读的记录检索技能，把“找到这个人/这家公司/这笔交易的完整关联全貌”这件几乎每次 CRM 交互前都要做的事变成一条终端指令，且零写入风险，是把编程 Agent 接入 CRM 日常查询最安全、最省心的起点。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 7 | HubSpot 为纽交所上市 SaaS 公司官方出品；仓库本身星标不高，但已有外部用户在 issue 中点名描述将 crm-lookup 安装进含 50+ 技能的真实工作区并提出改进建议，属实际采用的具体证据 |
| 可用性 | 8 | 文档单一聚焦、示例完整，明确记录了 token 匹配语义、分页上限等实操陷阱；需先配置 HubSpot 账号访问令牌；技能自身自初次收录后未见后续专属提交 |
| 安全性 | 9 | 见下方检查清单 |
安全检查清单：
① Shell 命令及权限范围——仅通过官方 hubspot CLI 与本地 jq 执行 objects get/objects search/associations list，SKILL.md 正文明确声明“read-only”，未见任何写入或删除指令
② 联网外发——仅连接用户自己 HubSpot 账号的官方 API，目标透明
③ API Key——需设置环境变量 HUBSPOT_ACCESS_TOKEN（私有应用令牌）或走浏览器 OAuth 登录，为标准做法
④ 可疑指令——已读取的 SKILL.md 全文内容清晰、逻辑单一，未见隐藏指令或混淆代码
⑤ 作者信誉——HubSpot 官方组织仓库，提交者为可查的公司员工账号
⑥ License——Apache License 2.0，清晰
⑦ 维护时间——技能内容随仓库一次性收录，仓库整体近日仍有其他技能的提交，非弃置状态
额外亮点：同仓库姊妹技能中唯一在 SKILL.md 正文显式自我声明只读的技能，风险面低于涉及批量写入的姊妹技能
7. 跟同类 Skills 相比的优势
| 方案 | 定位 | 差异化说明 |
|---|---|---|
| claude-office-skills/skills 的 crm-automation | 面向 HubSpot、Salesforce、Pipedrive 三家 CRM 的通用自动化技能，基于 n8n 工作流模板 | 覆盖面更广（多 CRM + 线索捕获/评分/多系统同步等写操作），但没有针对“单条记录精确定位 + 关联穿透”做专门优化，查询意图需要自己拼装工作流 |
| forcedotcom/sf-skills（Salesforce 官方技能集） | Salesforce 官方维护的 Agent 技能集合，面向“在 Salesforce 平台上构建应用”（Apex、Flow、LWC 等开发任务） | 定位是给开发者写 Salesforce 代码用的，不是给一线销售/客服人员通话前查记录用的，与 crm-lookup 的即时检索场景不重合 |
| 直接调用 HubSpot REST API（无 Skill 封装） | 开发者自行查阅官方 API 文档、手写分页与关联遍历逻辑 | 没有内置的 token 匹配语义提醒、关联遍历的两步调用模式，每个新会话都要重新摸索这些细节 |
8. 用户评价
仓库自身 issue 区有外部用户（账号注册于 2017 年、36 个公开仓库）明确点名 crm-lookup：将该技能包安装进已有 50+ 技能的工作区后，反馈 crm-lookup、quote-to-cash 等通用命名难以辨认所属技能包，并提交了本地加 hubspot- 前缀重命名的改进方案，愿意向上游提交 PR。该反馈针对的是技能命名的可辨识度，未涉及功能本身的可用性问题。
9. 其他补充
同一仓库下另有 14 个姊妹技能（如 bulk-operations、sales-reporting、ticket-resolution 等），覆盖批量操作、报表分析、工单处理等场景，crm-lookup 是其中读写风险最低的检索基础技能。
10. 安装使用方式
# 只安装 crm-lookup 一个技能
npx skills hubspot/agent-cli-skills/crm-lookup
# 安装全部 15 个技能
npx skills hubspot/agent-cli-skills安装后注意事项：需先安装并登录官方 hubspot CLI，设置 HUBSPOT_ACCESS_TOKEN（私有应用令牌）或完成浏览器 OAuth 登录；无需重启 Agent，安装完成即可在对话中触发。
11. 注意事项
- 需要一个 HubSpot 账号（含免费版）才能实际使用
- 该 CLI 与 HubSpot 开发者工具
@hubspot/cli（hs命令）是两个不同工具，不要混淆 - 名称匹配（
~）为整词匹配而非任意子串，需要子串过滤应自行接jq - Codex 已获官方文档确认支持；OpenClaw / Hermes Agent 的兼容性未经验证，官方文档未点名