Kabo MCP 文档

快速开始

几分钟即可完成连接。

只要客户端能通过 HTTP 添加远程 MCP 服务器、并能用 OAuth 登录，就能用 Kabo。各家菜单名称不同，但步骤一样。

1. 添加远程服务器

   打开客户端的 MCP 或连接器设置，添加一个服务器，地址填 https://kabo.sh/mcp-pub。

2. 登录 Kabo

   客户端会在浏览器里打开 Kabo 的登录页。登录或注册账号，看清 Kabo 申请的权限，然后批准。

3. 检查可用工具

   让助手使用空对象调用 get_research_capabilities，查看你的账号当前可用的数据研究工具。此检查不消耗额度。

{
  "mcpServers": {
    "kabo": {
      "url": "https://kabo.sh/mcp-pub"
    }
  }
}

如果你的客户端用 JSON 文件配置，条目通常长这样。不同客户端的字段名不一样，请以它的文档为准。

Skills

为已有 MCP 连接安装 Skills。

已经连接好了？Kabo 的十个可选 Skills 提供账号复盘、趋势研究、竞品分析、视频分析、创意和脚本工作流，复用已有 MCP 连接和 Kabo 登录状态。仅连接 MCP 不会自动安装 Skills。

Kabo Skills 可用于电脑、远程工作区或云端环境中的兼容 agent。Codex、Claude Code 和 Cursor 只是示例，并不是完整的支持名单。

Agent 的运行环境需要能加载 SKILL.md 及随附文件、使用 Python 3 执行所需脚本，并调用你已授权的 Kabo MCP 连接。是否兼容取决于这些能力，而不是界面是桌面应用还是网页。

官方仓库与 README
https://github.com/kabo-sh/kabo-mcp-plugin

方式一：克隆 GitHub 仓库

git clone --branch stable --single-branch https://github.com/kabo-sh/kabo-mcp-plugin.git

克隆后，将 agent 配置为从 kabo-mcp-plugin/skills/ 加载完整的 Skill 文件夹，或将这些文件夹复制、导入到它支持的 Skills 位置。保留所有脚本、参考资料和资源文件。仅克隆仓库不会自动向 agent 注册 Skills。

方式二：使用 skills CLI（npx）

skills CLI 只是可选的安装方式。也可以直接克隆 GitHub 仓库或下载 ZIP，按你的环境和偏好选择即可。

npx skills add 'kabo-sh/kabo-mcp-plugin#stable' --skill '*'

在项目目录运行此命令，并在安装器中选择所用客户端。默认只安装到当前项目；添加 -g 可安装到用户目录，供所有项目使用。

CLI 客户端参数示例：--agent codex、--agent claude-code 或 --agent cursor。这些示例不限定哪些 agent 可以使用 Kabo Skills。

运行 npx skills list 查看安装结果；全局安装则用 npx skills list -g。开启新的客户端会话以加载 Skills。

方式三：下载 ZIP

Release ZIP 是完整插件包。手动只安装 Skills 时，请把 skills/ 下的每个完整文件夹复制到客户端支持的 Skills 目录，保留脚本、参考资料和资源文件。仅复制 SKILL.md 不够。手动复制的内容不由 CLI 更新器跟踪。

版本与更新

stable 分支跟随已发布版本。已安装的 Skills 不会在后台自动更新。可在 GitHub Releases 查看新版本和发布说明，再自行决定何时更新。

git -C kabo-mcp-plugin pull --ff-only

对于 stable 分支的克隆，在包含 kabo-mcp-plugin 的目录中运行此命令。如果曾把 Skill 文件夹复制或导入到其他位置，还需替换那些副本。Git 和 ZIP 安装的内容不由 skills CLI 更新器跟踪。

使用 skills CLI 安装的 Skills，请按安装范围选择更新命令：

npx skills update -p

npx skills update -g

这些命令会更新所选范围内所有已跟踪的 Skills，包括其他来源。只想刷新 Kabo 时，请重新运行安装命令，保持相同客户端和项目或全局安装范围。

在 skills CLI 1.7.4 中，skills check 会执行更新逻辑，可能替换已安装的文件。只想了解更新而不改动安装内容时，请查看发布页面。

把 #stable 换成 #v1.0.1 可固定到该版本。更新固定版本的安装不会跳到新 tag；升级时需明确安装新的 tag。

已验证的客户端和工作流要求请见 README。安装成功不代表已完成完整工作流验证。

工具

助手可以调用的工具。

通过客户端的 tools/list 请求查看当前工具及其输入格式。以下是常用的入门工具。

这个服务器还提供 YouTube、Instagram 和 TikTok 的公开数据工具：主页、帖子、评论、文字稿、搜索和热门声音榜。

查看结果，无需重新执行

对于数据任务，将 job_id 传给 get_research_data_job，使用 read_research_data_artifacts 读取产物。对于视频分析，将返回的 id 传给 get_analysis_run。任务仍在处理时查询进度，不要重复启动。

身份验证

使用你的 Kabo 账号登录。

登录方式：带 PKCE 和动态客户端注册的 OAuth，不用复制 API key

OAuth 资源

https://kabo.sh/mcp-pub

支持的权限范围

