adv-cli - SKILL.md Agent Skill

name: adv-cli description: Query Advance Commerce APIs using the adv CLI. Use when working with e-commerce data, product catalogs, inventory, orders, or when the user mentions Advance Commerce, e-commerce, product data, or adv.

Advance Commerce CLI

Query Advance Commerce APIs using the adv command-line tool.

Prerequisites

adv --version
export ADV_API_KEY='your-api-key'
export ADV_API_SECRET='your-api-secret'
adv auth status

Authentication

API key and secret from Advance Commerce
Environment variables: ADV_API_KEY, ADV_API_SECRET
Or: adv auth login for interactive setup

Products

List & Search

adv products list --limit 100
adv products search --query "laptop" --category electronics
adv products get PRODUCT_ID

Catalog Management

adv products create --file product.json
adv products update PRODUCT_ID --price 999.99
adv products delete PRODUCT_ID --confirm
adv products bulk --file products.csv

Inventory

adv inventory list --warehouse WAREHOUSE_ID
adv inventory get PRODUCT_ID --warehouse WAREHOUSE_ID
adv inventory update PRODUCT_ID --quantity 100 --warehouse WAREHOUSE_ID
adv inventory alerts --low-stock --threshold 10

Orders

adv orders list --status pending --limit 50
adv orders get ORDER_ID --details
adv orders create --customer CUSTOMER_ID --items items.json
adv orders update ORDER_ID --status shipped --tracking TRACKING_NUM
adv orders cancel ORDER_ID --reason "Customer request"

Customers

adv customers list --limit 100
adv customers get CUSTOMER_ID
adv customers search --email "customer@example.com"
adv customers orders CUSTOMER_ID --limit 20

Reports & Analytics

adv reports sales --start 2024-06-01 --end 2024-06-30
adv reports inventory --warehouse WAREHOUSE_ID
adv analytics trends --metric revenue --days 30
adv export orders --start 2024-01-01 --format csv

Agent Best Practices

Pagination: Use --cursor for large datasets
Bulk operations: Use CSV/JSON files for batch updates
Date filters: ISO 8601 format (YYYY-MM-DD)
Rate limits: Check response headers for limits