mcpField
C
coingecko-cli

coingecko-cli

github.com/paulrberg数据与数据库102114 次安装今天更新
代码仓库

关于 coingecko-cli

coingecko-cli 是使用 `cg` 命令行工具获取 CoinGecko 市场数据的技能。它依据工具目录核实支持的操作、认证和套餐限制，并指导查询执行与结果呈现。

主要功能

  1. 01查看 CLI 状态和命令目录
  2. 02通过搜索解析币种 ID
  3. 03用 dry-run 预览查询
  4. 04返回 JSON 或按需导出 CSV
  5. 05检查套餐与速率限制
  6. 06保护密钥和私人账户数据

适用场景

  1. 01查询指定币种的市场数据
  2. 02核实命令支持情况和套餐要求
  3. 03将所需结果导出为 CSV
  4. 04处理符号歧义或速率限制

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/paulrberg/agent-skills --skill coingecko-cli

安装后在 Claude Code 中输入/coingecko-cli确认已加载。

附带文件agents/openai.yaml

详细介绍

CoinGecko CLI

将已安装 CLI 的机器可读命令目录作为支持的市场数据操作的事实来源。

工作流

  1. 验证 cg 是否存在，并检查非交互式身份验证／套餐状态：

    command -v cg
cg status -o json
cg commands -o json

    未经用户批准，不要运行交互式 cg auth，也不要写入配置。

  2. 从 cg commands -o json 中选择命令、标志、枚举值、输出格式、端点、身份验证要求和 paid_only 状态。仅当目录缺少所需详情时，才使用 cg <command> --help。

  3. 如果用户提供的是名称或有歧义的符号，请使用 cg search <term> -o json 解析 CoinGecko ID。不要默认将符号视为唯一标识。

  4. 对不熟悉或可能消耗配额的请求，使用 --dry-run 预览。使用 -o json 执行可解析的查询；仅当用户要求 CSV 文件时才使用 --export。

  5. 按用户要求的格式呈现结果。对于普通的易读输出，请使用简洁的表格，并保留与资产量级相适应的精度。

边界与默认设置

  • 如果命令支持，请在一次请求中批量提交 ID。遇到 429 时，请遵循报告的重置时间／退避时间，不要频繁重试。
  • 执行前识别仅限付费套餐的命令。如果当前套餐无法处理请求，请说明原因并提供受支持的途径。
  • cg 并不涵盖 CoinGecko 的所有端点。对于不受支持的合约地址价格、全局统计数据、NFT 详情、GeckoTerminal 或徽标元数据，请从 https://docs.coingecko.com/llms.txt 获取相关的最新 API 文档，并说明 CLI 途径不可用。
  • 切勿泄露 API 密钥，也不要将私有钱包／账户数据发送到市场数据端点。

完成请求需要解析出对应的币种／命令，提供成功的 JSON 或所需导出文件作为凭据，并明确处理套餐、歧义或速率限制方面的限制。

面向用户的输出

对于普通用户可读的输出，请以 ### 🪙 <coin> (<id>) 开头，仅在简洁的表格中显示用户要求的指标，并添加一行来源信息；若端点及时间戳、套餐或时间窗口等信息有实际意义，也应注明。对于导出结果，请使用 ### ✅ Exported <row count> rows，链接到文件，并说明查询内容／时间窗口，不要重复输出 CSV 内容。交还控制权时使用 ### ⚠️ Rate limited — retry after <time>；仅在实际等待期间使用 ### ⏳ Rate limited — retrying after <time>；套餐不支持时使用 ### ⚠️ Paid endpoint — current tier: <tier>，并提供一条受支持的途径。按原样返回用户要求的 JSON／CSV、精确 ID、URL、数值、命令和诊断信息，不要添加装饰。

评论

支持 Markdown