hubspot-list-notes

用途

hubspot-list-notes 是一个专门用于从 HubSpot CRM 中列出笔记（note）互动记录（engagements）的技能。当用户表达“list notes”“show notes”“note history”“hubspot notes”等意图时，应加载该技能，它会返回已记录的笔记数据。

主要能力

列出 HubSpot CRM 中的笔记记录，默认返回 10 条。
支持通过 --limit 参数指定返回数量，例如 --limit 25。
支持通过 --after 参数传入游标值进行分页，获取下一页数据。
输出为 JSON 格式，包含 results 数组和 paging 分页信息。

使用方式

运行前检查

在执行操作前，先运行配置检查：

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

指定数量

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

分页

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

输出格式

{
  "results": [
    {
      "id": "16977760701",
      "properties": {
        "hs_note_body": "<p>Important note about this contact...</p>",
        "hs_timestamp": "2025-12-13T10:00:00Z"
      }
    }
  ],
  "paging": {
    "next": {
      "after": "cursor_for_next_page"
    }
  }
}

展示格式

Found {count} notes:

1. Note ID: 16977760701
   Date: 2025-12-13 10:00
   Content: Important note about this contact...

2. Note ID: 16977942725
   Date: 2025-12-12 15:30
   Content: Meeting follow-up...

笔记内容处理

笔记可能包含 HTML 格式。
展示时应剥离 HTML 标签，以纯文本显示。
笔记可能包含链接、列表和格式化文本。

错误处理

错误	解决方案
401	令牌无效，需重新运行设置
403	缺少 crm.objects.notes.read 权限范围
429	触发速率限制，需等待后重试

限制

资料中未提供关于平台兼容性、收费、价格或具体效果的信息。

技能介绍

用途