offline_accessopenidprofileemaildatavideoworkspace:readworkspace:write

服务器元数据：

https://kabo.sh/.well-known/oauth-protected-resource/mcp-pub

OAuth 资源必须与上方服务器端点完全一致。为 /mcp 或其他端点签发的令牌无法在此使用。

不用浏览器登录

如果你的 MCP 客户端运行在打不开浏览器、也接收不了 OAuth 重定向的环境里（比如远程服务器或无界面终端），可以改用 OAuth 设备码流程（RFC 8628）登录。请使用下方的固定客户端 ID；通过动态客户端注册拿到的客户端 ID 不能用于设备码登录。

客户端 ID

kabo-mcp-pub

设备授权端点

https://kabo.sh/api/auth/device/code

确认页面

https://kabo.sh/device

curl -X POST https://kabo.sh/api/auth/device/code \
  -H 'content-type: application/json' \
  -d '{"client_id":"kabo-mcp-pub","scope":"openid offline_access data video"}'

curl -X POST https://kabo.sh/api/auth/oauth2/token \
  -d grant_type=urn:ietf:params:oauth:grant-type:device_code \
  -d device_code=DEVICE_CODE \
  -d client_id=kabo-mcp-pub

响应里有 user_code 和 verification_uri_complete 链接。在任意设备上打开链接，登录 Kabo，核对验证码是否一致。与此同时，按返回的 interval 轮询令牌端点，直到它不再返回 authorization_pending、而是返回访问令牌。scope 必须包含 offline_access，其余可从上方支持的权限中选。令牌只能用于上方的服务器端点，过期后用刷新令牌续期。

设备码 15 分钟后过期（见响应里的 expires_in）。轮询间隔不要短于 interval，也就是 5 秒；服务器返回 slow_down 时再加 5 秒。authorization_pending 表示用同一个设备码继续轮询。expired_token 表示设备码已过期，需要重新申请。access_denied 表示用户拒绝了，请停止，不要自行重试。设备码还有效时不要再申请新的：每次申请都会生成一个新码，只有用户确认的那一个能完成登录。

设备码登录不需要 resource 参数。签发给 kabo-mcp-pub 的令牌总是绑定在上方的服务器端点上。

权限及对应的能力

只申请任务需要的权限。每个工具检查一项权限，缺少时返回 403 insufficient_scope，并写明缺的是哪一项。

offline_access

获取刷新令牌所必需。没有它，2 小时的访问令牌过期后会话就结束。设备码登录必须包含。

openidprofileemail

只用于登录身份，不开放任何工具。profile 让 get_kabo_info 返回你的名字和头像，email 让它返回你的邮箱。

data

公开研究数据：趋势与查询工具、研究数据任务以及 get_research_capabilities。

video

已保存视频的分析与视频复刻。发起新的分析需要 Kabo Pro，并需经你确认。

workspace:read

读取你的 Kabo 工作区：Kabo 账号信息、已连接账号、创作者资料、脚本和视频库。

workspace:write

保存和更新脚本，连接公开的创作者账号。

在多个任务之间保持连接

访问令牌有效 2 小时。刷新令牌有效 30 天，每用一次就换新，所以每个只能用一次。请把它们存在宿主的安全凭据存储里，不要写进对话或普通日志；同一时间只从一个地方刷新：重复使用旧的刷新令牌，会让这个客户端在该账号下的所有会话一起退出登录。任务结束不必结束登录。如果你的环境在任务结束后保留不了凭据，请在登录前告诉用户，下次需要重新登录。

使用额度与访问权限

连接免费。公开数据请求可能消耗账号的每日额度。创建新的视频分析需要 Kabo Pro 和你的授权。检查可用性及读取结果不消耗数据额度。

助手通过 Kabo 能看到什么？

Kabo 为你的请求收集的公开创作者证据，以及你用自己的 Kabo 账号发起的分析和研究任务。Kabo 读不到其他用户的任务，也读不到任何人的私信、草稿或私密数据。

不会。Kabo 只做研究和分析，不会在任何平台上发布、评论、发消息或编辑内容。

常见问题

解决连接问题。

连接 Kabo 的 agent应遵守以下规则。

1. 登录前先检查

   先用已有的连接，只有服务器返回 401 时才重新登录。想不消耗额度地检查连接，可以调用 get_research_capabilities 或 get_kabo_info。

2. 按任务申请权限

   研究数据申请 data，已保存视频的分析申请 video，Kabo 工作区申请 workspace:read 或 workspace:write。不要默认申请全部权限，也不要漏掉任务需要的那一项。

3. 按错误对症处理

   401：登录。403 insufficient_scope：用错误里写明的权限重新授权。invalid_client：检查客户端 ID。额度、订阅、频率或并发错误不是登录问题，不要让用户重新登录。

4. 超时后先检查再重试

   请求可能已经执行了，先查看结果。保存和更新类工具接受幂等键，原样重试是安全的。

5. 只用一个设备码

   设备码还有效时，继续用它轮询，不要申请新的。

6. Skills 不等于已连接

   Kabo Skills 已加载，不代表 Kabo MCP 服务器已连接；插件更新后，当前会话里的工具也不会自动刷新。使用前先确认 Kabo 的工具已经列出。