How do I set up the API key and wallet?

Run the setup: python get_api_key.py --email --address , , , , , to create the Crossmint wallet and API key; credentials.json stores them and should be kept secure.

Which tokens are supported?

Supported tokens include SOL, USDC, USDT, BONK, TRUST, or you can use any mint address directly.

What if I have insufficient balance?

Fund your wallet as shown by balance.py; ensure the address is funded before buying, or retry after adding funds.

How can I check order status or list orders?

Use order_status.py --list to see all orders or order_status.py to check a specific one.

Scout Commerce

Use Caution

@Xasus1

npx machina-cli add skill @Xasus1/scout-commerce --openclaw

Files (1)

SKILL.md

3.2 KB

Scout 🛒

Buy from Amazon & Shopify with USDC. Swap tokens via Jupiter. US shipping only.

Presenting Products (Important!)

Search results: For each recommended product, send the image as actual media (not markdown links) with the product details as the caption. One product per message so images render properly.

Product details: When showing details, send images as media attachments alongside the text. The API returns images in the same response — use them immediately, don't make the user ask.

Why: Markdown image links (![](url)) don't render on Telegram/messaging platforms. Always send images as actual media using the message tool with media parameter, or via inline if supported.

Quick Reference

Setup (once) → python get_api_key.py --email ... --address "..."

Find products → python search.py "gaming mouse under $50"

Get Product details → python product.py amazon:B07GBZ4Q68

Check Wallet balance → python balance.py (shows all tokens)

Buy product → python buy.py amazon:B07GBZ4Q68

Check order → python order_status.py ord_abc123

List orders → python order_status.py --list

Swap tokens → python swap.py SOL USDC 5 (min $5)

Get swap quote → python swap.py --quote SOL USDC 5

List wallet tokens → python swap.py --list

All commands run from scripts/ folder. API key loads automatically from credentials.json.

Setup (one-time)

python get_api_key.py --email <EMAIL> --address "<NAME>,<STREET>,<CITY>,<STATE>,<ZIP>,<COUNTRY>"

Creates a Crossmint wallet + API key and stores them in credentials.json. Fund the wallet with USDC to buy.

Keep API key secure - it authorizes transactions from your wallet.

Commands

Command	Usage
Search	`python search.py "query"`
Details	`python product.py amazon:B07GBZ4Q68`
Balance	`python balance.py` (all tokens) or `balance.py --usdc`
Buy	`python buy.py amazon:B07GBZ4Q68`
Orders	`python order_status.py --list` or `order_status.py <orderId>`
Swap	`python swap.py SOL USDC 5` (min $5 for gasless)
Quote	`python swap.py --quote SOL USDC 5`
Tokens	`python swap.py --list`

Supported tokens: SOL, USDC, USDT, BONK, TRUST — or use any mint address directly.

Workflow

No credentials? → get_api_key.py (creates wallet + API key)
No balance? → Fund wallet address shown by balance.py
Ready to buy → buy.py <locator>

Errors

Error	Fix
`INSUFFICIENT_BALANCE`	Fund wallet (`balance.py` shows address)
`No API key found`	Run `get_api_key.py`
`OUT_OF_STOCK`	Search for alternatives
`OVER_LIMIT`	Max $1,500 per order

Credentials (`credentials.json`)

{
  "api_key": "scout_sk_...",
  "wallet_address": "FtbC9x5...",
  "shipping_profile": { "email": "...", "address": "..." }
}

Never share the API key.

Source

git clone https://clawhub.ai/Xasus1/scout-commerceView on GitHub

Overview

Scout Commerce lets you search for products on Amazon and Shopify and purchase them using USDC on the Solana blockchain. It integrates wallet setup, API key management, and token swaps via Jupiter to streamline buying, with US shipping only. The workflow covers finding products, viewing details, buying, swapping tokens, and tracking orders.

How This Skill Works

It uses a Crossmint wallet and an API key stored in credentials.json to authorize transactions. You search for products, view details, and place a buy order using USDC on Solana; if you need another asset, you can swap tokens via Jupiter using the swap workflow. All commands are organized under the scripts/ folder for one-click execution.

When to Use It

When you want to find products on Amazon or Shopify and buy with USDC on Solana
When you need to acquire another token via Jupiter before checkout
When you want to monitor orders or check status after purchase
When you want to verify wallet balance and available tokens before buying
When you want to view product details and images during search

Quick Start

Step 1: Setup API key and Crossmint wallet (python get_api_key.py --email <EMAIL> --address <NAME>,<STREET>,<CITY>,<STATE>,<ZIP>,<COUNTRY>)
Step 2: Find a product (python search.py "gaming mouse under $50") and view details (python product.py amazon:B07GBZ4Q68)
Step 3: Buy with USDC (python buy.py amazon:B07GBZ4Q68) or swap first (python swap.py SOL USDC 5) if needed

Best Practices

Verify product details and ensure US shipping is available before purchase
Fund the Crossmint wallet with USDC and check your balance beforehand
Use the exact locator (e.g., amazon:B07GBZ4Q68) when buying
Use the swap command only for the amount you need (min $5 for gasless swaps)
Keep credentials.json secure and never share your API key

Example Use Cases

Find a gaming mouse under $50 on Amazon and buy with USDC
Open a Shopify product, confirm price, and complete purchase with USDC
Swap SOL for USDC using Jupiter before a purchase
Check wallet balance and token list before checkout
Track an order with order_status.py after buying

Frequently Asked Questions

Add this skill to your agents