用途：帮助开发者安装 HubSpot 官方 SDK 并完成认证配置，用于新建 HubSpot 集成。
主要能力：支持 Node.js 与 Python 两种 SDK；支持私有应用访问令牌（private app token）和面向公开应用的 OAuth 2.0 授权码流程；提供连接验证、令牌刷新与常见错误处理指引。
使用方式：
- 安装 SDK：Node.js 执行 npm install @hubspot/api-client；Python 执行 pip install hubspot-api-client。
- 在 HubSpot 后台 Settings > Integrations > Private Apps 创建私有应用并选择所需 scopes（如 crm.objects.contacts.read/write 等），复制生成的访问令牌。
- 配置环境变量，将 HUBSPOT_ACCESS_TOKEN 写入 .env，并把 .env、.env.local 加入 .gitignore。
- 初始化客户端并验证连接，例如用 Node.js 的 hubspot.Client({ accessToken }) 调用 crm.contacts.basicApi.getPage 拉取联系人。
- 公开应用使用 OAuth 2.0：生成授权 URL、在回调中用授权码换取令牌、用 accessToken 初始化客户端，并在令牌过期前用 refresh_token 刷新（资料称令牌 30 分钟过期）。
适用场景：需要接入 HubSpot CRM 联系人、公司、交易、自定义对象及属性的集成开发。
限制与错误处理：401 表示令牌无效或过期，需重新生成；403 表示缺少 scopes，需补充后重新生成令牌；429 表示超出速率限制，需实现退避；MODULE_NOT_FOUND 表示未安装包；ECONNREFUSED 表示网络被阻断，需确保可访问 api.hubapi.com。前置条件为 Node.js 18+ 或 Python 3.10+，以及 HubSpot 账户（免费或付费）。