A professional automation tool for creating, managing, and researching eBay listings for trading cards and collectibles.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install ebay-trading-api
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install ebay-trading-api using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is eBay Trading API Skill?
The eBay Trading API Skill is a robust technical solution designed to bridge the gap between inventory management and the eBay marketplace. Part of the Openclaw Skills ecosystem, it provides developers and collectors with the tools to programmatically create listings, verify item specifics, and manage the lifecycle of an auction or fixed-price item. This skill is specifically optimized for the collectibles market, offering deep integration with grading services and sports card metadata to ensure accurate and professional listings.
By utilizing this skill, users can move beyond the limitations of manual listing interfaces. It integrates both the eBay Trading API for listing management and the Finding API for market research, making it an essential component for anyone looking to scale their sales operations using Openclaw Skills. Whether you are building a photo-to-listing pipeline or a bulk inventory synchronization tool, this skill provides the necessary wrappers and logic to handle eBay's complex XML-based API requirements.
eBay Trading API Skill Use Cases
- Creating bulk eBay listings directly from structured data or photo metadata.
- Performing automated 'comps' research to determine the market value of collectibles.
- Managing the lifecycle of listings by programmatically ending or revising items.
- Implementing a secure, automated OAuth token refresh system for long-term server-side operations.
How eBay Trading API Skill Works
- Configuration: The skill initializes by loading API credentials from environment variables and establishing a secure connection to the eBay developer portal.
- Authentication: It manages OAuth 2.0 flows, storing access and refresh tokens in a secure local JSON file with restricted permissions.
- Market Research: The skill uses the Finding API to query recently sold items, providing a data-driven basis for pricing decisions.
- Validation: Before going live, it uses the VerifyAddItem call to validate listing data against eBay's business rules without incurring fees.
- Listing Execution: The skill compiles item specifics, conditions (graded or ungraded), and HTML descriptions into an XML payload for the Trading API.
- Monitoring: Success and error responses are logged to ensure an audit trail for all Openclaw Skills transactions.
eBay Trading API Skill Setup
First, set your eBay developer credentials in your environment file:
export EBAY_DEV_ID=your-dev-id
export EBAY_APP_ID=your-app-id
export EBAY_CERT_ID=your-cert-id
Next, initialize your OAuth session to generate tokens:
cd ~/clawd/ebay && python3 oauth_setup.py
Verify your setup by running a dry-run listing check:
python3 trading_api.py
eBay Trading API Skill Data Schema & Taxonomy
The skill organizes its operations through a specific file hierarchy and data structure to ensure reliability within Openclaw Skills:
| File | Purpose |
|---|---|
.tokens.json |
Stores encrypted OAuth tokens and expiration timestamps. |
pending.json |
A local queue for listings that are prepared but not yet published. |
errors.log |
A detailed log of API rejection reasons and validation failures. |
.env.ebay |
Local configuration for environment-specific API keys. |
description_template.py |
Python-based HTML templates for consistent listing aesthetics. |
eBay Trading API Skill Advanced Features
- Comprehensive support for sports card condition descriptors for both raw and graded cards (PSA, BGS, SGC, etc.).
- Automated token management that handles 2-hour access token expiry and 18-month refresh token cycles.
- CDATA wrapping and HTML escaping for listing descriptions to ensure security and cross-platform compatibility.
- Dual-mode operation supporting both the eBay Sandbox for testing and Production for live sales.
- Rate limit monitoring with fallback logic for high-frequency price research queries.
SKILL.md
Loading
Related Openclaw Skills
Qiuqiu Helper
A multi-purpose utility skill designed to automate workspace status reporting, timestamped note-taking, and log file maintenance.
Capability Evolver
A meta-skill that enables AI agents to autonomously analyze their runtime history and rewrite code for recursive self-improvement.
Entur Travel
A comprehensive tool for planning public transit journeys and checking real-time departures across all transport modes in Norway.
DB Travel
A comprehensive transit planning tool for accessing real-time Deutsche Bahn data across German and European rail networks.
Long-Running Task Orchestration
Orchestrate multi-phase background development by using coding agents as workers and cron jobs as automated managers.
Apple Mail Search
A lightning-fast CLI tool for searching Apple Mail metadata via direct SQLite database queries on macOS.
Featured*
