Awesome Claude Skills与HubSpot集成：终极HubSpot自动化工具指南

【免费下载链接】awesome-claude-skills A curated list of awesome Claude Skills, resources, and tools for customizing Claude AI workflows 项目地址: https://gitcode.com/GitHub_Trending/aw/awesome-claude-skills

Awesome Claude Skills是一个精选的Claude技能和工具列表，专为定制Claude AI工作流而设计。其中，HubSpot自动化工具通过Composio集成，让用户能够轻松实现HubSpot CRM的自动化操作，包括联系人管理、公司记录维护、交易跟踪和自定义属性创建等核心功能，无需编写复杂代码即可提升工作效率。

HubSpot自动化工具简介 🚀

HubSpot自动化工具是Awesome Claude Skills项目中的明星功能，它通过Rube MCP（模块化计算平台）实现与HubSpot CRM的无缝集成。该工具允许用户通过简单的指令序列，完成从联系人创建到交易跟踪的全流程自动化，特别适合需要高效管理客户关系的团队和个人使用。

核心功能亮点

• 无代码自动化：无需编程知识，通过预设工具序列实现复杂CRM操作
• 批量处理能力：支持最多100条记录的批量创建和更新
• 全流程覆盖：涵盖联系人、公司、交易、工单和自定义属性管理
• 智能防重复：内置搜索机制避免创建重复记录
• 灵活的过滤系统：通过高级筛选条件快速定位所需数据

快速开始：3步实现HubSpot集成 ⚡

1. 环境准备

在开始使用HubSpot自动化工具前，请确保满足以下先决条件：

• Rube MCP已连接（可通过RUBE_SEARCH_TOOLS命令验证）
• 通过RUBE_MANAGE_CONNECTIONS建立与HubSpot的有效连接
• 连接状态需显示为"ACTIVE"（可通过HUBSPOT_GET_ACCOUNT_INFO验证）

2. 简易安装步骤

获取Rube MCP服务非常简单，只需在客户端配置中添加MCP服务器：https://rube.app/mcp，无需API密钥，添加端点即可使用。

3. 验证连接

1. 调用RUBE_SEARCH_TOOLS确认工具可用
2. 执行HUBSPOT_GET_ACCOUNT_INFO验证授权状态
3. 检查返回结果中的账户信息，确保连接成功

五大核心工作流详解 🔍

1. 联系人创建与管理

适用场景：当需要添加新客户或更新现有联系人信息时使用。

推荐工具序列：

1. HUBSPOT_SEARCH_CONTACTS_BY_CRITERIA - 搜索现有联系人避免重复
2. HUBSPOT_CREATE_CONTACT - 创建单个联系人
   • 必要参数：properties对象包含email、firstname、lastname等信息
3. 或使用HUBSPOT_CREATE_CONTACTS进行批量创建（最多100条）

示例：创建新联系人时，系统会先搜索相同邮箱的记录，确保数据库中没有重复项后再执行创建操作。

2. 公司记录管理

适用场景：需要添加新公司或更新公司信息时使用。

工具序列：

1. HUBSPOT_SEARCH_COMPANIES - 搜索现有公司记录
2. HUBSPOT_CREATE_COMPANIES - 批量创建公司（最多100条）
3. HUBSPOT_UPDATE_COMPANIES - 批量更新公司信息

关键提示：公司属性必须使用内部名称而非显示标签，可通过HUBSPOT_READ_ALL_PROPERTIES_FOR_OBJECT_TYPE命令获取正确的属性名称。

3. 交易与销售 pipeline 管理

适用场景：跟踪销售机会、查看交易阶段或分析销售流程时使用。

工具序列：

1. HUBSPOT_RETRIEVE_ALL_PIPELINES_FOR_SPECIFIED_OBJECT_TYPE - 获取所有交易管道
2. HUBSPOT_SEARCH_DEALS - 按条件搜索交易
3. HUBSPOT_RETRIEVE_PIPELINE_STAGES - 获取特定管道的阶段详情

使用技巧：使用filterGroups参数按管道、阶段、创建日期等条件筛选交易，结果按paging.next.after进行分页处理。

4. 工单搜索与筛选

适用场景：查找特定支持工单或分析客户服务请求时使用。

工具序列：

1. HUBSPOT_SEARCH_TICKETS - 使用筛选条件搜索工单
2. HUBSPOT_GET_TICKET - 获取单个工单详情
3. HUBSPOT_GET_TICKETS - 批量获取工单信息

注意事项：日期筛选需使用epoch-ms格式，且必须指定需要返回的属性字段，否则可能导致下游逻辑错误。

