gxbvc/ebay-cli

How gxbvc/ebay-cli works

ebay-cli is a command-line market-research tool: users search active listings, retrieve item details, or inspect sold prices, with JSON results written to stdout. The CLI dispatches each command; search and item use Browse API OAuth, while sold uses Finding API app-ID authentication. Shared configuration supplies credentials and API environment, and OAuth tokens are cached locally. The README documents these capabilities; edges reflect the sampled command, auth, and configuration code.

Main entry points: auth.ts OAuth token manager · search.ts Active search · item.ts Item details · cli.ts Command dispatcher

Components 13

CLI interface

CLI launcher bin/ebay-cli.js
Command dispatcher src/cli.ts
Credential config src/config.ts
JSON stdout

Browse workflow

Active search src/commands/search.ts
Item details src/commands/item.ts
OAuth token manager src/auth.ts
Token cache src/auth.ts
eBay OAuth service
eBay Browse API

Sold research

Sold listings src/commands/sold.ts
eBay Finding API

Other components

CLI user

Connections 20

CLI user → CLI launcher: runs commands README.md
CLI launcher → Command dispatcher: loads bin/ebay-cli.js
Command dispatcher → Active search: dispatches search src/cli.ts
Command dispatcher → Item details: dispatches item src/cli.ts
Command dispatcher → Sold listings: dispatches sold src/cli.ts
Active search → OAuth token manager: gets token src/commands/search.ts
Item details → OAuth token manager: gets token src/commands/item.ts
OAuth token manager → Credential config: reads credentials src/auth.ts
Active search → Credential config: reads API URL src/commands/search.ts
Item details → Credential config: reads API URL src/commands/item.ts
Sold listings → Credential config: reads app ID src/commands/sold.ts
OAuth token manager → Token cache: reads and writes src/auth.ts
OAuth token manager → eBay OAuth service: requests token src/auth.ts
eBay OAuth service → OAuth token manager: returns token src/auth.ts
Active search → eBay Browse API: searches listings src/commands/search.ts
Item details → eBay Browse API: fetches item src/commands/item.ts
Sold listings → eBay Finding API: searches completed src/commands/sold.ts
Active search → JSON stdout: prints results src/commands/search.ts
Item details → JSON stdout: prints details src/commands/item.ts
Sold listings → JSON stdout: prints results src/commands/sold.ts

More TypeScript diagrams: opencrvs/opencrvs-core · sophiabrandt/nextjs-ecommerce · tafadzwad/artistaa-whatsapp-chatbot · tinloof/sanity-kit · 0xbow-io/privacy-pools-core

Drawn by GitDiagram on September 29, 2026 from the repository's file tree, README and source files. Read as Markdown ·