cdkbot
v0.1.3
Published
CDK Bot — buy game keys, gift cards, and digital products, built for AI agents. Command-line client.
Maintainers
Readme
cdkbot
CDK Bot — buy game keys, gift cards, and digital products, built for AI agents.
Command-line client for CDK Bot: search the catalog, get a price-locked quote, pay on Base, and receive the key — from your terminal. Buy video game keys (Steam / PlayStation / Xbox / Nintendo), gift cards, and digital products with stablecoins and other crypto (USDC, USDT, EURC) via the x402 flow.
npx cdkbot search "Elden Ring" --device PC
npx cdkbot buy <game_id> # shows the price + a clickable checkout linkInstall
npm install -g cdkbot # then: cdkbot ...
# or run without installing:
npx cdkbot <command>Commands
| Command | What it does |
|---------|--------------|
| cdkbot search <query> | Best match (or --all for a list) with price + live market comparison |
| cdkbot info <game_id> | Full product details |
| cdkbot buy <game_id> | Show the price + a clickable checkout link. --open pays in the browser; --key pays autonomously |
| cdkbot status <order_id> --wallet <addr> | Check an order / retrieve the delivered key |
| cdkbot refund <order_id> --wallet <addr> --reason <reason> | Submit a refund claim |
Global: --api <url> (or $CDKBOT_API, default https://api.cdk.bot), --json.
Paying
cdkbot buy <id> never charges on its own — it shows the price and a clickable checkout link, and you choose how to pay:
Browser (default — no private key). Open the /pay link it prints (connect a wallet or scan a QR); your key is delivered right in the page. Add --open to launch it for you:
cdkbot buy <game_id> --openAutonomous (opt-in private key). Give a funded Base wallet and cdkbot sends the stablecoin itself, then delivers the key — one command, no human step. Prefer the env var so the key never lands in your shell history:
export CDKBOT_PRIVATE_KEY=0x... # a funded Base wallet
cdkbot buy <game_id> --yes # --yes skips the spend confirmation⚠️ Autonomous mode spends real funds (the quoted stablecoin — USDC, USDT, or EURC on Base) and is irreversible. The key is read from
--key/$CDKBOT_PRIVATE_KEY, used only to sign the transfer, and is never logged or sent anywhere.
For agents. cdkbot buy <id> --json is non-interactive: it returns { amount, currency, address, quote_id, checkout_url, payment_url, next_steps } — hand checkout_url to a human, or pay with --key. Every command honors --json; errors are { error, message, status, body }.
Sandbox (no real money)
Add --sandbox to buy to run on Base Sepolia testnet and receive a mock SANDBOX-… key:
cdkbot buy <game_id> --sandboxRelated
- API & docs: https://api.cdk.bot — discovery at
/.well-known/agent.json,/llms.txt,/openapi.json - MCP server: https://mcp.cdk.bot/mcp
- Skills & plugin: https://github.com/cdkbotmcp/cdk-skills
- Reference code: https://github.com/cdkbotmcp/cdk-agent-example
License
MIT
