用途：通过已安装的 cg CLI 获取 CoinGecko 加密货币市场数据，包括价格、市值、热门币种、涨幅/跌幅榜、币种搜索以及历史与 OHLC 数据。
主要能力：以 cg commands -o json 输出的机器可读命令目录为准，确定支持的命令、参数、枚举值、输出格式、端点、鉴权要求与 paid_only 状态。可用 cg search <term> -o json 解析币种 ID，避免把符号当作唯一标识。支持批量 ID 请求、JSON 输出与 CSV 导出。
使用方式：先确认 cg 存在并检查非交互式鉴权/套餐状态，例如 command -v cg、cg status -o json、cg commands -o json。不要未经用户批准运行交互式 cg auth 或写入配置。仅在用户明确要求更新时，先运行 cg update --dry-run，再在授权范围内执行 cg update；如自动检测有误，可用 --method 指定 homebrew、npm、go 或 script。对不熟悉或配额敏感的请求先用 --dry-run 预览，可解析查询用 -o json，仅在用户要求 CSV 时用 --export。
适用场景：查询币价、市值、趋势币、涨跌榜、搜索币种、历史与 OHLC 数据等市场数据任务。
限制：cg 不覆盖所有 CoinGecko 端点，合约地址价格、全局统计、NFT 详情、GeckoTerminal、logo 元数据等需查阅 https://docs.coingecko.com/llms.txt，并说明 CLI 路线不可用。遇到 429 应遵守重置/退避时间，不要激进重试。付费端点需先检测套餐，无法服务时报告限制并提供受支持路线。浏览器回退仅用于 cg 不可用、cg history 因缺陷失败或响应明显异常且可视化结果可满足请求时，不用于鉴权、套餐、限流、无效输入或歧义错误，也不满足 JSON/CSV 等机器可读证据需求。切勿泄露 API 密钥或向市场数据端点发送私有钱包/账户数据。