☰
用 Coinbase Automation Skill 自动化加密货币钱包管理:CDP SDK 接入、分页遍历与组合审计实战
2026/10/1 7:42:10 网站建设 项目流程
  • AI 技能
  • AI 插件
  • 人工智能
  • 工作流自动化

【免费下载链接】awesome-claude-skills

A curated list of awesome Claude Skills, resources, and tools for customizing Claude AI workflows

项目地址:https://gitcode.com/GitHub_Trending/aw/awesome-claude-skills
点击查看免费下载

本指南聚焦 awesome-claude-skills 仓库中的 Coinbase Automation 技能:它通过 Rube MCP(Composio)将 Coinbase CDP SDK 的能力接入 Claude,让 Agent 可以自动列出加密货币钱包、按游标分页遍历完整钱包集合,并基于多页数据完成组合(Portfolio)审计与变更监控。读完本文,你将掌握该技能的连接配置、COINBASE_LIST_WALLETS工具的参数语义、四种核心工作流的可执行步骤,以及从仓库源码结构可推断出的底层运行机制与已知陷阱。

技能背景:Composio Skills 生态与 Rube MCP 接入方式

awesome-claude-skills 仓库维护了一组面向 78 个 SaaS 应用的开箱即用工作流技能(见 README.md 的 "App Automation via Composio" 章节),每个技能都包含真实的工具序列、参数指导、已知陷阱和快速参考表,工具 slug 均来自 Composio API 的真实发现结果。Coinbase Automation 正是其中针对加密货币交易所的预构建技能,其定位可从技能元数据中直接读出:

--- name: Coinbase Automation description: "Coinbase Automation: list and manage cryptocurrency wallets, accounts, and portfolio data via Coinbase CDP SDK" requires: mcp: [rube] ---

这段 YAML frontmatter 揭示了两个关键事实:

  1. 底层 SDK:该技能通过Coinbase CDP SDK(Coinbase Developer Platform SDK)与 Coinbase 交互,而非直接调用 REST 接口——这意味着可用操作的范围由连接时授予的 API Key 权限决定。
  2. 连接载体:技能声明依赖名为rube的 MCP 服务器。Rube 是 Composio 提供的托管 MCP 接入层,统一负责工具发现、连接管理与工具执行。

从仓库中与 Rube MCP 交互的通用技能 composio-automation/SKILL.md 可以看到,围绕 Rube 存在一套标准的工具调用链:RUBE_SEARCH_TOOLS(发现工具与最新 schema)、RUBE_MANAGE_CONNECTIONS(建立并检查第三方应用连接)、RUBE_MULTI_EXECUTE_TOOL(批量执行已发现工具)、RUBE_REMOTE_WORKBENCH(远程沙箱批量操作)、RUBE_GET_TOOL_SCHEMAS(获取含schemaRef工具的完整 schema)。Coinbase Automation 技能本身就是在这套基础设施之上,为「钱包列表」这一具体场景预排好的工作流。

前置准备:连接 Rube MCP 并激活 Coinbase 连接

在调用任何 Coinbase 工具之前,需要完成两层准备:

第一层:MCP 服务器连接。在 Claude 客户端(Claude Code、Claude.ai 或 API 驱动的 Agent)的 MCP 配置中,将https://rube.app/mcp添加为 MCP 服务器端点。按 composio-automation/SKILL.md 的说明,这一步无需任何 API Key——只需添加端点即可工作。

第二层:Coinbase 连接激活。技能文档明确要求:在执行任何工具之前,确保存在coinbasetoolkit 的活跃连接(Active connection)。若没有活跃连接,则通过RUBE_MANAGE_CONNECTIONS发起连接。通用流程如下(以 composio-automation 技能中的模式为参照):

RUBE_MANAGE_CONNECTIONS toolkits: ["coinbase"] session_id: "your_session_id"
  • 若返回状态不是ACTIVE,跟随返回的认证链接完成 Coinbase 授权;
  • 授权期间授予的API Key 权限范围将直接决定后续可用操作,这也是「CDP SDK scope」陷阱的根源(详见下文);
  • 确认状态为ACTIVE后再开始执行工作流。

对于希望保持流程规范性的场景,还可以先通过RUBE_SEARCH_TOOLS查询 Coinbase 相关的当前工具 schema,确保使用的工具 slug 与参数结构与线上版本一致——因为工具 schema 会随 SDK 迭代变化,技能文档也强调了「先搜索再执行」的原则。

核心工具:COINBASE_LIST_WALLETS参数全解

本技能的核心工具只有一个 slug——COINBASE_LIST_WALLETS,其职责是分页列出加密货币钱包。技能文档给出了完整的参数语义:

参数含义取值范围 / 默认值
limit每页返回的结果数1–100,默认 25
order排序方向"asc"(升序)或"desc"(降序,默认)
starting_after正向分页游标:上一页最后一个钱包的 ID钱包 ID 字符串
ending_before反向分页游标:上一页第一个钱包的 ID钱包 ID 字符串

关键认知:分页是基于游标(Cursor)而非页码。游标就是钱包 ID 本身——要翻到下一页,必须从当前响应的结果中提取最后一个钱包的 ID,作为下一次调用的starting_after。这与基于page=2、page=3的偏移分页有本质区别,也是最容易踩坑的地方。

第一页调用示例

Tool: COINBASE_LIST_WALLETS Arguments: limit: 50 order: "desc"

下一页调用示例(正向翻页)

