mcpField
H
hubspot

hubspot

github.com/openai营销与增长56040 次安装4 周前更新
代码仓库

关于 hubspot

面向销售团队的 HubSpot 工作流技能，用于获取有依据的 CRM 信息或准备经过审查的记录变更。它强调准确定位、有限读取、明确审批和结果核验。

主要功能

  1. 01确认 HubSpot 访问权限与记录
  2. 02发现属性和枚举值
  3. 03读取 CRM 记录及关联
  4. 04起草并核验已批准的变更
  5. 05遵循连接器操作范围

适用场景

  1. 01销售工作前查看交易或联系人
  2. 02准备属性或关联更新
  3. 03区分相似的 CRM 记录

MCP 相关

通过已开放的 HubSpot 连接器进行身份确认、属性发现、CRM 搜索与读取，以及经审查的写入；可用操作取决于实际连接器能力。

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/openai/role-specific-plugins --skill hubspot

安装后在 Claude Code 中输入/hubspot确认已加载。

附带文件agents/openai.yaml

详细介绍

HubSpot 用户指南

准备可信的 HubSpot 相关上下文，或经过安全审核的 HubSpot 操作，同时确保周边的 Sales 工作流仍是业务任务的权威依据。

通用技能说明

强制要求：如果当前上下文中尚未包含，请阅读并严格遵守 plugins/sales/skills/index/SKILL.md## 跨技能最佳实践。

HubSpot 操作优先级

当用户请求的 HubSpot 任务或记录不明确时，请按以下优先级处理。

  1. 用户明确提出的请求、指定的记录、HubSpot ID、公司、交易、联系人、工单或明确说明的操作
  2. 当前 Sales 工作流所需的只读 CRM 上下文
  3. 根据用户措辞和业务上下文确定的准确记录或高置信度候选记录
  4. 能满足请求的最少属性集、关联、活动上下文或结果页
  5. 经过审核的 HubSpot 变更草稿
  6. 经明确批准且受支持的 HubSpot 写入操作，随后进行验证

不要在未说明的情况下从多个可能的记录中擅自选择，不要将读取操作扩大为写入操作，也不要将澄清视为写入批准。

关键依赖类别

以下依赖对该工作流尤为重要；请根据最佳判断，酌情纳入其他数据源以提高质量。

  • ~~CRM，特别是已公开的 HubSpot 连接器，用于获取 HubSpot 相关的身份、记录、属性、关联、链接和经批准的写入操作
  • 父级 Sales 工作流，用于获取 HubSpot 不负责的 Calendar、Meeting Transcripts、Email、Internal Messaging、Knowledge & Files 或 Sales Intelligence 上下文
  • 用户提供的记录 ID、名称、导出数据、属性值和业务上下文（适用于连接器不可用或需要消除记录歧义的情况）

如果 HubSpot 缺失、不可用、数据陈旧、存在歧义，或受已公开连接器的功能范围限制，请明确说明，并标注答案并非基于 HubSpot。

工作流指南

这些 HubSpot 专属步骤优先于索引技能中的默认工作流。

    1. 确认访问权限和目标
    • 首先使用 get_user_details，确认已连接的门户以及可用对象的读取和写入权限。
    • 确认用户需要的是读取、草稿还是经批准的写入操作；如果会影响答案，请识别对象类型、负责人或团队、管道、时间范围、阶段和确切记录。
    • 如果记录存在歧义，请执行范围最小的候选记录查询，并在将其用于摘要或写入操作前请用户选择。
    1. 查找属性和记录
    • 如果不确定字段，请使用 search_properties，最多输入五个有针对性的关键词；使用 get_properties 确认枚举值和可写属性。
    • 使用 search_crm_objects 进行搜索、计数、筛选、分页和查询关联。已知 ID 时使用 get_crm_objects。不要使用已弃用的 search 或 fetch。
    • 仅获取会影响销售决策的属性和关联。说明筛选条件、总数、页面或样本限制，以及分析是否基于抽样。
    1. 起草、批准并验证
    • 对于拟议的变更，在调用 manage_crm_objects 之前，先展示精确到字段的草稿。
    • 只有在用户明确批准了确切且经过审核的变更或批次后才执行写入。每批最多处理 10 个对象；单独确认关联。
    • 对已审核批次的批准仅适用于该确切批次；绝不要提供可绕过确认的通用批准方式。
    • 检查写入响应；如果响应无法证明操作结果，则通过范围最小的读取操作进行验证。

