hubspot-list-deals

用途

本技能用于从 HubSpot CRM 中列出交易（deals）。当用户说出“list deals”“show deals”“show pipeline”“get deals”“hubspot deals”等指令时加载，返回分页的交易列表。

主要能力

列出 HubSpot CRM 中的交易记录，支持分页返回。
可指定返回数量（默认 10 条）。
可通过游标（after）获取下一页数据。
输出 JSON 格式结果，并附带便于阅读的展示格式。

使用方式

运行前检查

运行前先执行配置检查：

python 00-system/skills/hubspot/hubspot-master/scripts/check_hubspot_config.py --json

如果 ai_action 不是 proceed_with_operation，请遵循 hubspot-connect 设置指南。

基本列表（默认 10 条交易）

python 00-system/skills/hubspot/hubspot-master/scripts/list_deals.py --json

指定数量

python 00-system/skills/hubspot/hubspot-master/scripts/list_deals.py --limit 25 --json

分页

python 00-system/skills/hubspot/hubspot-master/scripts/list_deals.py --after "cursor_value" --json

输出格式

{
  "results": [
    {
      "id": "5840795376",
      "properties": {
        "dealname": "Enterprise Deal",
        "amount": "50000",
        "dealstage": "qualifiedtobuy",
        "pipeline": "default",
        "closedate": "2025-03-15T00:00:00Z"
      },
      "url": "https://app.hubspot.com/contacts/.../record/0-3/5840795376"
    }
  ],
  "paging": {
    "next": {
      "after": "cursor_for_next_page"
    }
  }
}

展示格式

Found {count} deals:

1. Enterprise Deal
   Amount: $50,000
   Stage: Qualified to Buy
   Close Date: 2025-03-15
   ID: 5840795376

2. Startup Package
   Amount: $5,000
   Stage: Proposal Sent
   ...

常见交易阶段

Stage ID	Name
appointmentscheduled	Appointment Scheduled
qualifiedtobuy	Qualified to Buy
presentationscheduled	Presentation Scheduled
decisionmakerboughtin	Decision Maker Bought In
contractsent	Contract Sent
closedwon	Closed Won
closedlost	Closed Lost

错误处理

错误	解决方案
401	Invalid token - re-run setup
403	Missing crm.objects.deals.read scope
429	Rate limited - wait and retry

适用场景

需要查看、列出或浏览 HubSpot CRM 中交易列表及销售管道（pipeline）时使用。

限制

资料未提供关于定价、平台兼容性、性能或权限范围之外的更多限制说明。

技能介绍

用途