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)

Photo cleanup

Clean up product photos before listing (auto white balance, contrast, brightness, sharpening):

python3 "${CLAUDE_PLUGIN_ROOT}/scripts/photo_cleanup.py" <directory|file> [...]

Saves processed images alongside originals with _clean suffix. Requires Pillow.

Requirements

• Set up at https://developer.ebay.com (free, no API fees)
• Either EBAY_AUTH_TOKEN (Auth'n'Auth) or EBAY_CLIENT_ID + EBAY_CLIENT_SECRET + EBAY_RUNAME (OAuth)
• Set EBAY_SANDBOX=true to use sandbox environment for testing

Error handling

If credentials are missing, tell the user which env vars to set and point them to the setup URL above. Always confirm the listing details with the user before publishing.