HubSpot 规则

  • 优先使用精确 ID、域名、邮箱，以及全名加公司进行匹配，避免仅凭模糊姓名匹配。
  • 使用属性或枚举进行查询或写入前，确认属性标签、内部名称、枚举值和可写性；不要猜测。
  • 对于 HubSpot 自有的账户、联系人、交易、工单、负责人、管道和活动事实，以 HubSpot 作为 CRM 事实来源。不要让数据丰富或网络上下文覆盖 CRM 中的事实。
  • 如有可用的连接器返回或可信的 HubSpot 记录 URL（含 UTM 参数），请提供可点击链接。
  • 不要写入推断数据，不要在未获明确同意的情况下覆盖用户输入的上下文，也不要在未获明确批准的情况下更改关联。
  • 不要声称支持实时连接器未提供的对象、属性、分页行为、批量大小或写入操作。

连接器边界

仅使用实际提供的 HubSpot 接口：

  • 身份和访问权限：get_user_details
  • 属性发现：search_properties、get_properties
  • 记录搜索和读取：search_crm_objects、get_crm_objects
  • 经审核的写入：manage_crm_objects

对于不受支持的广泛导出、删除、合并、去重、任意自动化或未提供的对象操作，说明缺少相应接口，并提供范围更窄的读取、草稿或其他经批准的数据源。

模式

1. HubSpot 读取
  • 用于获取公司、交易、联系人、工单、负责人、活动、属性或关联的上下文。
  • 确认目标，仅检索与决策相关的字段，并指出歧义或信息缺口。
输出格式
# [HubSpot 记录或上下文]

## 摘要

- [最重要的 CRM 事实，附可信链接]
- [当前交易、公司、联系人、活动或关联的信号]
- [风险、缺失属性、歧义或来源缺口]

---

{遵循 [限制与改进](../index/SKILL.md#limitations-and-improvements) 中的说明和输出格式／条件}

{遵循 [后续步骤](../index/SKILL.md#4-next-steps) 中的说明和输出格式／条件}
2. HubSpot 更新草稿
  • 用户要求准备备注、属性更改、关联、新建或更新，但尚未批准写入时使用。
  • 将当前值和建议值分开，并明确指出确切目标。
输出格式
# 建议的 HubSpot 更新

**目标：**[记录名称、类型和可信链接或 ID]

| 属性／关联 | 当前值 | 建议值 | 原因／来源 |
| --- | --- | --- | --- |
| [标签] | [当前值或未知] | [建议值] | [有依据的原因＋链接] |

## 写入前

- [所需的缺失信息、关联确认、验证风险或批准]

---

{遵循 [限制与改进](../index/SKILL.md#limitations-and-improvements) 中的说明和输出格式／条件}

{遵循 [后续步骤](../index/SKILL.md#4-next-steps) 中的说明和输出格式／条件}
3. 已批准的 HubSpot 写入
  • 仅在获得对确切的已审核对象或批次的明确批准后使用。
  • 如果写入响应不明确，请在报告完成前进行验证。
输出格式
# HubSpot 已更新

**记录：**[名称、类型和可信链接或 ID]

- **已更改：**[属性或关联]
- **结果：**[已验证的结果]
- **未更改：**[不受支持或已跳过的项目]

---

{遵循 [限制与改进](../index/SKILL.md#limitations-and-improvements) 中的说明和输出格式／条件}

{遵循 [后续步骤](../index/SKILL.md#4-next-steps) 中的说明和输出格式／条件}

评论

支持 Markdown