用途：把联系人及列表同步到 HubSpot CRM，适合将分析得到的用户邮箱批量上传为 HubSpot 联系人并归入指定列表。
主要能力：通过 HubSpot REST API 创建静态联系人列表、按邮箱搜索联系人、创建仅含标准字段（email、firstname、lastname）的联系人、将联系人批量加入列表，并输出列表链接。
使用方式：需先设置环境变量 HUBSPOT_API_TOKEN（HubSpot 私有应用令牌）。代码通过 HubSpotClient 封装请求，基地址为 https://api.hubapi.com。创建列表使用 POST /crm/v3/lists，需带 "objectTypeId": "0-1"（联系人）与 "processingType": "MANUAL"；搜索联系人使用 POST /crm/v3/objects/contacts/search；创建联系人使用 POST /crm/v3/objects/contacts；加入列表使用 PUT /crm/v3/lists/{list_id}/memberships/add，每批最多 100 个。CSV 文件可用脚本：.venv/bin/python demos/04-trial-to-paid/scripts/hubspot_integration.py path/to/users.csv "List Name Here"，CSV 需含 email 列。
适用场景：将试用用户、流失风险用户等邮箱清单同步到 HubSpot 并建立列表。
限制与注意：不要传入目标账户中不存在的自定义属性，否则会被拒绝；列表创建响应为嵌套结构，列表 ID 位于 result["list"]["listId"]；加入列表的请求体是简单数组，不是 {"recordIdsToAdd": [...]}；联系人 ID 应作为字符串处理；令牌需具备 crm.lists.read、crm.lists.write、crm.objects.contacts.read、crm.objects.contacts.write 权限。其他收费、平台等信息暂未提供。