Connect

eBay Inventory & Listing Manager

isaacrowntreebyisaacrowntree
•
2
•
E-commerce Solutions

Automates the creation and management of eBay listings including product photo optimization and multi-marketplace support.

This skill empowers Claude to handle the end-to-end eBay selling workflow directly from the command line. It enables users to create detailed listings with titles, descriptions, and pricing while providing built-in tools for image enhancement like auto-white balance and sharpening. Supporting both simple Auth'n'Auth and complex OAuth 2.0 authentication, the skill allows for seamless inventory management across global marketplaces (US, UK, AU, and more) and includes a draft mode to review listings before they go live.

Key Features

01Multiple authentication flows including Auth'n'Auth and OAuth 2.0
02Global marketplace support for US, UK, AU, CA, and European regions
03Integrated photo cleanup tool for professional-grade product images
04Flexible listing formats supporting both Fixed Price and Auctions
052 GitHub stars
06Automated eBay listing creation with customizable titles and descriptions

Use Cases

01Batch optimizing product photos for better conversion and visibility
02Quickly listing individual items for sale without manual form filling
03Managing international eBay inventory across multiple currencies and regions
name ebay-listing
description List items for sale on eBay. Use when the user wants to create eBay listings, sell items, or manage eBay inventory.

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.