hubspot-list-contacts
hubspot-list-contacts 是一个用于从 HubSpot CRM 列出联系人的专用技能。当用户说出“list contacts”“show contacts”“get contacts”“hubspot contacts”等指令时加载。该技能返回分页的联系人列表,包含联系人 ID、邮箱、名字、姓氏、电话、公司等属性,以及指向 HubSpot 记录页面的 URL。使用前需先执行配置检查脚本,确认 ai_action 为 proceed_with_operation,否则需按 hubspot-connect 设置指南完成连接。支持通过 --limit 指定数量(默认 10 条),通过 --after 传入游标实现分页。输出为 JSON 格式,包含 results 数组和 paging.next.after 游标。结果以编号列表形式展示给用户,含姓名、邮箱、电话、公司和 ID。常见错误包括 401(令牌无效,需重新设置)、403(缺少 crm.objects.contacts.read 权限范围)、429(触发速率限制,需等待后重试)。相关技能有 hubspot-create-contact、hubspot-search-contacts、hubspot-update-contact。