hubspot-list-companies

用途

hubspot-list-companies 是一个专门用于从 HubSpot CRM 中列出公司的技能。当用户表达“list companies”“show companies”“get companies”“hubspot companies”等意图时加载，返回分页的公司列表。

主要能力

列出 HubSpot CRM 中的公司记录
默认返回 10 家公司
支持通过 --limit 参数指定返回数量，例如 25 家
支持通过 --after 参数进行分页，使用上一页返回的游标值获取下一页
输出 JSON 格式结果，包含公司 id、properties（如 name、domain、industry、city、numberofemployees、phone）、记录 url 以及 paging.next.after 游标
提供显示格式模板，便于将结果整理为可读列表

使用方式

运行前先执行配置检查：

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_companies.py --json

指定数量：

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

分页：

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

输出与显示

JSON 输出示例如下：

{
  "results": [
    {
      "id": "6493611979",
      "properties": {
        "name": "Acme Corp",
        "domain": "acme.com",
        "industry": "Technology",
        "city": "San Francisco",
        "numberofemployees": "500",
        "phone": "+1234567890"
      },
      "url": "https://app.hubspot.com/contacts/.../record/0-2/6493611979"
    }
  ],
  "paging": {
    "next": {
      "after": "cursor_for_next_page"
    }
  }
}

显示格式示例：

Found {count} companies:

1. Acme Corp
   Domain: acme.com
   Industry: Technology
   City: San Francisco
   Employees: 500
   ID: 6493611979

2. Tech Inc
   Domain: techinc.io
   ...

错误处理

401：令牌无效，需要重新运行设置
403：缺少 crm.objects.companies.read 权限
429：触发速率限制，需等待后重试

适用场景

需要在 HubSpot CRM 中浏览公司记录、按数量或分页获取公司列表，并将结果以 JSON 或格式化列表呈现时使用。

限制

技能未提供关于认证方式、API 版本、字段可配置性、速率限制具体阈值、缓存策略以及是否支持自定义属性筛选等更多细节，暂未提供。适用分类：办公与效率。

技能介绍

用途