awesome-codex-skills 之 Coinbase Automation：用 Rube MCP 驱动 COINBASE_LIST_WALLETS 实现加密钱包的分页管理与组合审计
【免费下载链接】awesome-codex-skillsA curated list of practical Codex skills for automating workflows across the Codex CLI and API.项目地址: https://gitcode.com/GitHub_Trending/aw/awesome-codex-skills
本文围绕 Coinbase Automation 技能定义文件 展开，讲解该技能如何借助 Rube MCP 服务器调用COINBASE_LIST_WALLETS工具完成 Coinbase 钱包列表查询、游标分页、组合数据审计与变更监控。读完本文，你将掌握该技能 frontmatter 的依赖声明方式、连接建立流程、全部工具参数的取值范围，以及四条核心工作流的完整执行步骤，可将其作为在 Codex 中接入加密资产数据的可复用方案。
1. 技能定位与文件结构
该技能位于仓库的 composio-skills/coinbase-automation/ 目录，其 SKILL.md 遵循 Codex 技能的"单文件指令包"约定：一个 YAML frontmatter 加 Markdown 正文，Codex 先读 frontmatter 决定何时触发，触发后才加载正文执行。
frontmatter 完整声明如下（引自原文档）：
--- name: Coinbase Automation description: "Coinbase Automation: list and manage cryptocurrency wallets, accounts, and portfolio data via Coinbase CDP SDK" requires: mcp: [rube] ---其中三个字段各有用途：
name为技能展示名；description是主要触发依据，说明技能"通过 Coinbase CDP SDK 列出并管理加密钱包、账户与组合数据"，Codex 依据它与用户请求的匹配度决定是否加载该技能；requires.mcp: [rube]声明了硬性依赖——必须接入名为rube的 MCP 服务器才能执行。这一声明方式与本仓库中数百个 composio-skills 技能（如 composio-automation、zoho-automation）保持同一模式，即所有 Composio 系自动化技能统一通过 Rube MCP 接入。
从源码结构看，该技能没有附带scripts/、references/等捆绑资源，全部逻辑以"参数说明 + 步骤指引"的形式写在 SKILL.md 正文中，属于典型的"低自由度"技能：步骤明确、可直接照做。
2. 前置条件：连接 Rube MCP 与 coinbase 工具包
原文档 Setup 部分的要求只有一句话：
本技能要求Rube MCP 服务器连接在
https://rube.app/mcp。执行任何工具之前，先确认coinbase工具包存在活跃连接；若没有活跃连接，通过RUBE_MANAGE_CONNECTIONS发起一个。
将其落到可操作的序列，并结合本仓库其他 Composio 技能（如 composio-search-automation/SKILL.md 与 composio-automation/SKILL.md）中同族的标准四步流程，完整的准备过程为：
- 在客户端 MCP 配置中添加
https://rube.app/mcp作为 MCP 服务器端点（同族技能文档说明该端点无需本地 API key）； - 调用
RUBE_MANAGE_CONNECTIONS，指定工具包coinbase；若连接状态不是 ACTIVE，按返回的授权链接完成认证； - 确认连接状态显示 ACTIVE 后，才执行后续任何钱包工具；
- 执行工具时走
RUBE_MULTI_EXECUTE_TOOL，并复用同一session_id（同一工作流内复用会话，新工作流再生成新会话）。
需要强调的一个跨技能通用约束：同族文档在 Known Pitfalls 中均指出"工具 schema 会变化，切勿在未检索的情况下硬编码工具 slug 与参数"。虽然 coinbase 技能正文直接给出了COINBASE_LIST_WALLETS这一确定 slug，但在实际执行前仍建议先检索工具 schema 确认字段名与类型，这是整个 Rube MCP 体系的既定工作方式。
3. 核心工具：COINBASE_LIST_WALLETS 参数详解
四条工作流全部建立在同一个工具COINBASE_LIST_WALLETS上（原文档 Quick Reference 也仅此一项）。它用于从 Coinbase 分页拉取加密钱包列表。关键参数如下，完整继承原文档并补充了适用说明：
| 参数 | 说明 | 取值 / 默认值 |
|---|---|---|
limit | 每页返回的钱包数量 | 1–100，默认 25；超出范围会报错 |
order | 排序方向 | "asc"升序 /"desc"降序（默认） |
starting_after | 正向分页游标 | 上一页最后一个钱包的 ID |
ending_before | 反向分页游标 | 上一页第一个钱包的 ID |
原文档给出了两段标准调用示例，均可直接在会话中复现。
第一页请求：
Tool: COINBASE_LIST_WALLETS Arguments: limit: 50 order: "desc"请求下一页（用上一页返回的最后一个钱包 ID 作为游标）：
Tool: COINBASE_LIST_WALLETS Arguments: limit: 50 order: "desc" starting_after: "wallet_abc123_last_id_from_prev_page"注意游标不是页码而是钱包 ID 本身：分页协议要求从每次响应中提取首尾钱包 ID 才能继续导航，这一点在原文档的 Known Pitfalls 中被单独列为一条陷阱。
4. 四条核心工作流
4.1 列出全部钱包（List All Wallets）
目标：从 Coinbase 拉取全部钱包，支持分页。做法即第 3 节的两次调用模式：先以期望的limit和order请求第一页，再用starting_after携带上一页末尾 ID 翻页。
4.2 分页遍历完整钱包清单（Paginate Through All Wallets）
要拿到完整钱包清单，需要迭代全部页面。原文档给出的四步循环：
- 以期望的
limit和order调用COINBASE_LIST_WALLETS； - 若响应中还有更多结果，记下本次返回的最后一个钱包 ID；
- 再次调用
COINBASE_LIST_WALLETS，把starting_after设为该 ID； - 重复直到没有更多结果返回。
这是一个"空页即停"的终止条件设计：不依赖总页数，只要某一页返回空列表或结果数少于limit，即可认为遍历完成。
4.3 审计钱包组合（Audit Wallet Portfolio）
面向组合分析与报表场景。步骤：
- 以
limit: 100调用COINBASE_LIST_WALLETS，将单页数据量提到参数上限，减少往返次数； - 从每一页收集钱包余额与元数据；
- 跨页聚合，得到完整组合视图。
该工作流本质是 4.2 的遍历过程加上"以最大页宽拉取"这一优化，适合需要一次性产出资产总览的任务。
4.4 监控钱包变更（Monitor Wallet Changes）
通过定期列表比对来发现新增或变化。步骤：
- 以
order: "desc"调用COINBASE_LIST_WALLETS，让最新创建的钱包排在最前； - 与本地保存的历史钱包 ID 集合比对，识别新条目；
- 设置周期性检查以持续监控。
由于order: "desc"时最新钱包在页首，监控场景只需拉取少量头部数据即可完成比对，不必遍历全量。
5. 已知陷阱（Known Pitfalls）
原文档以表格形式列出四条陷阱，逐条继承并补充执行要点：
| 陷阱 | 详情 |
|---|---|
| 必须分页 | 钱包列表是分页的。始终用游标分页（starting_after/ending_before）检查是否存在更多页。 |
| limit 边界 | limit只接受 1–100，越界值会直接报错；默认 25。 |
| 游标式分页 | 以钱包 ID 作游标而非页码。必须从每次响应中提取首/尾钱包 ID 来导航页面。 |
| CDP SDK 作用域 | 该工具走 Coinbase CDP SDK。可用操作取决于连接建立时 API key 被授予的权限。 |
最后一条对排查问题很关键：如果工具返回权限类错误或可用操作少于预期，应优先检查连接建立阶段 key 的授权范围，而不是怀疑分页逻辑。
6. 安装与触发方式
该技能与本仓库其他技能一样，通过安装到$CODEX_HOME/skills/（默认~/.codex/skills）生效。根据 README.md 的 Quickstart 与 skill-installer 技能，有两种方式：
推荐方式（仓库自带安装脚本）：
git clone https://github.com/ComposioHQ/awesome-codex-skills.git cd awesome-codex-skills # 安装指定技能到 $CODEX_HOME/skills（默认 ~/.codex/skills） python skill-installer/scripts/install-skill-from-github.py \ --repo ComposioHQ/awesome-codex-skills \ --path composio-skills/coinbase-automation手动方式：将composio-skills/coinbase-automation目录整体复制到$CODEX_HOME/skills/下。
两种方式装完后都需要重启 Codex 才会重新加载技能元数据；安装可用ls ~/.codex/skills列出已装技能、head ~/.codex/skills/<skill>/SKILL.md查看 frontmatter 验证。会话中自然描述"帮我列出 Coinbase 的钱包"之类请求，或点名 Coinbase Automation，即可命中该技能的description触发。
需要说明的运行前提：技能声明了requires: mcp: [rube]，若客户端未配置 Rube MCP 服务器（https://rube.app/mcp）且未建立coinbase工具包的 ACTIVE 连接，正文中的工具调用均无法执行。
7. 小结与延伸阅读
- 技能本体与全部工作流：composio-skills/coinbase-automation/SKILL.md
- 同族 Rube MCP 标准流程（工具发现、连接管理、批量执行、会话与 memory 参数约定）：composio-skills/composio-search-automation/SKILL.md
- 技能安装脚本与行为说明：skill-installer/SKILL.md
- 仓库整体 Quickstart 与技能目录：README.md
Coinbase Automation 技能的价值在于把一个"分页 API 调用"这一容易踩坑的领域知识（游标语义、limit 边界、CDP SDK 权限作用域）沉淀为可被 Codex 直接触发执行的程序性知识，配合 Rube MCP 的会话与连接管理机制，即可在 Codex 会话中完成钱包清单拉取、组合审计与变更监控三类任务。
【免费下载链接】awesome-codex-skillsA curated list of practical Codex skills for automating workflows across the Codex CLI and API.项目地址: https://gitcode.com/GitHub_Trending/aw/awesome-codex-skills
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
