用途
该技能用于通过 Rube MCP 与 Composio 集成，自动化 HubSpot CRM 的常见操作，包括联系人、公司、交易、工单以及自定义属性的管理。它把 HubSpot 的多个 API 操作封装为可调用的工具序列，适合在支持 MCP 的客户端中执行 CRM 工作流。
主要能力
- 联系人管理：创建单个或批量联系人（单批最多 100 条），按条件搜索联系人以避免重复。
- 公司管理：批量创建、更新、搜索公司记录，支持按属性值批量读取。
- 交易与管道：检索管道与阶段信息，按管道、阶段、创建日期、关闭日期、负责人等条件搜索交易。
- 工单搜索：按状态、日期或条件筛选支持工单，支持批量按 ID 获取。
- 自定义属性：列出、创建、批量创建或更新 CRM 对象的属性定义，支持枚举类型。
使用方式
- 在客户端配置中添加 MCP 服务器地址 https://rube.app/mcp，无需 API 密钥。
- 确认 RUBE_SEARCH_TOOLS 可响应，以验证 Rube MCP 可用。
- 调用 RUBE_MANAGE_CONNECTIONS 并指定 toolkit 为 hubspot。
- 若连接状态不是 ACTIVE，按返回的授权链接完成 HubSpot OAuth。
- 确认连接状态为 ACTIVE 后，先调用 RUBE_SEARCH_TOOLS 获取当前工具结构，再执行具体工作流。
适用场景
- 批量导入或更新联系人、公司数据。
- 跟踪销售管道中的交易进展，按阶段或负责人筛选。
- 按状态或日期检索支持工单。
- 为 CRM 对象扩展自定义字段。
限制与注意事项
- 批量操作单次最多 100 条记录，超出需分块处理。
- 搜索与筛选必须使用内部属性名，而非显示标签；可用 HUBSPOT_READ_ALL_PROPERTIES_FOR_OBJECT_TYPE 查询正确名称。
- 属性名称创建后不可更改，需提前规划命名。
- 搜索结果嵌套在 response.data.results 下，属性值常为字符串。
- 日期格式可能为 epoch 毫秒或 ISO 字符串，需按端点防御性解析。
- 分页使用游标 paging.next.after，直到该字段不存在为止。
- 创建联系人/公司前应先搜索，避免重复。
- 建议先运行 HUBSPOT_GET_ACCOUNT_INFO 验证授权，授权失败会导致后续调用全部失败。
- 枚举选项需预先定义 value 与 label，属性组需先存在。
快速参考
- 创建联系人：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_RETRIEVE_OWNERS
- 验证连接：HUBSPOT_GET_ACCOUNT_INFO