5. 自定义属性创建与管理

适用场景：需要扩展CRM数据模型，添加自定义字段时使用。

工具序列：

1. HUBSPOT_READ_ALL_PROPERTIES_FOR_OBJECT_TYPE - 列出现有属性
2. HUBSPOT_CREATE_PROPERTY_FOR_SPECIFIED_OBJECT_TYPE - 创建新属性
   • 必要参数：objectType、name、label、type和fieldType

重要提示：属性名称创建后不可更改，请谨慎命名；枚举类型属性需要预先定义选项值和标签。

实用操作模式与最佳实践 💡

ID解析技巧

• 属性名称转换：使用HUBSPOT_READ_ALL_PROPERTIES_FOR_OBJECT_TYPE获取内部属性名
• 管道ID获取：通过HUBSPOT_RETRIEVE_ALL_PIPELINES_FOR_SPECIFIED_OBJECT_TYPE获取管道ID
• 负责人ID查询：使用HUBSPOT_RETRIEVE_OWNERS获取负责人ID与名称对应关系

分页处理策略

HubSpot API采用基于游标的分页机制：

• 每次请求最多返回100条记录
• 使用after参数获取下一页数据
• 持续调用直到响应中不再包含paging.next.after

批量操作最佳实践

• 批量创建/更新操作限制为100条记录/次
• 大数据集需拆分为多个批次处理
• 每次批量操作后存储返回的ID，用于后续操作
• 优先使用批量端点（如CREATE_CONTACTS而非CREATE_CONTACT）提高效率

常见问题与避坑指南 ⚠️

数据操作问题

• 属性名称错误：所有操作必须使用内部属性名，而非显示标签
• 批量限制：超过100条记录的操作必须分批次进行
• 重复记录：创建前务必执行搜索操作避免重复

认证与连接问题

• 连接验证：始终先运行HUBSPOT_GET_ACCOUNT_INFO验证授权状态
• OAuth流程：如连接未激活，需通过返回的授权链接完成认证
• 权限不足：确保HubSpot账户具有足够权限执行所需操作

响应处理问题

• 结果嵌套：搜索结果位于response.data.results路径下
• 数据类型：所有属性值均以字符串形式返回，需根据需要转换类型
• 日期格式：不同端点可能返回epoch-ms或ISO格式日期，需统一处理

快速参考：常用工具速查表

任务	工具标识	关键参数
创建联系人	HUBSPOT_CREATE_CONTACT	properties: {email, firstname, lastname}
批量创建联系人	HUBSPOT_CREATE_CONTACTS	inputs: [{properties}] (最多100条)
搜索联系人	HUBSPOT_SEARCH_CONTACTS_BY_CRITERIA	filterGroups, properties, limit, after
创建公司	HUBSPOT_CREATE_COMPANIES	inputs: [{properties}] (最多100条)
搜索公司	HUBSPOT_SEARCH_COMPANIES	filterGroups, properties, after
搜索交易	HUBSPOT_SEARCH_DEALS	filterGroups, properties, after
获取管道	HUBSPOT_RETRIEVE_ALL_PIPELINES_FOR_SPECIFIED_OBJECT_TYPE	objectType: 'deals'
搜索工单	HUBSPOT_SEARCH_TICKETS	filterGroups, properties, after
列出属性	HUBSPOT_READ_ALL_PROPERTIES_FOR_OBJECT_TYPE	objectType
创建属性	HUBSPOT_CREATE_PROPERTY_FOR_SPECIFIED_OBJECT_TYPE	objectType, name, label, type, fieldType
验证连接	HUBSPOT_GET_ACCOUNT_INFO	无

总结

Awesome Claude Skills的HubSpot自动化工具为用户提供了一个强大而简单的方式来管理HubSpot CRM数据。通过本文介绍的工作流程和最佳实践，即使没有编程背景的用户也能轻松实现复杂的CRM自动化操作。无论是小型团队还是大型企业，都能通过这些工具显著提升客户关系管理效率，减少重复工作，专注于更有价值的客户互动。

要开始使用这个强大的工具，只需克隆项目仓库：https://gitcode.com/GitHub_Trending/aw/awesome-claude-skills，按照设置指南配置Rube MCP连接，即可立即体验HubSpot自动化带来的便利。

【免费下载链接】awesome-claude-skills A curated list of awesome Claude Skills, resources, and tools for customizing Claude AI workflows 项目地址: https://gitcode.com/GitHub_Trending/aw/awesome-claude-skills