- AI 技能
- AI 插件
- 人工智能
- 工作流自动化
【免费下载链接】awesome-claude-skills
A curated list of awesome Claude Skills, resources, and tools for customizing Claude AI workflows
本指南聚焦 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 揭示了两个关键事实:
- 底层 SDK:该技能通过Coinbase CDP SDK(Coinbase Developer Platform SDK)与 Coinbase 交互,而非直接调用 REST 接口——这意味着可用操作的范围由连接时授予的 API Key 权限决定。
- 连接载体:技能声明依赖名为
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 上的全部钱包列表。技能文档给出的执行要点:
- 以期望的
limit与order调用COINBASE_LIST_WALLETS; - 若响应表明还有更多结果(返回数量达到
limit),记录本页最后一个钱包的 ID; - 将
starting_after设为该 ID 再次调用; - 重复上述步骤,直到响应不再返回新的结果。
对于想先快速看一眼最新数据的场景,可以直接使用order: "desc"——降序排列意味着最新的钱包排在最前,一页即可覆盖最新条目。
核心工作流二:完整遍历钱包集合(Paginate Through All Wallets)
要获得完整、无遗漏的钱包清单(例如用于对账或全量备份),需要把分页循环贯彻到底:
- 使用较大的
limit(如 100)调用COINBASE_LIST_WALLETS,最大化单页吞吐; - 从每页响应中收集钱包 ID、余额与元数据;
- 以上一页最后一个钱包 ID 作为
starting_after持续推进; - 直到某一页返回的结果数不足
limit(或不再返回结果),判定遍历完成。
这里需要注意:limit: 100是参数上限,超出会报错(见「已知陷阱」)。合理的遍历策略是固定limit: 100配合游标循环,用最少的请求次数拉完整个集合。
核心工作流三:钱包组合审计(Audit Wallet Portfolio)
针对投资组合分析、报告生成等场景,技能文档建议:
- 以
limit: 100调用COINBASE_LIST_WALLETS最大化单页结果; - 逐页收集钱包余额与元数据;
- 跨页聚合数据,形成完整的组合视图(Complete Portfolio View)。
这一工作流本质上是「完整遍历」的产物:由于COINBASE_LIST_WALLETS单次只能返回一页,任何需要全量组合数据的分析都必须依赖跨页聚合。聚合时建议将钱包 ID 作为唯一键去重,避免游标循环中因边界重复而把同一钱包计入两次。
核心工作流四:钱包变更监控(Monitor Wallet Changes)
周期性列出钱包,可用于发现新增钱包或检测持仓变化:
- 以
order: "desc"调用COINBASE_LIST_WALLETS,让最新钱包排在最前; - 将返回的钱包 ID 与之前存储的 ID 集合比对,识别新增条目;
- 设置周期性检查(定时任务或 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
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考