核心用法
HubSpot skill 提供对 HubSpot CRM 的完整 API 访问能力，覆盖客户管理的核心场景：
数据查询：支持按关键词、邮箱搜索联系人（contacts），按公司名搜索企业（companies），按交易名称搜索商机（deals）；支持分页列表获取所有对象；支持通过 ID 精确获取单条记录。
数据管理：可创建新的联系人、公司、交易记录，支持设置自定义字段如交易金额、 pipeline 阶段；支持更新现有对象的任意属性；支持对象关联（如联系人与公司绑定）。
销售流程：可查询 pipeline 阶段配置、查看交易负责人（owners），便于销售流程管理和权限分配。
显著优点
1. 官方直连：直接调用 api.hubapi.com，无第三方中间层，数据隐私有保障
2. 完整 CRUD：覆盖创建、读取、更新、关联四大操作，满足日常 CRM 管理需求
3. 权限精细：通过 Private App 的 scope 控制，最小权限原则配置
4. 多对象支持：联系人、公司、交易、工单（tickets）四大核心对象全覆盖
潜在缺点与局限
- Token 管理：需手动创建 Private App 并妥善保管 access token，无 OAuth 自动刷新机制
- 无批量操作：当前版本未见批量创建/更新接口，大数据量场景效率受限
- 无实时同步：被动查询模式，无 webhook 或实时事件推送
- 字段自定义：复杂自定义字段操作需参考 HubSpot API 文档，skill 封装层可能未完全覆盖
适合人群
- 销售团队需快速查询客户信息、更新交易状态
- 运营人员需批量整理客户数据、关联客户与公司
- 管理员需查看 pipeline 配置、调整交易阶段
常规风险
- Token 泄露风险：
HUBSPOT_TOKEN为长期有效凭证，若环境变量泄露可导致 CRM 数据被非法访问 - 误操作风险：更新/删除操作不可逆，生产环境建议先测试
- 数据权限边界：Token 权限范围需严格限制，避免过度授权
- API 限流：HubSpot 对 API 调用有速率限制，高频操作可能触发限制
配置要求
- 环境变量：
HUBSPOT_TOKEN（Private App access token） - 依赖：Python 3 运行环境
- 权限 scope：
crm.objects.*.read/write,tickets