用途：识别并规避 HubSpot API 集成中的常见错误，适用于代码审查、开发者上手 HubSpot 以及排查集成问题。
主要能力：列出十个真实反模式并给出正确替代方案。包括：用私有应用访问令牌替代已废弃的 API Key；用批量接口替代逐条 getById；搜索接口有 10000 条硬上限，全量导出应改用 getPage；关联类型 ID 需使用文档默认值或动态查询；创建前先搜索或使用批量 upsert 避免重复联系人；只请求所需属性；管道阶段 ID 因门户而异，应先获取管道再使用；关联已存在时优雅处理 409；用 Webhook 替代轮询；使用 CRM v3 接口而非旧版 v1/v2。
使用方式：提供对 HubSpot 集成代码库的访问权限并了解 CRM v3 API。资料给出若干扫描命令，例如 grep -rn "apiKey:" src/ --include="*.ts"、grep -rn "contacts/v1|deals/v1|companies/v2" src/、grep -rn "setInterval.*hubspot|setInterval.*crm" src/，用于在代码库中定位对应问题。
限制：资料未提供安装命令、收费信息或具体平台支持范围；示例基于 TypeScript SDK，其他语言需自行适配。