ebay-listing

eBay Listing

List items for sale on eBay from Claude Code.

First-time setup

Before first use, install the Python dependencies:

pip install -r "${CLAUDE_PLUGIN_ROOT}/requirements.txt"

Credentials must be set as environment variables. The user needs to create a .env file or export them in their shell (see Requirements below).

Authentication

The script supports two auth methods and auto-detects based on which env vars are set:

Auth'n'Auth (recommended)

Simpler for personal use. Get a token from the eBay Developer Portal: User Tokens tab > Auth'n'Auth > Sign in to Production.

• Requires: EBAY_AUTH_TOKEN env var
• Token lasts ~18 months
• Uses the Trading API (XML)

OAuth 2.0 (alternative)

Browser-based consent flow. More complex — requires a localhost callback server which can be finicky.

python3 "${CLAUDE_PLUGIN_ROOT}/scripts/ebay_list.py" auth

• Requires: EBAY_CLIENT_ID, EBAY_CLIENT_SECRET, EBAY_RUNAME env vars
• RuName redirect URL must be http://localhost:8888/callback
• Uses the Inventory API (REST)

Creating a listing

python3 "${CLAUDE_PLUGIN_ROOT}/scripts/ebay_list.py" list \
  --title "GoPro Hero 12 Black" \
  --description "Brand new, sealed in box. Includes all accessories." \
  --price 299.99 \
  --condition NEW \
  --image "https://example.com/photo1.jpg" \
  --image "https://example.com/photo2.jpg" \
  --category 31388 \
  --marketplace US \
  --currency USD

Options

• --title (required): Item title, max 80 chars
• --description (required): Item description, max 4000 chars
• --price (required): Listing price
• --condition (required): One of: NEW, LIKE_NEW, NEW_OTHER, NEW_WITH_DEFECTS, CERTIFIED_REFURBISHED, SELLER_REFURBISHED, USED_EXCELLENT, USED_VERY_GOOD, USED_GOOD, USED_ACCEPTABLE, FOR_PARTS_OR_NOT_WORKING
• --image (required, repeatable): HTTPS image URLs, at least one
• --category: eBay category ID (look up at https://pages.ebay.com/sellerinformation/news/categorychanges.html)
• --marketplace: US (default), UK, AU, CA, DE, FR, IT, ES
• --currency: USD (default), GBP, AUD, CAD, EUR
• --quantity: Number available (default: 1)
• --sku: Custom SKU (auto-generated if omitted)
• --brand: Brand name
• --format: FIXED_PRICE (default) or AUCTION
• --draft: Create the offer without publishing (for review first)