skillboss-agent-wallet

The wallet for AI agents. One-line SDK for the SkillBoss shopping rail — 354+ tools (web scraping, search, image/video/audio generation, email, 100+ LLMs) through one wallet with audit trail.

Implements Agent Shopping Protocol v0.1.

Install

npm install skillboss-agent-wallet
# or
pnpm add skillboss-agent-wallet
# or
bun add skillboss-agent-wallet

Get an API key

https://www.skillboss.co/console — first top-up of $25 grants a $5 bonus ($30 usable).

Set it in your env:

export SKILLBOSS_API_KEY=sk_skillboss_...

One-line usage

import { wallet } from 'skillboss-agent-wallet'

// Scrape a web page
const { result } = await wallet.run('web_scrape', {
  url: 'https://news.ycombinator.com',
})

// Or use the convenience methods
const scrape = await wallet.webScrape('https://example.com')
const search = await wallet.webSearch('claude code vs cursor')
const chat = await wallet.chat('Summarize HN in 3 bullets.')
const image = await wallet.generateImage('A watercolor seascape at dawn')
const email = await wallet.sendEmail({
  to: '[email protected]',
  subject: 'Agent report',
  body: '<h1>Done.</h1>',
})

// Check balance
const balance = await wallet.balance()

// Discover a skill by natural language
const matches = await wallet.search('scrape a JavaScript-rendered site', {
  category: 'information',
  paymentProtocol: 'x402',
  preferredOnly: true,
  limit: 3,
})

Advanced: custom client

import { createWalletClient } from 'skillboss-agent-wallet'

const client = createWalletClient({
  apiKey: process.env.MY_KEY,            // overrides SKILLBOSS_API_KEY env
  agentName: 'my-research-agent',        // tagged on every call (audit)
  maxCostPerCallUsd: 0.50,               // server rejects anything above
  defaultPaymentProtocol: 'skillboss_wallet', // or 'x402' / 'mpp'
})

const result = await client.run('web_scrape', { url: '...' }, {
  taskId: 'task-abc-123',
  maxCostUsd: 0.10,
  signal: abortController.signal,
})

Audit metadata

Every .run() response includes cost and remaining balance:

const { ok, result, cost_usd, wallet_balance_after_usd, receipt } =
  await wallet.run('web_scrape', { url: '...' })

console.log(`Spent $${cost_usd}, balance: $${wallet_balance_after_usd}`)

receipt is a signed JWT that proves the call happened — useful for CFO- grade audit logs.

Payment protocols

SkillBoss supports three payment paths:

| Path | When to use | | --- | --- | | skillboss_wallet (default) | Pre-funded wallet, fastest path | | x402 | Deterministic per-request pricing, quote-pay-retry loop | | mpp | Usage-based / long-running flows |

Pick per call:

await wallet.run('web_scrape', { url }, { paymentProtocol: 'x402' })

Error handling

run() never throws network errors — it returns { ok: false, error }.

const result = await wallet.run('web_scrape', { url })
if (!result.ok) {
  console.error(result.error)
  return
}
// safe to use result.result

Catalog discovery

// Fetch all 354 products (cached 5 min in-process)
const products = await wallet.catalog()

// Force refresh
const fresh = await wallet.catalog({ refresh: true })

Related

• skillboss-mcp-server — MCP server for Claude Code, Cursor, Windsurf, OpenClaw
• skillboss-openclaw-plugin — OpenClaw native plugin
• Agent Shopping Protocol v0.1 — the open protocol this SDK implements
• SkillBoss catalog — full JSON of all 354 products

License

MIT