Tool: COINBASE_LIST_WALLETS Arguments: limit: 50 order: "desc" starting_after: "wallet_abc123_last_id_from_prev_page"

技能文档中还给出了反向翻页的对应语义:ending_before接受上一页第一个钱包的 ID,用于从后往前回溯。

核心工作流一:列出所有钱包(含分页)

最基础的场景是获取 Coinbase 上的全部钱包列表。技能文档给出的执行要点:

  1. 以期望的limit与order调用COINBASE_LIST_WALLETS;
  2. 若响应表明还有更多结果(返回数量达到limit),记录本页最后一个钱包的 ID;
  3. 将starting_after设为该 ID 再次调用;
  4. 重复上述步骤,直到响应不再返回新的结果。

对于想先快速看一眼最新数据的场景,可以直接使用order: "desc"——降序排列意味着最新的钱包排在最前,一页即可覆盖最新条目。

核心工作流二:完整遍历钱包集合(Paginate Through All Wallets)

要获得完整、无遗漏的钱包清单(例如用于对账或全量备份),需要把分页循环贯彻到底:

  1. 使用较大的limit(如 100)调用COINBASE_LIST_WALLETS,最大化单页吞吐;
  2. 从每页响应中收集钱包 ID、余额与元数据;
  3. 以上一页最后一个钱包 ID 作为starting_after持续推进;
  4. 直到某一页返回的结果数不足limit(或不再返回结果),判定遍历完成。

这里需要注意:limit: 100是参数上限,超出会报错(见「已知陷阱」)。合理的遍历策略是固定limit: 100配合游标循环,用最少的请求次数拉完整个集合。

核心工作流三:钱包组合审计(Audit Wallet Portfolio)

针对投资组合分析、报告生成等场景,技能文档建议:

  1. 以limit: 100调用COINBASE_LIST_WALLETS最大化单页结果;
  2. 逐页收集钱包余额与元数据;
  3. 跨页聚合数据,形成完整的组合视图(Complete Portfolio View)。

这一工作流本质上是「完整遍历」的产物:由于COINBASE_LIST_WALLETS单次只能返回一页,任何需要全量组合数据的分析都必须依赖跨页聚合。聚合时建议将钱包 ID 作为唯一键去重,避免游标循环中因边界重复而把同一钱包计入两次。

核心工作流四:钱包变更监控(Monitor Wallet Changes)

周期性列出钱包,可用于发现新增钱包或检测持仓变化:

  1. 以order: "desc"调用COINBASE_LIST_WALLETS,让最新钱包排在最前;
  2. 将返回的钱包 ID 与之前存储的 ID 集合比对,识别新增条目;
  3. 设置周期性检查(定时任务或 Agent 调度),实现持续监控。

该工作流利用了降序排序的特性——新的钱包天然出现在列表头部,只需对比首屏 ID 即可低成本完成增量检测,无需每次全量遍历。

已知陷阱与规避策略

技能文档用一张表格集中列出了四类高频坑,建议在 Agent 编排时将其作为硬性检查项:

陷阱详情规避策略
分页必须处理钱包列表是分页返回的,必须使用游标分页(starting_after/ending_before)检查是否存在后续页循环调用直到结果不足limit;不要假设单次调用返回全量
limit 边界limit只接受 1–100,超出范围会报错;默认值为 25显式传参并约束在 [1, 100];追求吞吐用 100
游标式分页游标是钱包 ID 而非页码,必须从每次响应中提取首/尾钱包 ID 才能翻页解析响应中的钱包 ID 字段并回填到下一轮starting_after/ending_before
CDP SDK 范围工具基于 Coinbase CDP SDK,可用操作取决于连接时授予的 API Key 权限连接前明确所需权限范围;遇到权限类错误时回查连接配置

其中「游标式分页」是多数集成失败的根源——若把分页逻辑写成页码递增,将永远停留在第一页或返回重复数据。

快速参考

技能文档最后给出了本技能的工具速查表:

工具 slug说明
COINBASE_LIST_WALLETS分页列出加密货币钱包

该技能目前围绕单一工具构建,全部四种工作流都是COINBASE_LIST_WALLETS在不同参数组合与循环策略下的复用。这也符合仓库中 Composio Skills 的一贯风格——先用最少工具打通核心闭环,再通过工作流组合覆盖多场景。

延伸:如何从仓库继续深入

  • 技能全文:coinbase-automation/SKILL.md
  • Rube MCP 通用接入模式(连接、发现、执行、批量操作):composio-automation/SKILL.md
  • 仓库总览与技能分类索引:README.md("App Automation via Composio" 章节列出了全部 78 个预构建技能)

说明:本仓库以文档型技能(SKILL.md)为主,Coinbase Automation 目录下仅包含该技能文件;上文关于 Rube 工具链(RUBE_SEARCH_TOOLS、RUBE_MANAGE_CONNECTIONS、RUBE_MULTI_EXECUTE_TOOL等)与连接激活流程的描述,依据的是仓库中 composio-automation 技能文档的实际内容,可作为运行本技能时的通用操作参考。

  • AI 技能
  • AI 插件
  • 人工智能
  • 工作流自动化

【免费下载链接】awesome-claude-skills

A curated list of awesome Claude Skills, resources, and tools for customizing Claude AI workflows

项目地址:https://gitcode.com/GitHub_Trending/aw/awesome-claude-skills
点击查看免费下载
上一篇:Cemu Wii U 模拟器配置与调优指南
下一篇:突破欧氏空间限制:Geomstats流形机器学习完全指南

创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询