Skip to content

README.md

Latest commit

 

History

History
62 lines (50 loc) · 2.91 KB

README.md

File metadata and controls

62 lines (50 loc) · 2.91 KB
Raw

eBay Listing Migration Tool

Background

I had to create a new eBay account for a new organization, and I had a LOT of listings in the old account that I wanted to transfer to the new account. No way was I going to do that manually, and the handful of 3rd party tools I found were either expensive or janky... so with the help of Google's new Antigravity AI coding app, I built this migration tool. I got it working over the course of a couple days, and used it to successfuly migrate almost 200 listings. I want to share the code since there really wasn't anything else like it that I could find. I hope someone else finds it useful! Feel free to reach out to me if you have any questions or need help.

Functionality Summary

A Python-based tool for migrating eBay listings from a source account to a target account, featuring:

  • Inventory API Integration: Uses the modern Inventory API for listings.
  • Smart Policy Mapping: Syncs and maps Business Policies (Payment, Shipping, Return).
  • Image Migration: Downloads images locally and re-uploads them to eBay Picture Services (EPS).
  • Batch Processing: Supports batched publishing with stop-on-error logic.
  • Verification: Comprehensive post-migration verification against the local database.

Prerequisites

  • Python 3.9+
  • Two eBay Accounts (Source and Target)
  • eBay Developer Account (App ID, Cert ID, RU Name)

Setup

  1. Clone the repository
  2. Create a Virtual Environment: 
    python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txt
  3. Configure Environment Variables: Create a .env file in the root directory (do NOT commit this file): 
    EBAY_APP_ID=your_app_id
EBAY_CERT_ID=your_cert_id
EBAY_RU_NAME=your_ru_name

Usage

Run the main dashboard:

./venv/bin/python ebay_migration/main.py

Workflow Steps

  1. Extract from SOURCE: Pulls active listings and policies into the local database.
  2. Download Images: Saves listing images to data/images.
  3. Sync Policies: Checks for matching policies on the Target account or creates placeholders.
  4. Upload Images to TARGET: Uploads local images to the Target account's EPS hosting.
  5. Publish Listings: Creates Inventory Items and Offers on the Target account.
  6. Verify Listings: Compares the live listing data against the local database to ensure fidelity.

Project Structure

  • ebay_migration/: Core application code.
  • scripts/: Utility scripts for maintenance (resetting data, setting up locations).
  • dev_tools/: detailed inspection and debugging scripts.

Important Notes on API Limits

  • Aspects: The tool handles multi-value aspects (e.g., "Topic", "Language") by joining them with commas if the Inventory API rejects array values for specific categories.
  • Rate Limits: The tool processes items sequentially to be respectful of API limits.

License

GNU GPLv3 License