---
name: ucmc-basic
description: |
  Guide for installing and using the ucmc CLI tool to query cryptocurrency prices from CoinMarketCap.
  Use this skill when the user wants to check crypto prices, install ucmc, or troubleshoot ucmc CLI issues.
  Trigger: "ucmc", "crypto price", "install ucmc", "check BTC price", "/ucmc-basic"
user-invocable: true
metadata: {"openclaw":{"requires":{"bins":["node"],"env":["UCMC_ACCESS_TOKEN"]},"emoji":"📈"}}
allowed-tools:
  - Bash
---

# ucmc — Crypto Price CLI

Skill version: `0.2.0+`  
CLI version: `0.2.0+` (`ucmc --version`)

ucmc is a lightweight CLI for querying cryptocurrency prices through a protected proxy.

## Installation

```bash
curl -fsSL https://ucmc.uweb.info/install.sh | bash
```

The install script downloads a JavaScript CLI and creates a small `ucmc` launcher. It expects `node` to exist on the machine.

After installation, configure your access token:

```bash
export UCMC_ACCESS_TOKEN=your-token
```

`UCMC_BASE_URL` is optional. Only set it when you want to point the CLI at a different proxy:

```bash
export UCMC_BASE_URL=https://ucmc.uweb.info
```

## Usage

### Get price of a cryptocurrency

```bash
ucmc price BTC
```

Output:

```
BTC (Bitcoin) #1
Price: $67,234.12  24h: +2.34%
Market Cap: $1.32T
```

### Examples

```bash
ucmc price ETH    # Ethereum
ucmc price SOL    # Solana
ucmc price DOGE   # Dogecoin
```

## Environment Variables

| Variable | Required | Description |
|----------|----------|-------------|
| `UCMC_ACCESS_TOKEN` | Yes | Access token for the ucmc API proxy |
| `UCMC_BASE_URL` | No | Override the default proxy URL, mainly for local development |

## Response Language

After running `ucmc price` and obtaining the result, you MUST summarize the output in **natural Chinese (中文)**. Do not simply paste the raw CLI output. Instead, convert it into a friendly, readable Chinese sentence. For example:

- Raw output: `BTC (Bitcoin) #1 Price: $67,234.12 24h: +2.34% Market Cap: $1.32T`
- Response: `比特币（BTC）当前价格为 $67,234.12，24 小时涨幅 2.34%，市值约 1.32 万亿美元。`

## Troubleshooting

| Error | Cause | Fix |
|-------|-------|-----|
| `UCMC_ACCESS_TOKEN is required` | Token not set | `export UCMC_ACCESS_TOKEN=your-token` |
| `Unauthorized` | Token invalid | Check your token value |
| `No active asset found for symbol XYZ` | Unknown symbol | Verify the coin symbol on CoinMarketCap |
| `Unable to reach the UCMC proxy` | Proxy URL is down or wrong | Check `UCMC_BASE_URL` and the deployed site |
| `command not found: ucmc` | Not in PATH | `export PATH="$HOME/.local/bin:$PATH"` |