技能 hubspot-automation
📦

hubspot-automation

低风险 🌐 网络访问

使用 AI 自动化 HubSpot CRM 操作

手动 CRM 数据录入和管道管理每周消耗数小时。此技能通过 AI 驱动的工作流自动化 HubSpot 操作,包括联系人、公司、交易和工单。

支持: Claude Codex Code(CC)
🥉 72 青铜
1

下载技能 ZIP

2

在 Claude 中上传

前往 设置 → 功能 → 技能 → 上传技能

3

开启并开始使用

测试它

正在使用“hubspot-automation”。 搜索邮箱域为 @acme.com 的联系人并返回他们的全名和公司关联

预期结果:

找到 12 个匹配条件的联系人:John Smith (Acme Corp)、Jane Doe (Acme Corp)、Bob Johnson (Acme Corp)。结果包含用于下游操作的联系人 ID。

正在使用“hubspot-automation”。 批量创建 3 个新联系人,包含邮箱、姓名和电话号码

预期结果:

成功创建 3 个联系人。返回 ID:12345678、12345679、12345680。所有联系人现在可搜索,可与公司或交易关联。

正在使用“hubspot-automation”。 列出所有交易管道并显示主销售管道的阶段

预期结果:

找到 2 个管道:'Sales Pipeline' (ID: abc123),阶段:Prospecting、Qualification、Proposal、Closed Won、Closed Lost。'Partner Pipeline' (ID: def456),阶段:Lead、Opportunity、Closed。

安全审计

低风险
v1 • 2/25/2026

Static analyzer flagged 129 external_commands patterns which are FALSE POSITIVES - these are Markdown backticks for code formatting, not Ruby shell execution. One legitimate network dependency detected (rube.app/mcp server) which is the intended MCP architecture. No malicious patterns, credential exfiltration, or command injection vectors found. Skill is safe for publication with network access disclosure.

1
已扫描文件
184
分析行数
2
发现项
1
审计总数
低风险问题 (1)
External MCP Server Dependency
Skill requires connection to external MCP server at rube.app/mcp for HubSpot API access. This is legitimate architecture but represents a third-party dependency.

风险因素

🌐 网络访问 (1)
审计者: claude

质量评分

38
架构
100
可维护性
87
内容
50
社区
88
安全
91
规范符合性

你能构建什么

销售团队联系人导入

通过批量创建前搜索现有联系人来导入和去重展会收集的潜在客户,然后与相关公司和交易关联。

支持工单分类自动化

按状态和日期范围搜索工单,识别逾期项目,并更新属性以标记需要团队立即处理的优先案例。

管道健康报告

检索所有交易管道和阶段,按阶段和负责人搜索交易,然后生成关于管道速度和转化率的摘要报告。

试试这些提示

创建新联系人
为 John Smith 创建 HubSpot 联系人,邮箱 john.smith@example.com,电话 555-0100,公司 Acme Corp。首先验证连接是否活跃,然后在创建前搜索具有此邮箱的现有联系人以避免重复。
批量导入公司
我有 250 家公司要导入 HubSpot。将它们分块为每批 100 家,按域名搜索现有公司以防止重复,然后仅创建新的。存储所有返回的公司 ID 以便后续与联系人关联。
交易管道分析
检索所有交易管道及其阶段。搜索 Sarah Johnson 拥有的、在过去 30 天内创建的'Qualification'阶段的交易。分页遍历所有结果并汇总总数量、合并交易金额和平均交易规模。
自定义属性设置
为联系人创建一个名为'Lead Source Channel'的自定义枚举属性,选项包括:Organic Search、Paid Ads、Referral、Trade Show 和 Direct。首先检查现有属性以确认它尚不存在,然后在'Lead Information'属性组中创建它。

最佳实践

  • 在执行任何 CRM 操作之前,首先调用 HUBSPOT_GET_ACCOUNT_INFO 验证连接状态
  • 在创建联系人或公司之前,按邮箱或域名搜索现有记录以防止重复
  • 在构建过滤查询之前,使用 READ_ALL_PROPERTIES_FOR_OBJECT_TYPE 发现内部属性名
  • 将批量操作分块为最多 100 条记录的组,并在批次之间存储返回的 ID
  • 通过 pagination 游标 paging.next.after 直到缺失,以检索完整结果集

避免

  • 创建联系人前未搜索重复项 - 导致联系人记录碎片化
  • 在过滤器中使用显示名称而非内部属性名 - 返回零结果但不报错
  • 忽略批量限制并尝试在单次调用中创建 500+ 条记录 - API 将拒绝请求
  • 假设各端点的日期格式一致 - 需防御性解析 epoch-ms 和 ISO 字符串两种格式

常见问题

使用此技能前我需要什么?
您需要在 AI 客户端中配置 Rube MCP,并通过 Composio 建立活跃的 HubSpot 连接。在开始工作流之前,运行 HUBSPOT_GET_ACCOUNT_INFO 验证连接状态。
如何避免创建重复联系人?
在创建之前始终使用联系人邮箱调用 HUBSPOT_SEARCH_CONTACTS_BY_CRITERIA。如果存在结果,则更新现有记录而非创建新记录。
为什么我收到'Property values were not valid'错误?
这通常是由于使用了错误的属性名或枚举值。使用 HUBSPOT_READ_ALL_PROPERTIES_FOR_OBJECT_TYPE 发现准确的内部属性名和有效选项值。
如何导入超过 100 条记录?
将数据分块为每批最多 100 条记录。分别处理每批,在继续下一批之前存储返回的 ID。
我可以在 HubSpot 中创建自定义字段吗?
可以。使用 HUBSPOT_CREATE_PROPERTY_FOR_SPECIFIED_OBJECT_TYPE 创建自定义属性。对于枚举字段,在 options 数组中预定义值和标签选项。
如何找到特定交易阶段的管道 ID?
使用 objectType 'deals'调用 HUBSPOT_RETRIEVE_ALL_PIPELINES_FOR_SPECIFIED_OBJECT_TYPE,然后使用 HUBSPOT_RETRIEVE_PIPELINE_STAGES 获取特定管道内的阶段 ID。

开发者详情

文件结构

📄 SKILL.md