技能 hubspot-integration
📦

hubspot-integration

安全

将 HubSpot CRM 与 Claude Code 集成

使用专业的身份验证、CRUD 操作和 Webhook 模式快速构建 HubSpot CRM 集成。通过 Node.js 和 Python SDK 的成熟实现模式消除 API 复杂性。

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

下载技能 ZIP

2

在 Claude 中上传

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

3

开启并开始使用

测试它

正在使用“hubspot-integration”。 使用私有应用令牌在 Python 中创建 HubSpot 联系人

预期结果:

生成使用 hubspot-api-client 的 Python 代码,包含 ContactObject 创建、4xx 响应的错误处理以及用于 HUBSPOT_API_KEY 的环境变量配置

正在使用“hubspot-integration”。 为 Node.js 设置 OAuth 身份验证

预期结果:

生成实现 OAuth 授权流程、访问令牌存储、刷新令牌逻辑以及受保护 API 调用中间件的 Node.js 代码

正在使用“hubspot-integration”。 为交易更新创建 Webhook 处理器

预期结果:

返回带有 HubSpot 签名验证、事件解析逻辑和交易属性变更异步处理管道的 Express 路由处理器

安全审计

安全
v1 • 2/25/2026

Static analysis flagged 2 false positives for 'weak cryptographic algorithm' at lines 3 and 46. These flags were triggered by documentation text mentioning 'authentication' and are not actual security issues. The file contains only legitimate HubSpot CRM integration patterns documentation with no malicious code, prompt injection attempts, or security vulnerabilities.

1
已扫描文件
47
分析行数
1
发现项
1
审计总数
低风险问题 (1)
False Positive - Cryptographic Reference
Static scanner flagged 'authentication' keyword as weak cryptographic algorithm. This is documentation text only, not executable code.
审计者: claude

质量评分

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

你能构建什么

联系人同步

自动同步应用程序与 HubSpot CRM 联系人之间的客户数据

Webhook 事件处理

构建处理器以处理 HubSpot 生命周期事件,如联系人创建或交易阶段变更

自定义对象集成

创建和管理自定义 HubSpot 对象,用于标准 CRM 记录之外的专业业务数据

试试这些提示

基本联系人创建
使用 Node.js SDK 创建 HubSpot 联系人,包含电子邮件、名字和姓氏属性
OAuth 身份验证设置
为公共应用实现 HubSpot OAuth 2.0 流程,包含令牌刷新逻辑
批量导入操作
编写代码使用批量 API 端点将 1000 个联系人批量导入到 HubSpot
Webhook 处理器实现
创建一个 Express.js Webhook 处理器,用于处理 HubSpot 联系人创建事件并包含签名验证

最佳实践

  • 在创建或更新多条记录时,始终使用批量 API 端点而不是单个请求
  • 实现 Webhook 签名验证以确保请求来自 HubSpot
  • 安全存储 OAuth 刷新令牌并在过期前实现自动令牌刷新

避免

  • 避免使用已弃用的 API 密钥进行身份验证
  • 当 Webhook 可用时,不要轮询 HubSpot API 来获取数据变更
  • 切勿将 API 令牌或 OAuth 凭据硬编码到源代码中

常见问题

支持哪些 HubSpot 身份验证方法?
此技能涵盖用于公共应用的 OAuth 2.0 和用于单账户集成的私有应用令牌。OAuth 推荐用于具有多用户的生产应用程序。
支持哪些编程语言?
此技能为 Node.js 和 Python SDK 提供模式和代码示例,涵盖最常见的后端集成场景。
此技能可以创建 HubSpot 账户或 API 密钥吗?
不,此技能生成集成的代码模式。您必须通过 HubSpot 开发者门户创建自己的 HubSpot 开发者账户、应用和 API 凭据。
如何处理 HubSpot API 速率限制?
此技能提供实现指数退避和批量操作的模式以在速率限制内进行优化。您的实现应该跟踪使用情况并为高容量操作实现队列。
对于 HubSpot 数据,Webhook 是否比轮询更好?
是的,对于实时更新,Webhook 效率更高。此技能包含 Webhook 处理器实现、签名验证和事件处理的模式。
我可以使用此技能创建自定义 HubSpot 对象吗?
是的,此技能涵盖自定义对象模式设计以及通过 HubSpot API 创建、读取、更新和删除自定义对象记录所需的 API 模式。

开发者详情

文件结构

📄 SKILL.md