# HubSpot MCP 新定价：公开评论回写 CRM，取数实测加写入示例

> 按 HubSpot 无头定价，让 Claude 把客户公开评论写回 CRM：200 个客户每周接口费最多 $0.90，重试不另扣费；写入部分是配置示例。

- Canonical page: [https://everyinfra.com/blog/hubspot-mcp-pricing](https://everyinfra.com/blog/hubspot-mcp-pricing?utm_medium=ai_doc&utm_campaign=page_md)
- Published: 2026-11-22T14:38:00+08:00 · Fact-checked: 2026-11-22T14:30:00+08:00

同一条 Reddit 招聘帖被一个人发进 7 个版块，正文里同时提到 Zapier 和 Calendly，于是在我们 2026-11-22 中午取的两家客户的数据里各出现 7 次：不按内容 ID 去重，Claude 会在 HubSpot 两家公司的记录上把同一段话各写 7 遍，共 14 条。这是我们给 3 家假设的 CRM 客户（Calendly、Zapier、Typeform）取公开评论和帖子时看到的，取数走 EveryInfra 的 `linkedin/company_posts`、`trustpilot/reviews`、`reddit/search`，每家 3 次调用，接口费 $0.0045，返回 81,122 到 101,389 字节。写回走 HubSpot MCP server：HubSpot 在 2026 年 11 月 17 日公布的无头定价把这件活分成三种计费，Claude 连接器里的日常读写随席位附送，自建 agent 调 API 占套餐自带的 API 额度、不扣 HubSpot Credits，HubSpot 正在做的受管环境按 Credits 计费（[HubSpot：HubSpot is headless. Here's how we'll price it](https://www.hubspot.com/company-news/pricing-headless)）。按我们的实测换算，每周给 200 个客户各取一次是 600 次调用、接口费最多 $0.90；HubSpot 一侧走批量 API 约 6 次请求，占入门版每日 25 万次额度的 0.0024%，走 Claude 连接器则要分 40 批、每批最多 10 条记录。取数是真实调用；HubSpot 一侧的写入和去重按 HubSpot 公开文档写成配置示例，我们没有在真实 HubSpot 账号上跑过。

> **本文要点**
>
> - HubSpot 2026-11-17 公布的无头定价分三条路：Claude、ChatGPT 连接器的日常使用随席位附送；自建 agent 调 API 占套餐 API 额度，不扣 Credits；受管环境按 Credits 计费，每个 $0.010，费率表还没公布。
> - 每日 API 额度两份 HubSpot 页面写的不一样：开发者文档写专业版 625,000 次，产品目录写 650,000 次；入门版两处都是 250,000 次。
> - 3 家客户各取 3 次，接口费各 $0.0045，返回约 2.0 万到 2.5 万 token；200 个客户每周接口费最多 $0.90，一年最多 $46.80，空结果和失败不扣费。
> - Reddit 结果里同一条帖子出现在两家客户名下 7 次；LinkedIn 公司动态 20 条里有 7 条、12 条不是公司自己发的；去重键要按「平台 + 内容 ID」全局算，在脚本里合并后再写进每家公司的周报。
> - EveryInfra 一侧带 `Idempotency-Key` 重试（实测）：同键同参数回放首个成功响应、不再扣费，同键换参数回 409。HubSpot 的 CRM API 没有请求级幂等键；本文按文档给的写法是把本周摘要笔记的 ID 和周次记在公司属性上，重跑时改同一条笔记，这一步没有在 HubSpot 一侧跑过。

![示意插图：左边一条传送带运来许多印着对话气泡和星星的小卡片，其中几摞是一模一样的副本；中间一台分拣机读取每张卡上的铜牌，相同的副本掉进旁边的废料箱，每种只放行一张；右边一只木制卡片柜拉开一格，新卡片放进去；一条回流滑道从分拣机绕回传送带，滑道上的小闸门是关着的。](https://everyinfra.com/articles/hubspot-mcp-pricing/img-explain.webp?utm_medium=ai_doc&utm_campaign=page_md)

取数、去重、写回：重发的卡片在闸门前被拦下，同一条内容只进柜一次。

## HubSpot 无头定价：三条路各按什么计费

HubSpot 把「不打开 HubSpot 界面、从别的 AI 工具里用 HubSpot」叫作无头（headless）。2026-11-17 发在公司新闻页的那篇定价说明开头只有三句话：每个席位自带足够的无头访问，日常工作在 Claude 或 ChatGPT 里完成不另收费；第三方 agent 接 HubSpot 现有的 API，占套餐已经包含的 API 额度，不消耗 Credits；想给第三方 agent 加强治理、完整追踪和专用工具的团队，这部分用量按 HubSpot Credits 计费（[HubSpot：pricing-headless](https://www.hubspot.com/company-news/pricing-headless)）。

| 路线 | 接的是什么 | 怎么计费 | 写入限制（公开文档） |
| --- | --- | --- | --- |
| 连接器日常使用 | Claude、ChatGPT、Gemini、Microsoft Copilot 的 HubSpot 连接器，HubSpot MCP server，Agent CLI | 随 HubSpot 席位附送；用量超出席位自带部分时，以后可以用 Credits 扩容 | Claude 连接器批量建或改记录每次最多 10 条；不能删除；写入记进审计日志 |
| 自建或买来的 agent 调 API | 现有 CRM API，和普通集成一样 | 占套餐自带的每日 API 额度，不扣 Credits；额度不够可以加购 | 私有应用每 10 秒 100 或 190 次；每天 25 万到 100 万次 |
| 受管环境（在建） | HubSpot 专为 agent 做的 API 和权限、日志 | 规模化工作（例如补全记录、个性化外联）按 Credits 计费 | 公告没有给出费率、名称和上线日期 |

公告没有给任何价格。Credits 的单价在 HubSpot 的 Credits 页和产品目录里：每个 $0.010，1,000 个一包每月 $10，或者按用量付费、以 10 个为单位开票（[HubSpot Credits](https://www.hubspot.com/products/artificial-intelligence/credits)；[HubSpot 产品与服务目录](https://legal.hubspot.com/hubspot-product-and-services-catalog)）。Sales Hub 入门版、专业版、企业版每月自带 500、3,000、5,000 个 Credits，月底清零、不结转（[HubSpot：Sales Hub 定价](https://www.hubspot.com/pricing/sales)）。公告没有说「日常使用」到多少次算超出，也没有给受管环境的费率；IMPACT 的作者在 11 月的文章里提了同一个问题：一位销售经理每天早上让 Claude 分析 100 个交易，算不算日常（[IMPACT](https://www.impactplus.com/learn/hubspot-just-announced-new-headless-pricing-what-this-means-in-plain-english)）。

### 把「回写评论」这件活放进三条路

这件活的输入是 CRM 里 200 家客户公司的域名和 LinkedIn 主页短名，输出是每家公司一条「本周公开动态」笔记，加三个公司属性（低分评价数、最近一次写入的周次、本周摘要笔记的 ID）。取数不经过 HubSpot：评论和帖子来自 LinkedIn、Trustpilot、Reddit 这些公开网站，由 EveryInfra 的接口取回，HubSpot 只负责存。按 HubSpot 的分法，同一件活可以落在两条路上：坐在 Claude 里点着做，属于第一条，随席位附送；写成每周自动跑的脚本，用服务密钥（service key）调 CRM API，属于第二条，占 API 额度。服务密钥 2026 年起取代了旧版私有应用的位置，按对象授权 scope，和私有发布的应用共用同一套限额；一个账号里应用、服务密钥和 MCP 连接器合计最多 100 个（[HubSpot 开发者文档：service keys](https://developers.hubspot.com/docs/apps/developer-platform/build-apps/authentication/account-service-keys)；[Authentication overview](https://developers.hubspot.com/docs/apps/developer-platform/build-apps/authentication/overview)）。第三条要等 HubSpot 的受管环境上线，现在用不上。

两条路的差别在写入的批量和确认方式上。HubSpot 的 Claude 连接器帮助页写明，批量创建或更新记录每次只能 10 条，建议把写工具设成「需要批准」，否则编辑可能不经确认直接发生（[HubSpot 知识库：Set up and use the HubSpot connector for Claude](https://knowledge.hubspot.com/integrations/set-up-and-use-the-hubspot-connector-for-claude)）。200 家公司要更新属性、各加一条笔记，在连接器里是 20 批属性加 20 批笔记，共 40 次批准。CRM API 的批量接口每次收 100 条，同样的写入是 2 次属性更新、2 次笔记写入（新建或修改），再加 2 次按属性筛公司的搜索请求（[HubSpot：Search the CRM](https://developers.hubspot.com/docs/api-reference/latest/crm/search-the-crm)），一周 6 次请求。

![横向条形图，对数刻度，每格 10 倍：HubSpot 每日 API 额度入门版 250,000 次、专业版开发者文档写 625,000 次、产品目录写 650,000 次、企业版 1,000,000 次；最下面一根是本文每周回写 200 个客户用到的 6 次请求，比入门版每日额度小四个数量级以上。](https://everyinfra.com/articles/hubspot-mcp-pricing/fig-01-api-capacity-bar.zh.light.svg?utm_medium=ai_doc&utm_campaign=page_md)

### 两份 HubSpot 页面对专业版额度写法不同

开发者文档「API usage guidelines and limits」的表里，私有应用的每日额度是入门版及免费版 250,000 次、专业版 625,000 次、企业版 1,000,000 次，每 10 秒的突发上限是 100、190、190 次，突发上限按应用算，每日额度由同一账号的所有应用共享；买了 API 加量包的，每 10 秒 250 次，每包每天再加 1,000,000 次，最多买两包（[HubSpot 开发者文档：API usage guidelines](https://developers.hubspot.com/docs/developer-tooling/platform/usage-guidelines)）。产品目录的「Technical Limits」页写的是专业版 650,000 次，加一包 1,650,000 次、加两包 2,650,000 次，每包每月 $500；同一页的表把加包后的突发上限写成 350、600、440、690 次每 10 秒，表上面的一句话又说加包后是每 10 秒 250 次（[HubSpot 产品目录：Technical Limits](https://legal.hubspot.com/hubspot-product-and-services-catalog/technical-limits)）。以上是我们 2026-11-22 读到的两页内容，PPC Land 的报道也指出了目录里突发上限的前后矛盾。这些差别对这件活没有影响：一周 6 次请求，离最小的每日额度也差四个数量级以上。要按额度做容量规划的团队，以账号里「开发 → 监控 → API 调用用量」页显示的数为准，429 响应里的 `policyName` 会说明碰到的是每日上限还是每 10 秒上限。

| 档位 | 每 10 秒（每个私有应用） | 每天（开发者文档） | 每天（产品目录） | 加一包后每天 |
| --- | --- | --- | --- | --- |
| 免费版、入门版 | 100 | 250,000 | 250,000 | 1,250,000 |
| 专业版 | 190 | 625,000 | 650,000 | 1,650,000 |
| 企业版 | 190 | 1,000,000 | 1,000,000 | 2,000,000 |
| 上架应用市场的公开 OAuth 应用 | 110（每个安装账号） | — | — | — |

开发者文档还有两条和 agent 有关：每日额度按账号时区的午夜重置；出错的请求不应超过每日总请求的 5%，想上架应用市场必须守住这条线（[HubSpot 开发者文档：usage guidelines](https://developers.hubspot.com/docs/developer-tooling/platform/usage-guidelines)）。一个每周跑一次的回写脚本，5% 这条线比额度更容易碰到：写错一个属性名、关联类型 ID 填错，整批都会报错。

## HubSpot MCP server 是什么：URL、授权和能写什么

HubSpot MCP server 的地址是 `https://mcp.hubspot.com`，2026-04-13 结束测试、对所有账号开放，同时加了写权限（[HubSpot 开发者 changelog，2026-04-13](https://developers.hubspot.com/changelog/remote-hubspot-mcp-server-is-now-generally-available)）。HubSpot 自己给 Claude、ChatGPT、Gemini、Microsoft Copilot 做的连接器也跑在这台服务器上（[HubSpot 开发者文档：Using the HubSpot MCP server](https://developers.hubspot.com/docs/build-with-ai/remote-mcp-server)）。它和开发者 MCP server 是两样东西：开发者 MCP server 在本机跑，帮你写 HubSpot 应用和 CMS 代码，不读写 CRM 记录（[HubSpot 开发者文档：developer MCP server](https://developers.hubspot.com/docs/developer-tooling/local-development/mcp-server)）。在 GitHub 或 npm 上搜「hubspot mcp server」找到的，多半是后者或第三方项目。

授权只有 OAuth 一种。集成文档要求 OAuth 2.1 加 PKCE，和 MCP 规范的授权一节一致（[MCP 规范：Authorization](https://modelcontextprotocol.io/specification/2026-07-28/basic/authorization)；[RFC 7636](https://datatracker.ietf.org/doc/html/rfc7636)），客户端要先在 HubSpot 账号的「开发 → MCP 连接器」里建一个连接器，拿到客户端 ID 和密钥，填好回调地址（[HubSpot 开发者文档：Integrate AI tools with the HubSpot MCP server，2026-11-20 修改](https://developers.hubspot.com/docs/apps/developer-platform/build-apps/integrate-with-the-remote-hubspot-mcp-server)）。HubSpot 开发者博客 2026-11-12 那篇教程补了一句：MCPJam 的表单把客户端密钥标成可选，HubSpot 这台服务器其实要求填（[HubSpot 开发者博客：Connect HubSpot's MCP Server With Any AI Tool Securely](https://developers.hubspot.com/blog/connect-hubspots-mcp-server-with-any-ai-tool-securely)）。我们在 2026-11-22 12:43（新加坡时间）不带令牌请求了一次 `https://mcp.hubspot.com/`，拿到 401，响应头指向它的受保护资源元数据；元数据里 `scopes_supported` 是空数组，授权服务器元数据只接受 S256 的 PKCE、密钥用 `client_secret_post` 传，授权方式除了 `authorization_code` 和 `refresh_token`，还列了 `client_credentials` 和 JWT bearer。文档没有讲后两种怎么用，本文只按授权码流程写。自己接其他 MCP 客户端前，可以先用 [MCP Inspector](https://github.com/modelcontextprotocol/inspector) 连一次，看授权流程能不能走通、工具清单里有什么。自助建 MCP 连接器这个入口 2026-01-20 以公开测试版上线（[HubSpot changelog：Self-Service MCP Auth Apps](https://developers.hubspot.com/changelog/public-beta-self-service-mcp-auth-apps-for-the-hubspot-remote-mcp-server)）；Claude 连接器能读的对象 2025-08-28 起扩到了报价、发票、订单、产品等（[HubSpot changelog：Claude connector additional objects](https://developers.hubspot.com/changelog/claude-connector-additional-objects-and-admin-controls)）。

![终端截图：2026-11-22 12:43 不带令牌 POST https://mcp.hubspot.com/ 返回 HTTP 401，www-authenticate 头指向受保护资源元数据；下面是元数据原文，scopes_supported 为空数组，code_challenge_methods_supported 只有 S256，token_endpoint_auth_methods_supported 是 client_secret_post，青绿框标出这三处。](https://everyinfra.com/articles/hubspot-mcp-pricing/img-hubspot-401.webp?utm_medium=ai_doc&utm_campaign=page_md)

HubSpot MCP server 的 401 和 OAuth 元数据，2026-11-22 新加坡时间 12:43 的真实返回，截图已去掉 Cloudflare Cookie。 | source: 本文实测 https://mcp.hubspot.com/.well-known/oauth-authorization-server

权限范围不在连接器上配。集成文档写得很直接：建 MCP 连接器时你不指定 scope，可用的 scope 由安装时服务器上有哪些工具、用户在授权页勾了哪些权限两件事决定；服务器加了新工具、scope 变了，已经装好的用户要重新安装才能拿到新权限。所有操作都受用户自己在 HubSpot 里的权限约束，看不到的记录 Claude 也看不到。账号开了敏感数据功能的，通话、邮件、会议、笔记、任务这些活动对象会被 MCP server 挡住，这条只针对 MCP server，普通 CRM API 不受影响（[HubSpot changelog，2026-04-13](https://developers.hubspot.com/changelog/remote-hubspot-mcp-server-is-now-generally-available)）。本文要写的笔记就是活动对象，开了敏感数据的账号只能走 API 那条路。

| 对象 | MCP server 读 | MCP server 写 | Claude 连接器写 | 本文用到 |
| --- | --- | --- | --- | --- |
| 公司 | 是 | 建、改 | 建、改，不能删 | 改三个属性 |
| 笔记（活动） | 是 | 建、改 | 建、改，不能删 | 每家公司每周一条摘要 |
| 属性 | 是 | 建自定义属性 | 建，不能改 | 建 3 个属性 |
| 社交帖子 | 读已连接的社交账号 | 草稿、排期 | 建、改 | 不用：HubSpot 只看得到你自己连接的社交账号 |

社交帖子这一行不用，原因是 HubSpot MCP server 能读的社交数据只有你自己连到 HubSpot 的社交账号、你自己排期和发布的帖子及其表现（[HubSpot 集成文档](https://developers.hubspot.com/docs/apps/developer-platform/build-apps/integrate-with-the-remote-hubspot-mcp-server)）。客户公司在 LinkedIn 上发了什么、用户在 Trustpilot 和 Reddit 上怎么说这家公司，HubSpot 里没有，要从公开网站取回来。

## 在 Claude 里同时接 HubSpot MCP 和 EveryInfra MCP

在 Claude 里有两种装法。网页版、桌面版、手机版 Claude 用 HubSpot 自己的连接器：Claude 设置 → 连接器 → 浏览 → 搜 HubSpot → 连接，登录 HubSpot 账号，在授权页勾权限；要求是付费的 Claude 账号（Pro、Max、Team 或 Enterprise），账号里不是超级管理员的用户，要先等超级管理员批准这个连接器、选好它能访问哪些数据（[HubSpot 知识库：Claude 连接器](https://knowledge.hubspot.com/integrations/set-up-and-use-the-hubspot-connector-for-claude)；[HubSpot 知识库：Manage access to apps](https://knowledge.hubspot.com/integrations/manage-access-to-apps)）。EveryInfra 在 Claude 里按自定义连接器加，地址填 `https://api.everyinfra.com/mcp`（[Claude 帮助中心：custom connectors](https://support.claude.com/en/articles/11175166-getting-started-with-custom-connectors-using-remote-mcp)；[EveryInfra MCP 接入](/build/remote-mcp-setup)）。Claude Pro 按月付是每月 $20，按年付折合每月 $17（[Claude 定价，2026-11-22 读取](https://claude.com/pricing)）。

Claude Code 里两台服务器都用命令加。HubSpot 不支持动态注册客户端，要用预先建好的连接器凭据；Claude Code 的 `--client-id` 加 `--client-secret` 会在终端里遮着输入密钥，密钥存进 macOS 钥匙串或凭据文件，不写进配置；回调端口要和你在 HubSpot 连接器里填的回调地址一致，形如 `http://localhost:8080/callback`（[Claude Code 文档：MCP](https://code.claude.com/docs/en/mcp)）。下面是配置示例，HubSpot 一侧我们没有在真实账号上跑：

```bash
# 1) HubSpot MCP server：先在 HubSpot「开发 → MCP 连接器」建连接器，回调地址填 http://localhost:8080/callback
claude mcp add --transport http \
  --client-id "$HUBSPOT_MCP_CLIENT_ID" --client-secret --callback-port 8080 \
  hubspot https://mcp.hubspot.com/
# 之后在 Claude Code 里输入 /mcp，按浏览器提示登录 HubSpot、勾权限

# 2) EveryInfra 远程 MCP：Key 只放在环境变量里，配置文件里写变量名
export EVERYINFRA_API_KEY=...   # 写进 shell 配置或密码管理器，不进仓库
claude mcp add-json everyinfra \
  '{"type":"http","url":"https://api.everyinfra.com/mcp","headers":{"Authorization":"Bearer ${EVERYINFRA_API_KEY}"}}'
```

`${EVERYINFRA_API_KEY}` 由 Claude Code 在连接时展开，`.mcp.json` 可以提交进仓库而不带出 Key。文档提醒一种坑：远程服务器的 `url` 和 `headers` 里，`ANTHROPIC_AUTH_TOKEN` 这类 Claude 自己的凭据变量会被读成空值，目的是防止一个项目的配置把你的 Claude 凭据发给它指定的服务器；自己起的变量名不受影响（[Claude Code 文档：MCP](https://code.claude.com/docs/en/mcp)）。权限按工具收窄：HubSpot 的读工具放行，写工具一律设成询问；EveryInfra 的 `everyinfra_call_api` 会扣费，也可以设成询问，`everyinfra_list_capabilities`、`everyinfra_get_job` 不扣费，可以放行（[Claude Code 文档：permissions](https://code.claude.com/docs/en/permissions)）。

Claude Code 对远程 MCP 每次请求到首字节有一个计时器，取 60 秒、工具超时和 `MCP_TIMEOUT` 三者里最大的一个（[Claude Code 文档：MCP](https://code.claude.com/docs/en/mcp)）。我们这轮三家客户 9 次正常取数，同步返回用时 4.2 到 13.0 秒，都在线内；同一类能力取 200 条以上时，按目录说明加 `"mode":"async"`，拿到 job_id 后用免费的 `everyinfra_get_job` 取结果。

## 实测：3 家客户的公开评论和帖子

三轮调用都用 EveryInfra 的 REST 接口，Key 只经环境变量注入，原始响应全部留存；目录在 2026-11-22 12:42（新加坡时间）读取，当时 106 个平台、714 项能力、683 项可用。三家公司都是公开的软件公司，只当作「CRM 里的客户」样本，和本文的 HubSpot 配置没有关系。三轮调用分在 12:43、12:45 到 12:50、13:03 到 13:07 三个时段，前后 24 分钟，共 31 次请求，其中 18 次扣费，合计 $0.0196；其余 13 次是 429 限速、422 参数错误、409 幂等冲突、幂等回放和空结果，都没有扣费。每家取三样：LinkedIn 公司主页最近 20 条动态（[`linkedin/company_posts`](/linkedin-api/company_posts)，每次 $0.002319）、Trustpilot 最近 30 天的评价（[`trustpilot/reviews`](/trustpilot-api/reviews)，每次 $0.001389，`date=last30days`）、Reddit 最近一个月提到品牌名的帖子（[`reddit/search`](/reddit-api/search)，每次 $0.000792，`sort=newest`）。

| 新加坡时间 | 客户 | LinkedIn 动态 | Trustpilot 30 天评价 | Reddit 帖子 | 返回字节 | 接口费 |
| --- | --- | --- | --- | --- | --- | --- |
| 12:43–12:44 | Calendly | 20 条，2026-08-28 到 11-18，公司自己发 13 条 | 26 条，1 星 5 条，公司回复 0 | 14 条，标题带品牌名 1 条 | 81,122 | $0.0045 |
| 12:45–12:49 | Zapier | 20 条，2026-11-17 到 11-21，公司自己发 8 条 | 9 条，全部 1–2 星，公司回复 0 | 25 条，标题带品牌名 10 条 | 90,841 | $0.0045 |
| 13:03–13:07 | Typeform | 20 条，2026-10-09 到 11-20，公司自己发 9 条；第一次按短名 `typeform` 取到的是同名的另一家公司 | 19 条，1 星 5 条，公司回复 10 条 | 22 条，标题带品牌名 0 条，16 条只是正文贴了表单链接 | 101,389 | $0.0045 |

![分组柱状图：三家客户各三类公开数据的条数。Calendly：LinkedIn 20、Trustpilot 26、Reddit 14；Zapier：LinkedIn 20、Trustpilot 9、Reddit 25；Typeform：LinkedIn 20、Trustpilot 19、Reddit 22。每家合计 54 到 60 条，三家接口费都是 $0.0045。](https://everyinfra.com/articles/hubspot-mcp-pricing/fig-02-items-bar.zh.light.svg?utm_medium=ai_doc&utm_campaign=page_md)

第一轮里有一次故意写错的请求：12:44（新加坡时间）把 Trustpilot 的 `date` 写成 `last14days`，0.74 秒回 422，错误体列出 5 个允许值，`did_you_mean` 给了 `last7days` 和 `last30days`，`next_steps` 第一句是只改 `date` 再发、这次没有扣费。第二轮开始碰上了限速：这把测试 Key 每分钟 10 次，和同一时段其他测试共用，12:45 到 12:50 之间有 8 次请求回 429，每次 0.12 到 0.17 秒返回，响应头带 `retry-after`，都没有扣费；脚本等 60 秒后重发，全部拿到了结果。

### 一家公司一周会冒出几条新内容

回写的频率由新内容的速度决定。Calendly 的 20 条 LinkedIn 动态横跨 2026-08-28 到 11-18，最近 7 天只有 1 条；Zapier 的 20 条全落在 11-17 到 11-21 这 5 天里，最近 7 天就有 20 条，按每周取 20 条会漏。Trustpilot 那边，Calendly 30 天 26 条里最近 7 天 11 条，Zapier 30 天 9 条里最近 7 天 4 条。所以 `limit` 不能一刀切：按上一周的新增条数调，新增数等于上限的，下次加大上限或改成每三天取一次。`linkedin/company_posts` 按次计费，取 10 条和取 50 条都是 $0.002319，对 Zapier 这类发帖密的公司，直接按 50 条取；目录说明里写着部分请求最多只返回 20 条，返回数等于 20 时也按「可能漏了」处理。

LinkedIn 公司动态还有一个要过滤的地方。Calendly 的 20 条里 7 条、Zapier 的 20 条里 12 条，作者是员工或合作公司，公司页只是把帖子转发出来，`author_username` 和公司短名对不上、`author_type` 多为 `profile`。写进 CRM 时要分开：公司自己的公告放「公司动态」，员工个人的帖子要么丢掉，要么只记链接，不把员工的观点写成公司的表态。员工姓名属于个人信息，笔记里只写「员工帖」和链接。

### Trustpilot：低分评价没有人回

Calendly 最近 30 天的 26 条评价里，19 条 5 星、5 条 1 星，18 条是公司邀请来的（`verification_level: invited`）；5 条 1 星都是用户自己找上门写的，讲的是工单拖了几个月、升级后找不到功能、不列颠哥伦比亚省时区切换出错、核心功能宕机没人回、取消订阅难。Zapier 30 天里只有 9 条，全是 1 到 2 星，讲取消订阅、未用月份不退款、认证合作伙伴不负责。两家 35 条评价里，有公司回复的是 0 条。Typeform 的情况不同：19 条里 10 条有公司回复，回复全落在 11-13 及更早的评价上，最近 7 天的 6 条（含 2 条 1 星）还没有回复。客户成功团队可以据此在续约前看到：这家客户的用户在公开评价里集中提到哪些问题、公司有没有回应。

Typeform 的数据还说明一件事：公司回复会晚到一两周。同一条评价这周取到时没有回复，下周再取可能就有了。按评价 ID 记在脚本的本地库里，下周重取时更新同一行，把「公司已回复」补进下一期摘要；只看「本周新增」、不回头更新的，记录里会永远写着「未回复」。所以单条内容的去重键用「平台 + 内容 ID」，不用「客户 + 周次」。

### Reddit：同一条帖子出现在两家客户名下

`reddit/search` 按品牌名搜最近一个月的帖子，命中规则是标题或社区名里有关键词，或者正文里凑齐这些词。Calendly 的 14 条里只有 1 条标题带「Calendly」，是一个开源排程工具的讨论；Zapier 的 25 条里 10 条标题带「Zapier」。两家结果里都有同一组帖子：一个自由职业者把「[FOR HIRE] AI Workflow Automation (Zapier and Make.com)」发进 7 个求职版块，正文里列了 Calendly 和 Zapier 两个技能。按内容 ID 比，Calendly 和 Zapier 的 Reddit 结果重叠 7 条；按标题加正文前 400 字的哈希分组，Calendly 14 条只有 8 种不同内容，Zapier 25 条有 19 种。

![堆叠条形图：三家客户 Reddit 结果的去重情况。Calendly 14 条去重后 8 种内容，Zapier 25 条去重后 19 种，Typeform 22 条去重后 19 种，其中 16 条只是正文里贴了 typeform.com 的表单链接；Calendly 和 Zapier 之间有 7 条是同一组帖子。](https://everyinfra.com/articles/hubspot-mcp-pricing/fig-04-dedupe-share.zh.light.svg?utm_medium=ai_doc&utm_campaign=page_md)

只按「客户 + 帖子 ID」去重，两家公司的记录上各写 7 条，共 14 条内容相同；按「平台 + 帖子 ID」全局去重，脚本里只剩 7 条，每条标上两家客户。这 7 条是同一段文字发在不同版块，再按正文哈希合并，只剩 1 条，附 7 个链接。哪一层合并由你的用途决定：做声量统计的，7 个版块算 7 次曝光；做客户档案的，1 条就够，还要判断这条招聘帖跟客户公司有没有关系，多数情况下没有，直接丢掉。

Typeform 的 Reddit 结果是另一种噪声。22 条里标题带「Typeform」的是 0 条，16 条只是正文里贴了一个 typeform.com 的问卷或报名表链接：社区调查、招聘报名、产品内测登记。按名字讨论这家公司的只有 6 条：3 条是同一份第三方整理的企业清单帖，Typeform 在名单里；1 条是某个 AI 助手产品新上线的连接器名单；1 条是表单工具对比；1 条是用户说自己用别的工具换掉了 Typeform。筛选规则要加一条：品牌名只出现在链接里的帖子直接丢掉。第三方清单这类没有出处可核的帖子，转给客户负责人看，不写成事实。

### LinkedIn 短名：按公司名取，取到了同名公司

Typeform 这一家的第一次调用出了岔子。13:03（新加坡时间）我们按公司名传 `company: typeform`，`linkedin/company_posts` 返回 0 条，`reason` 是 `empty_result_refunded`，没有扣费。为了弄清原因，13:05 用 [`linkedin/company_profile`](/linkedin-api/company_profile)（$0.000556）查了这个短名：它属于都柏林一家 1983 年成立的平面设计公司，官网 typeform.ie，25 名员工、1,800 个关注者，跟做表单的 Typeform 没有关系。搜索 LinkedIn 后，表单公司的短名是 `typeform-`，结尾多一个连字符；13:07 换成这个短名重取，拿到 20 条动态。

这次返回空结果，没扣费。如果同名公司正好在发帖，脚本会把另一家公司的新闻写进你的客户记录，没有任何报错。避免的办法是把 LinkedIn 主页 URL 当成 CRM 里的一个公司属性（例如 `ei_linkedin_slug`）单独存，不从公司名推；第一次取数前先调一次 `linkedin/company_profile`，拿返回的 `website` 跟 HubSpot 公司记录的 `domain` 比，对不上就不写，标给人核对。按每次 $0.000556 算，200 家客户这样核一遍是 $0.11，只做一次，之后每周只核新加入名单的客户。

### 一家客户回写前有多少字节

三家客户每家三次调用返回 81,122 到 101,389 字节，按 4 字节约 1 个 token 粗算，约 2.0 万到 2.5 万 token。200 个客户原样塞进 Claude 的上下文是 400 万 token 以上，一个对话放不下，也没必要：写进 CRM 的只是每家一段几百字的摘要和几条链接。把取数和筛选放在脚本里做（按 ID 去重、丢掉非公司作者、只留最近 7 天），每家只把筛完的几条交给 Claude 写摘要，上下文能降到每家几千 token。

![堆叠条形图：每家客户三次调用返回的字节数。Calendly：LinkedIn 26,613、Trustpilot 23,288、Reddit 31,221，合计 81,122；Zapier：35,688、13,429、41,724，合计 90,841；Typeform：31,376、22,731、47,282，合计 101,389。按 4 字节约 1 token，每家约 2 万 token。](https://everyinfra.com/articles/hubspot-mcp-pricing/fig-03-bytes-bar.zh.light.svg?utm_medium=ai_doc&utm_campaign=page_md)

我们另外经远程 MCP 调了一次，确认 Claude 那条路上拿到的是同一份数据。13:05:24（新加坡时间）我们用 JSON-RPC 的 `tools/call` 调 `everyinfra_call_api`，取 Zapier 最近 7 天的 Trustpilot 评价：返回 4 条、全部 1 星，扣 $0.001389，和 REST 单价相同，字段也一样。这次用了 74.6 秒，同一能力走 REST 的三次是 8.6 到 13.0 秒。只有一次样本，不能说明 MCP 一定更慢，但它已经超过 Claude Code 默认的 60 秒首字节计时器（这次响应是一次性返回的 JSON，首字节和总用时差不多）。在 Claude Code 里接 EveryInfra，把 `MCP_TIMEOUT` 设到 120000 毫秒，或者对评价、动态这类能力加 `"mode":"async"`，再用 `everyinfra_get_job` 取结果。

![终端截图：2026-11-22 13:05:24 用 JSON-RPC 的 tools/call 调 everyinfra_call_api，参数是 trustpilot reviews、zapier.com、last7days；13:06:39 返回 HTTP 200，总用时 74.6 秒，count 4，charged_usd 0.001389；下面 4 条评价都是 1 星，评价人姓名打码。青绿框标出用时和计费两行。](https://everyinfra.com/articles/hubspot-mcp-pricing/img-mcp-roundtrip.webp?utm_medium=ai_doc&utm_campaign=page_md)

经 EveryInfra 远程 MCP 的一次真实往返，个人姓名已打码。 | source: 本文实测 https://api.everyinfra.com/mcp

## 重试不重复扣费：EveryInfra 一侧

每周跑的回写脚本一定会遇到重试：429 限速、网络断开、Claude Code 的首字节计时器到点、HubSpot 写入失败后整批重来。EveryInfra 的规则有三层。第一层，失败和空结果不扣费：12:50（新加坡时间）我们拿一个凑出来的词搜 Reddit，返回 0 条，`charged_usd` 为 0，`reason` 是 `empty_result_refunded`，预扣的 57 个单位当场退回；429、422、409 都没有扣费（[EveryInfra OpenAPI](https://api.everyinfra.com/openapi.json)；[失败退费对账](/build/failure-refund-reconciliation)）。

第二层是 `Idempotency-Key` 请求头。OpenAPI 的说明是：每个逻辑请求用一个新键，1 到 255 个可见 ASCII 字符；同步调用在 24 小时内用同一个键、同样的平台、能力和参数再发，回放第一次成功的响应，`replayed: true`，响应头 `Idempotent-Replayed: true`，不再执行、不再扣费；参数不同回 `409 idempotency_conflict`；第一次还没跑完回 `409 idempotency_in_progress` 并带 `Retry-After`；第一次没成功的，键会释放（[EveryInfra OpenAPI](https://api.everyinfra.com/openapi.json)）。我们在 12:49 实测了三步：

```bash
K="hs-weekly-2026w47-zapier-profile"   # 周次 + 客户 + 能力，同一周重跑用同一个键
curl -s https://api.everyinfra.com/api/v1/social \
  -H "Authorization: Bearer $EVERYINFRA_API_KEY" -H "Content-Type: application/json" \
  -H "Idempotency-Key: $K" \
  -d '{"platform":"linkedin","action":"company_profile","params":{"company":"zapier"}}'
# 12:49:16 第一次：200，9.32 秒，id req_253a4b3503e5441a，charged_usd 0.000556
# 12:49:34 同键同参数重发：200，0.58 秒，同一个 id，replayed: true，响应头 idempotent-replayed: true
# 12:49:43 同键换成 calendly：409 idempotency_conflict，0.13 秒，next_steps 写明没有扣费
```

![终端截图：三次带同一个 Idempotency-Key 的真实请求。第一次 200、9.32 秒、charged_usd 0.000556；第二次 200、0.58 秒、同一个请求 id、replayed true、响应头 idempotent-replayed: true；第三次换了参数，409 idempotency_conflict，错误说明写着没有扣费。青绿框标出 replayed 和 409 两处。](https://everyinfra.com/articles/hubspot-mcp-pricing/img-idem-replay.webp?utm_medium=ai_doc&utm_campaign=page_md)

同一个键重发拿回原响应，换参数被拒，2026-11-22 新加坡时间 12:49 的真实返回。 | source: 本文实测 https://api.everyinfra.com/api/v1/social

回放的响应里 `billing.charged_usd` 仍是 0.000556，那是第一次响应的原样副本，`id` 也和第一次相同；账单上只有一笔。键怎么起名决定了「什么算同一次」：用「周次 + 客户 + 能力」，同一周内无论重跑几次都只扣一次，下一周换键重新取；用随机 UUID，每次重跑都是新请求，等于没加。IETF 的 HTTP API 工作组正在把这个请求头写成标准，草案第 9 版 2026-11-21 发布，定义和我们的用法一致：键由客户端生成，服务端用它认出同一请求的重试（[IETF：draft-ietf-httpapi-idempotency-key-header-09](https://datatracker.ietf.org/doc/draft-ietf-httpapi-idempotency-key-header/)）。HTTP 语义规范把 POST 列为非幂等方法，所以不带键的 POST 重发，服务端只能当成新请求（[RFC 9110](https://www.rfc-editor.org/rfc/rfc9110.html)）。

第三层在远程 MCP 上。`everyinfra_call_api` 这个工具的参数里没有幂等键，Claude 在对话里重试同步调用，每次都算一次新请求；异步提交（`mode: async`）在 5 分钟内参数完全相同的会合并，返回原来那个任务，不另扣费。每周的批量回写放在脚本里走 REST 加 `Idempotency-Key`，Claude 只负责读筛完的数据、写摘要、提交 HubSpot 写入。

## HubSpot 一侧怎么防重复写入：按文档的写法，未实跑

HubSpot 的 CRM API 没有请求级的幂等键。r/hubspot 一位用 Claude Code 跑了三周 HubSpot 的用户把这条列在他的 7 个坑里：建自定义属性时属性已存在就回 409，服务端没有幂等键，只能自己吞掉 409；同一帖子还提到，`PATCH` 一个交易时只带一个字段，其他两个相关字段被清空，笔记的 `hs_timestamp` 不是带 Z 的 UTC 格式会失败（[Reddit r/hubspot，2026](https://www.reddit.com/r/hubspot/comments/1ss3ma7/3_weeks_running_hubspot_from_claude_code_cli/)）。这些是一位用户的经验，后两条我们在 HubSpot 文档里没有找到对应说明，配置前先在测试账号上复现。

HubSpot 文档里能直接拿来去重的有三样。第一样是记录 ID：每条记录建好就有 `hs_object_id`，按 ID 更新同一条记录不会新增；公司还有域名，公司文档建议建公司时总带上 `domain`，它是避免重复公司的主要唯一标识（[HubSpot：Companies API](https://developers.hubspot.com/docs/api-reference/latest/crm/objects/companies/guide)）。第二样是唯一值属性：属性文档写明每个对象最多 10 个唯一 ID 属性，建属性时把 `hasUniqueValue` 设为 `true`，之后可以用 `idProperty` 按它取记录（[HubSpot 开发者文档：Properties API](https://developers.hubspot.com/docs/api-reference/latest/crm/properties/guide)）；知识库补充说这个设置只能在建属性时打开，目前不支持反馈提交、营销活动和产品三类对象（[HubSpot 知识库：Set validation rules for a property](https://knowledge.hubspot.com/properties/set-validation-rules-for-properties)）。第三样是搜索：笔记属于可搜索的活动对象，搜索接口能用 `associations.company` 这个伪属性筛出挂在某家公司上的记录；文档也提醒，新建或刚改过的记录要过一会儿才出现在搜索结果里，搜索接口每个账号每秒限 5 次（[HubSpot：Search the CRM](https://developers.hubspot.com/docs/api-reference/latest/crm/search-the-crm)）。

笔记上能不能建唯一值属性，文档没有写明。笔记有一个「按唯一属性值批量 upsert」的接口（[HubSpot：Upsert notes](https://developers.hubspot.com/docs/api-reference/latest/crm/activities/notes/batch/upsert-notes)），知识库的排除名单里也没有笔记，但没有一页明说可以在笔记上建 `hasUniqueValue` 自定义属性；我们没有 HubSpot 账号，没有试。所以下面的主方案只用有明文的做法：单条内容在脚本本地去重，每家公司每周写一条摘要笔记，笔记 ID 和周次记在公司的自定义属性上，重跑时按笔记 ID 改同一条。

| 写什么 | 去重键 | 写入方式 | 重跑一次的结果 |
| --- | --- | --- | --- |
| 一条公开内容 | 平台 + 内容 ID，例如 `reddit:t3_1y2fct9`，存在脚本本地库 | 不单独写进 HubSpot，进当周摘要 | 本地库已有就只更新状态，例如「公司已回复」 |
| 笔记：本周摘要 | 公司记录 ID + 周次；笔记 ID 记在公司属性 `ei_digest_note_id` | 本周还没有：`notes/batch/create`，建时带公司关联；已有：`notes/batch/update` 按笔记 ID 改 | 改同一条笔记，不新增 |
| 公司：`ei_low_reviews`、`ei_digest_week`、`ei_digest_note_id` | 公司记录 ID（`hs_object_id`） | [`companies/batch/update`](https://developers.hubspot.com/docs/api-reference/latest/crm/objects/companies/batch/update-companies) | 同值覆盖，无副作用 |
| 笔记和公司的关联 | 新建笔记时在请求体里带上 | 类型 ID 190（笔记到公司），只在新建时带 | 改笔记不重建关联 |

```text
# 1) 第一步的公司搜索里一并带回：本周写过没有、摘要笔记 ID 是多少
POST https://api.hubapi.com/crm/objects/2026-09/companies/search
{ "filterGroups": [ { "filters": [ { "propertyName": "ei_linkedin_slug", "operator": "HAS_PROPERTY" } ] } ],
  "properties": [ "domain", "ei_linkedin_slug", "ei_digest_week", "ei_digest_note_id" ], "limit": 100 }

# 2a) ei_digest_week 不是本周：新建摘要笔记，建的同时关联到公司
POST https://api.hubapi.com/crm/objects/2026-09/notes/batch/create
{ "inputs": [ { "properties": { "hs_timestamp": "2026-11-22T04:45:00Z",
      "hs_note_body": "2026-W47 · Zapier · 本周公开动态：……" },
    "associations": [ { "to": { "id": "8812345" },
      "types": [ { "associationCategory": "HUBSPOT_DEFINED", "associationTypeId": 190 } ] } ] } ] }

# 2b) ei_digest_week 已是本周：按 ei_digest_note_id 改同一条
POST https://api.hubapi.com/crm/objects/2026-09/notes/batch/update
{ "inputs": [ { "id": "<ei_digest_note_id>", "properties": { "hs_note_body": "2026-W47 · Zapier · ……" } } ] }

# 3) 把笔记 ID、周次和低分评价数写回公司
POST https://api.hubapi.com/crm/objects/2026-09/companies/batch/update
{ "inputs": [ { "id": "8812345", "properties": {
    "ei_digest_week": "2026-W47", "ei_digest_note_id": "<新笔记 ID>", "ei_low_reviews": "4" } } ] }
```

上面是配置示例，没有在 HubSpot 账号上跑过。这套写法有一个空档：脚本在 2a 建完笔记、还没走到第 3 步就中断，公司上没有记下笔记 ID，重跑会再建一条。补法是重跑时对 `ei_digest_week` 不是本周的公司，先按 `associations.company` 加本周的 `hs_timestamp` 范围搜一次笔记，找到正文以「2026-W47 ·」开头的，就把它的 ID 补写回公司、改走 2b；搜索结果有延迟，中断后隔几分钟再重跑。如果你的测试账号能在笔记上建 `hasUniqueValue` 属性，可以换成 `notes/batch/upsert` 加 `idProperty`，一步写完、没有这个空档，用之前先在测试账号里确认。笔记正文最长 65,536 个字符，时间字段 `hs_timestamp` 必填；关联到公司用 HUBSPOT_DEFINED 类别、类型 ID 190，关联到交易是 214（[HubSpot 开发者文档：Notes API](https://developers.hubspot.com/docs/api-reference/latest/crm/activities/notes/guide)）。

在测试账号里验这套写法，看三件事，任何一条不成立，就先别接生产账号。

| 检查 | 怎么做 | 通过的标准 |
| --- | --- | --- |
| 同周重跑 | 同一周把脚本连跑两次 | 第二次只发 `notes/batch/update`、没有 `notes/batch/create`；公司时间线上本周摘要仍是 1 条 |
| 中断补位 | 在 2a 和第 3 步之间停掉脚本，隔几分钟重跑 | 搜索补回了笔记 ID，没有多出第二条 |
| 跨周 | 换成下一周的周次再跑 | 新建了一条新摘要，上一周那条没有被改 |

开发者测试账号是免费的，带 90 天的多数企业版功能试用，一个开发者账号最多建 10 个（[HubSpot 开发者文档：Account types](https://developers.hubspot.com/docs/getting-started/account-types)）。

走 Claude 连接器写入时，这些键同样适用，只是写法换成提示词：让 Claude 先读公司的 `ei_digest_week` 和 `ei_digest_note_id`，本周已有摘要就改那一条，没有才新建、建完把笔记 ID 写回公司，每批不超过 10 条，写之前列出要写的记录给你批准。HubSpot 建议先改一条记录再批量改，并在 Claude 的连接器工具设置里把写工具设成「需要批准」（[HubSpot 知识库：Claude 连接器](https://knowledge.hubspot.com/integrations/set-up-and-use-the-hubspot-connector-for-claude)）。用 Claude 建或改的记录，会在 HubSpot 的审计日志里同时记到用户和 Claude 连接器名下，出了问题能查到是哪一次对话写的。

![时间线流程图：每周一次回写，左边是 EveryInfra 取数，三种结果分三条线：成功的带 Idempotency-Key 写入本地缓存，重发时回放、不扣费；空结果和失败退费；429 等待后重发。右边是 HubSpot 写入（按文档的配置示例）：公司上记着本周摘要笔记的 ID，重跑按 ID 改同一条，不新增；公司属性按记录 ID 覆盖。](https://everyinfra.com/articles/hubspot-mcp-pricing/fig-06-retry-timeline.zh.light.svg?utm_medium=ai_doc&utm_campaign=page_md)

## 每周脚本按什么顺序跑

一次每周回写按六步走。第一步，用服务密钥按属性搜出要处理的公司，带上记录 ID、域名、`ei_linkedin_slug`、`ei_digest_week` 和 `ei_digest_note_id`。第二步，对新加入名单、还没核过 LinkedIn 短名的公司，先调一次 `linkedin/company_profile`，官网域名和 HubSpot 的 `domain` 对不上的，标给人核对，本周不取。第三步，按「周次 + 客户 + 能力」生成 `Idempotency-Key`，依次调三种能力；遇到 429 按 `retry-after` 等，遇到 422 按 `did_you_mean` 改参数，改了参数就换一个新键。第四步，在脚本里去重和筛选：按「平台 + 内容 ID」全局去重，丢掉非公司作者的 LinkedIn 动态和只贴了表单链接的 Reddit 帖子，只留最近 7 天。第五步，每家只把筛完的几条交给 Claude 写摘要，人看一遍汇总。第六步，本周还没有摘要的公司批量新建笔记、建时带上公司关联，已有的按笔记 ID 批量改，再把笔记 ID、周次和低分评价数批量写回公司。

中途任何一步失败，整个脚本从头再跑一遍就行：第三步的同一个键回放原响应、不再扣费，第六步按公司上记的笔记 ID 改同一条、不新增，中断在建笔记和写回公司之间的，按上一节的搜索补上。HubSpot 那条「错误请求不超过 5%」的线，靠第六步之前的一次自检守住：先用一条记录试写，确认属性名、关联类型 ID 都对，再提交整批。

## 每周 200 个客户：两边各花多少

EveryInfra 一侧按目录单价算：每家客户每周一次 `linkedin/company_posts`（$0.002319）、一次 `trustpilot/reviews`（$0.001389）、一次 `reddit/search`（$0.000792），合计 $0.0045。200 家每周 600 次调用、最多 $0.90，按一年 52 周折算每月最多 $3.90、一年最多 $46.80。「最多」是因为空结果不扣费：一家没有 Trustpilot 页面的客户，那次调用不花钱。三家实测各扣 $0.0045，没有出现空结果。

| 项目 | 每周 | 每月（×52/12） | 出处 |
| --- | --- | --- | --- |
| EveryInfra 接口费，200 个客户 × 3 次 | 最多 $0.90 | 最多 $3.90 | 目录 `price_usd`，三家实测各 $0.0045 |
| HubSpot API 请求，走批量接口 | 约 6 次 | 约 26 次 | 本文写法；入门版每天 250,000 次 |
| HubSpot Claude 连接器写入批次 | 40 批，每批最多 10 条 | 约 173 批 | Claude 连接器帮助页 |
| HubSpot Credits | 0 | 0 | 不走受管环境就不扣 |
| Claude Pro 一个席位 | — | $20（按年 $17） | Claude 定价页，2026-11-22 读取 |
| HubSpot API 加量包 | 用不到 | $500 一包 | 产品目录 Technical Limits |

![横向条形图，每月美元：EveryInfra 接口费 200 个客户最多 $3.90；Claude Pro 一个席位 $20；HubSpot API 加量包一包 $500（这件活用不到）；HubSpot Credits 0（不走受管环境）。](https://everyinfra.com/articles/hubspot-mcp-pricing/fig-05-weekly-cost-bar.zh.light.svg?utm_medium=ai_doc&utm_campaign=page_md)

连接器路线每周 40 次批准；脚本路线把写入放进 6 次 API 请求，人只看一份汇总。同一周里一部分公司写过、一部分没写时，第六步的笔记要分新建和修改两批，200 家最多 3 批，一周合计最多 7 次请求，仍是额度的零头。HubSpot 的公告没有说一个席位的「日常使用」上限是多少，一个人每周让 Claude 改 200 家公司、建 200 条笔记，算不算超出、超出后扣多少 Credits，要等 HubSpot 公布费率。在那之前，量大的回写按 API 额度算账，额度有公开数字。

### 三条路怎么选

按这件活的量，可以这样分。每周只盯十几家重点客户、每条都想自己看一眼再写的，用 Claude 连接器，一周十几次批准，费用随席位。每周固定 200 家、要能随时重跑的，写脚本走 API，用一把带名字的服务密钥，每周 6 次请求，HubSpot 一侧不花额外的钱。账号开了敏感数据功能的，笔记写不进 MCP，只能走 API。受管环境上线后，要看三件事再决定要不要换过去：每次写入或每条记录扣多少 Credits；扣的是套餐自带的 Credits 还是要另买；HubSpot 会不会把现在算作 API 用量的某些 agent 用法划进受管环境。公告里这三件都还没有答案。

### 一条周报笔记写成什么样

笔记正文最长 65,536 个字符，够放一整周的东西，但给客户负责人看的笔记越短越好。我们给这件活定的格式是：第一行写周次和一句话结论，接着按平台分三段，每段最多 3 条，每条只写日期、要点和链接，最后一行写这次取数的请求 id，方便对账。下面是按 Zapier 这周的真实数据写的示例（评价人姓名不写）：

```text
2026-W47 · Zapier · 本周公开动态：Trustpilot 4 条新评价全是 1 星，主题是取消和退款；公司未回复。
LinkedIn（公司发 8 条）：11-17、11-18 两条自家 AutomationBench 模型排名；11-19 纽约线下活动报名；其余 5 条是轻松内容，只记链接。
Trustpilot：11-22 1★ 自动化流程报错、未用月份不退款；11-20 1★ 取消订阅难；11-18 1★ 希望公司换工具；11-17 1★ 体验差。
Reddit：10 条标题提到 Zapier，7 条是同一自由职业者的招聘帖（已合并为 1 条，未关联客户）。
来源请求：req_b2ebb0fd3327401a（2026-11-22 13:05 SGT）
```

公司属性里能筛选的数有两个：`ei_low_reviews` 记本周 1 到 2 星评价数，`ei_digest_week` 记最近一次写入的周次；第三个属性 `ei_digest_note_id` 只给脚本防重复用。客户成功团队在 HubSpot 里按 `ei_low_reviews` 排序，就能看到这周哪几家客户的公开差评最多。

## 视频里演示了、文档里没写的

我们用 `youtube/search` 搜「hubspot mcp」（2026-11-22 13:03，新加坡时间），取了 5 条视频的英文字幕（每条 $0.000556，每次 3.9 到 6.1 秒）：搜索结果前三条，加两条不在前十里的 Claude 加 HubSpot 入门和测评视频，其中入门那条和前三条内容重复，没有用。前三条是一位 RevOps 顾问 2025-06 发的 10 分钟演示（19,601 次观看），一位 GTM 工程师 2026-08 发的 15 分钟实测（85,382 次观看，前十条里最多），HubSpot 开发者频道 2025-10 发的 6 分钟开发者 MCP 教程（2,920 次观看）。

第一条视频教的是旧装法：在 HubSpot 设置里建私有应用，作者建议「把所有 scope 都勾上」，再把令牌贴进 Claude 桌面版的 `claude_desktop_config.json`，跑的是 npm 上的本地包。这条路现在走不通了：HubSpot 文档写明，2026-10-26 起不能再新建旧版私有应用，已有的继续可用（[HubSpot 开发者文档：Legacy private apps](https://developers.hubspot.com/docs/apps/legacy-apps/private-apps/overview)）。就算还有旧应用，全 scope 的令牌也不该交给 Claude。这条视频还演示了让 Claude 上网查一家公司的 8 位高管、直接在 CRM 里建成联系人，中间没有批准步骤，同一句话重跑一次，CRM 里就多出 8 个重复联系人。

第二条视频补了三件文档没写全的事。一是写工具「manage CRM objects」上线时，作者没有在 changelog 里看到通知，于是自己写了个每小时拉一次工具清单、有变化就提示的小工具；脚本里不写死工具名，每次先看 `get_user_details` 的返回。二是服务密钥可以起名，用这把密钥建或改的记录，在活动面板和审计日志里显示这个名字；回写脚本单独建一把带名字的服务密钥，出了问题按名字就能查。三是个人访问密钥（personal access key）对 CRM 对象只读，写入要用服务密钥或应用。演示里他把 Claude 的工具权限设成「总是允许」来跳过批准，跟 HubSpot 建议的「需要批准」相反，生产账号不要照抄。他还猜测 MCP 连接器的回调地址写本机地址会不稳，Claude Code 文档的示例用的是本机回调，这点他没验证，我们也没有验证。

第三条讲的是开发者 MCP server：先在「产品更新 → 测试版」里报名，再在终端跑 `hs mcp setup` 选 IDE，它帮你建项目、查构建错误，不碰 CRM 数据，搜「hubspot mcp」的人点进去容易装错。补看的那条测评说当时 MCP server 读不到笔记；现在的集成文档写的是只有开了敏感数据的账号，笔记这类活动对象才会被挡住，连上后用 `get_user_details` 看对象清单就能确认自己的账号是哪种情况。

## 做不了、要注意的地方

HubSpot 一侧的配置本文没有在真实账号上跑，全部是配置示例；HubSpot 的数字来自 2026-11-22 读取的公开文档和公告。防重复写入那套写法是按 HubSpot 文档推出来的，笔记上能不能建唯一值属性文档没写明，都要先在测试账号里跑一遍。HubSpot 一侧每周 6 到 7 次请求、连接器 40 批写入，都是按文档里每批 100 条、每批 10 条的上限推算出来的，没有实发过。HubSpot 连接器和 MCP server 的工具清单因订阅、权限和账号配置而不同，文档建议连上后先调 `get_user_details` 看自己能用哪些工具和对象，我们没有授权的账号，没法列出工具名（[HubSpot 集成文档](https://developers.hubspot.com/docs/apps/developer-platform/build-apps/integrate-with-the-remote-hubspot-mcp-server)）。

EveryInfra 一侧的边界：三家客户各取一次，样本小，「一周新增几条」只代表 2026 年 11 月下旬这几天；`reddit/search` 只搜最近一个月、只搜帖子不搜评论，品牌名是常用词的公司误命中会更多；LinkedIn 公司动态的作者字段有时为空。远程 MCP 只调了一次，74.6 秒说明不了常态。视频只看了 4 条，代表的是创作者的演示，不代表 HubSpot 文档里的做法。数据来自公开网页，写进 CRM 之前先确认你所在地区对客户公开信息的使用规则，本文不提供法律意见。

不要把客户的公开评论当成客户本人的意见写进联系人记录：一条 Trustpilot 评价是这家公司的某个用户写的，跟你 CRM 里这家公司的联系人通常不是同一个人。笔记里写清楚来源平台、日期和链接，评价人的姓名不进 CRM。

## 行业动向

- 2026-11-12，HubSpot 开发者博客发布自定义 MCP 连接器教程，用 MCPJam 演示连接、只读授权和「I accept the risk」确认（[HubSpot 开发者博客](https://developers.hubspot.com/blog/connect-hubspots-mcp-server-with-any-ai-tool-securely)）。对读者：没有现成连接器的 AI 工具，现在可以按这篇自己接。
- 2026-11-17，HubSpot 公布无头定价（[HubSpot](https://www.hubspot.com/company-news/pricing-headless)）。对读者：连接器日常使用不另收费，自建 agent 占 API 额度，量大的活先算 API 额度。
- 2026-11-21，IETF HTTP API 工作组发布 `Idempotency-Key` 请求头草案第 9 版（[IETF](https://datatracker.ietf.org/doc/draft-ietf-httpapi-idempotency-key-header/)）。对读者：自己写的回写服务也可以按这个草案接受幂等键，Claude 重试时就不会重复写。

## 常见问题

**HubSpot MCP server 的 URL 是什么？**

`https://mcp.hubspot.com`，传输方式是 Streamable HTTP，授权是 OAuth 2.1 加 PKCE（S256），要用你在 HubSpot「开发 → MCP 连接器」里建的连接器的客户端 ID 和密钥（[HubSpot 集成文档](https://developers.hubspot.com/docs/apps/developer-platform/build-apps/integrate-with-the-remote-hubspot-mcp-server)）。

**HubSpot MCP server 要另外付费吗？**

按 2026-11-17 的无头定价，在 Claude、ChatGPT 等连接器里的日常使用随 HubSpot 席位附送；自建 agent 调 API 占套餐 API 额度，不扣 Credits；只有 HubSpot 在建的受管环境按 Credits 计费，每个 $0.010（[HubSpot](https://www.hubspot.com/company-news/pricing-headless)）。AI 工具本身的订阅另算，例如 Claude Pro 每月 $20。

**hubspot mcp claude code 怎么配？**

HubSpot 不支持动态注册客户端，用 `claude mcp add --transport http --client-id <ID> --client-secret --callback-port 8080 hubspot https://mcp.hubspot.com/`，回调地址和 HubSpot 连接器里填的一致，然后在 Claude Code 里输入 `/mcp` 登录（[Claude Code 文档](https://code.claude.com/docs/en/mcp)）。

**HubSpot MCP 有哪些工具？**

工具清单因订阅、用户权限和账号配置而不同，连上后先调 `get_user_details`，它会返回你的用户、账号和可用对象及工具（[HubSpot 集成文档](https://developers.hubspot.com/docs/apps/developer-platform/build-apps/integrate-with-the-remote-hubspot-mcp-server)）。

**GitHub 上的 HubSpot MCP server 和 mcp.hubspot.com 是一回事吗？**

不是同一个东西。`mcp.hubspot.com` 是 HubSpot 托管的远程服务器，读写 CRM；HubSpot 的开发者 MCP server 随 HubSpot CLI 在本机运行，帮你开发应用和 CMS，不读写 CRM 记录（[HubSpot 开发者 MCP 文档](https://developers.hubspot.com/docs/developer-tooling/local-development/mcp-server)；[HubSpot CLI 仓库](https://github.com/HubSpot/hubspot-cli)）。

**HubSpot 现在还能建私有应用吗？**

不能新建了。HubSpot 文档写明，2026-10-26 起旧版私有应用不能再创建，已有的继续可用；新的集成用服务密钥或开发者平台上的应用，服务密钥和私有发布的应用共用同一套限额（[HubSpot 开发者文档：Legacy private apps](https://developers.hubspot.com/docs/apps/legacy-apps/private-apps/overview)）。2025 年的一些教程还在教建私有应用、勾全部 scope，照做会找不到入口。

**HubSpot MCP 能看到客户在 LinkedIn、Trustpilot、Reddit 上的公开内容吗？**

看不到。它的社交功能只覆盖你自己连接到 HubSpot 的社交账号和你自己的帖子（[HubSpot 集成文档](https://developers.hubspot.com/docs/apps/developer-platform/build-apps/integrate-with-the-remote-hubspot-mcp-server)）。客户公司的公开动态和评价要从外部取，例如用 EveryInfra 的 [`linkedin/company_posts`](/linkedin-api/company_posts) 和 [`trustpilot/reviews`](/trustpilot-api/reviews)。

## 上手步骤

1. 在 [EveryInfra 快速上手](/docs#quickstart) 注册并拿到 Key，放进环境变量 `EVERYINFRA_API_KEY`；在 [MCP 接入页](/mcp-server) 按 Claude 或 Claude Code 的写法加 `https://api.everyinfra.com/mcp`。
1. 在 HubSpot 建 MCP 连接器（Claude 网页版用 HubSpot 自己的连接器就不用建），写工具设成需要批准。
1. 在 HubSpot 测试账号给公司建三个自定义属性：`ei_digest_week`、`ei_digest_note_id`、`ei_low_reviews`。
1. 先拿一家客户跑通：取 [LinkedIn 公司动态](/linkedin-api)、[Trustpilot 评价](/trustpilot-api)、[Reddit 帖子](/reddit-api)，每次请求带 `Idempotency-Key`（周次 + 客户 + 能力），去重后让 Claude 写摘要，批准后写入这家公司本周的摘要笔记。
1. 把同一个请求再跑一遍，确认 EveryInfra 账单没有新扣费、HubSpot 里没有多出笔记；再扩到 200 家，按 [价格页](/pricing) 和目录单价核对账单。

更多同类做法：[Atlassian MCP server 竞品工单周报](/blog/atlassian-mcp-server)、[Outreach MCP 销售跟进](/blog/outreach-mcp)、[ActiveCampaign 接社媒评论](/blog/activecampaign-mcp-active-intelligence-social-review-data)、[错误自愈](/build/api-errors-self-healing)。

## 参考资料

1. HubSpot is headless. Here's how we'll price it，HubSpot，2026-11-17，https://www.hubspot.com/company-news/pricing-headless
1. Integrate AI tools with the HubSpot MCP server，HubSpot 开发者文档，2026-11-20 修改，https://developers.hubspot.com/docs/apps/developer-platform/build-apps/integrate-with-the-remote-hubspot-mcp-server
1. Using the HubSpot MCP server，HubSpot 开发者文档，2026-09-18，https://developers.hubspot.com/docs/build-with-ai/remote-mcp-server
1. Remote HubSpot MCP server is now generally available，HubSpot 开发者 changelog，2026-04-13，https://developers.hubspot.com/changelog/remote-hubspot-mcp-server-is-now-generally-available
1. Connect HubSpot's MCP Server With Any AI Tool Securely，HubSpot 开发者博客，2026-11-12，https://developers.hubspot.com/blog/connect-hubspots-mcp-server-with-any-ai-tool-securely
1. API usage guidelines and limits，HubSpot 开发者文档，2026-11-22 读取，https://developers.hubspot.com/docs/developer-tooling/platform/usage-guidelines
1. Technical Limits，HubSpot 产品与服务目录，2026-11-22 读取，https://legal.hubspot.com/hubspot-product-and-services-catalog/technical-limits
1. HubSpot Product & Services Catalog，HubSpot，2026-11-22 读取，https://legal.hubspot.com/hubspot-product-and-services-catalog
1. HubSpot Credits，HubSpot，2026-11-22 读取，https://www.hubspot.com/products/artificial-intelligence/credits
1. Sales Software Pricing，HubSpot，2026-11-22 读取，https://www.hubspot.com/pricing/sales
1. Set up and use the HubSpot connector for Claude，HubSpot 知识库，2026-11-22 读取，https://knowledge.hubspot.com/integrations/set-up-and-use-the-hubspot-connector-for-claude
1. Manage access to apps，HubSpot 知识库，https://knowledge.hubspot.com/integrations/manage-access-to-apps
1. Properties API，HubSpot 开发者文档，https://developers.hubspot.com/docs/api-reference/latest/crm/properties/guide
1. Set validation rules for a property，HubSpot 知识库，2026-11-22 读取，https://knowledge.hubspot.com/properties/set-validation-rules-for-properties
1. Companies API，HubSpot 开发者文档，2026-11-16 修改，https://developers.hubspot.com/docs/api-reference/latest/crm/objects/companies/guide
1. Create or update a batch of companies by unique property values，HubSpot 开发者文档，2026-11-16 修改，https://developers.hubspot.com/docs/api-reference/latest/crm/objects/companies/batch/upsert-companies
1. Create or update a batch of notes by unique property values，HubSpot 开发者文档，https://developers.hubspot.com/docs/api-reference/latest/crm/activities/notes/batch/upsert-notes
1. Notes API，HubSpot 开发者文档，2026-11-16 修改，https://developers.hubspot.com/docs/api-reference/latest/crm/activities/notes/guide
1. Update a batch of companies，HubSpot 开发者文档，https://developers.hubspot.com/docs/api-reference/latest/crm/objects/companies/batch/update-companies
1. Developer MCP server，HubSpot 开发者文档，https://developers.hubspot.com/docs/developer-tooling/local-development/mcp-server
1. HubSpot CLI，GitHub，https://github.com/HubSpot/hubspot-cli
1. HubSpot won't charge extra when Claude or ChatGPT works its CRM，PPC Land，2026-11-19，https://ppc.land/hubspot-wont-charge-extra-when-claude-or-chatgpt-works-its-crm/
1. HubSpot Just Announced New Headless Pricing，IMPACT，2026-11，https://www.impactplus.com/learn/hubspot-just-announced-new-headless-pricing-what-this-means-in-plain-english
1. Connect to local MCP servers / MCP，Claude Code 文档，2026-11-22 读取，https://code.claude.com/docs/en/mcp
1. Permissions，Claude Code 文档，https://code.claude.com/docs/en/permissions
1. Getting started with custom connectors using remote MCP，Claude 帮助中心，https://support.claude.com/en/articles/11175166-getting-started-with-custom-connectors-using-remote-mcp
1. Plans & pricing，Claude，2026-11-22 读取，https://claude.com/pricing
1. Authorization，MCP 规范 2026-07-28，https://modelcontextprotocol.io/specification/2026-07-28/basic/authorization
1. RFC 7636：Proof Key for Code Exchange，IETF，https://datatracker.ietf.org/doc/html/rfc7636
1. The Idempotency-Key HTTP Header Field，draft-09，IETF，2026-11-21，https://datatracker.ietf.org/doc/draft-ietf-httpapi-idempotency-key-header/
1. RFC 9110：HTTP Semantics，IETF，https://www.rfc-editor.org/rfc/rfc9110.html
1. EveryInfra 能力目录，2026-11-22 12:42 读取，https://api.everyinfra.com/api/v1/social/catalog
1. EveryInfra OpenAPI，2026-11-22 读取，https://api.everyinfra.com/openapi.json
1. 3 weeks running HubSpot from Claude Code CLI instead of MCP，Reddit r/hubspot，https://www.reddit.com/r/hubspot/comments/1ss3ma7/3_weeks_running_hubspot_from_claude_code_cli/
1. Anyone using HubSpot MCP?，Reddit r/hubspot，https://www.reddit.com/r/hubspot/comments/1r1d23e/anyone_using_hubspot_mcp/
1. MCP Inspector，GitHub，https://github.com/modelcontextprotocol/inspector
1. Authentication overview，HubSpot 开发者文档，https://developers.hubspot.com/docs/apps/developer-platform/build-apps/authentication/overview
1. Make API requests using a service key，HubSpot 开发者文档，2026-10-28，https://developers.hubspot.com/docs/apps/developer-platform/build-apps/authentication/account-service-keys
1. HubSpot Account Types，HubSpot 开发者文档，https://developers.hubspot.com/docs/getting-started/account-types
1. Legacy private apps，HubSpot 开发者文档，2026-10-30 修改，https://developers.hubspot.com/docs/apps/legacy-apps/private-apps/overview
1. Search the CRM，HubSpot 开发者文档，https://developers.hubspot.com/docs/api-reference/latest/crm/search-the-crm
1. Public Beta: Self-Service MCP Auth Apps for the HubSpot Remote MCP Server，HubSpot 开发者 changelog，2026-01-20，https://developers.hubspot.com/changelog/public-beta-self-service-mcp-auth-apps-for-the-hubspot-remote-mcp-server
1. HubSpot connector for Claude: Additional Object Access and Admin Controls，HubSpot 开发者 changelog，2025-08-28，https://developers.hubspot.com/changelog/claude-connector-additional-objects-and-admin-controls
