Tradera Api

Tradera API

Skills for interacting with the Tradera public REST API (v4). Look up items, publish listings, and manage active listings — all from Claude Code.

Quick Start

# 1. Add the marketplace (one-time)
claude plugin marketplace add tradera/ai-marketplace

# 2. Install the plugin
claude plugin install tradera-api@tradera-ai-marketplace

# 3. Set up your developer account
/tradera-setup

Skills

Skill	Description	Auth needed
/tradera-setup	Register as a developer and create an API application	None
/tradera-user-token	Obtain a user token via browser login	App credentials
/tradera-get-item <itemId>	Look up a listing by ID	App credentials
/tradera-publish	Create and publish a new listing	App + User credentials
/tradera-end-listing <itemId>	End an active listing	App + User credentials

Authentication

Each Tradera API application has three credentials:

• App ID (integer) — identifies your application
• App Key (GUID, secret) — authenticates API calls
• Public Key (GUID) — used in browser login URLs (less sensitive)

Write operations (publish, end listing) additionally require:

• User ID (integer) — your Tradera user ID
• User Token (GUID) — obtained via /tradera-user-token

Environment Variables (recommended)

Set these in your shell environment so all skills pick them up automatically — no need to pass credentials as arguments.

Important: Claude Code runs non-interactive shells, so use files that are sourced in that context:

• zsh: ~/.zshenv (not ~/.zshrc)
• bash: ~/.profile or set BASH_ENV=~/.bashrc in your login profile (not ~/.bashrc directly — it's only sourced by interactive bash)

export TRADERA_APP_ID=your_app_id
export TRADERA_APP_KEY=your_app_key
export TRADERA_PUBLIC_KEY=your_public_key
export TRADERA_USER_ID=your_user_id
export TRADERA_USER_TOKEN=your_user_token

All skills check these env vars first, then fall back to command arguments.

API Reference

• Base URL: https://api.tradera.com/v4/
• Documentation: https://api.tradera.com
• Rate limit: 100 calls/24 hours (contact apiadmin@tradera.com for increases)

Platform Support

These skills work on macOS, Linux, and WSL. Browser-based flows (setup, user-token) automatically detect the right command to open URLs (open, xdg-open, or wslview).