Start here (beta testers)
ListrApp is invite-only during beta. You will get a link and invite code from the team. You do not need API keys or an eBay Developer account—only your normal eBay seller account.
- Open the ListrApp link you were sent.
- Sign in and enter your invite code.
- Click Connect to eBay in the sidebar and approve access.
- Add photos → Generate listing → review → publish.
During beta you publish to your own live eBay account. Your listings and connection are private to your login—not shared with other testers.
What you need
- Invite code – from the ListrApp team.
- eBay seller account – the account you list from.
- Photos – up to 20 per item (JPG, PNG, GIF, WebP).
- eBay business policies – payment, return, and shipping (one-time IDs; see below).
AI listing generation is included. You never enter an Anthropic or developer key.
Connect your eBay account
- In the sidebar, click Connect to eBay.
- Sign in with your eBay seller account.
- Click Agree and Continue / Approve.
- The sidebar should show eBay: Connected.
Important: Always use the same ListrApp URL you were invited to (do not switch between different web addresses). If the badge says Not connected, click Connect again and refresh the page.
Disconnect anytime: eBay → Settings → Connected applications → remove ListrApp.
One-time publish setup
Enter these once in step 4 (Publish). The app remembers them in your browser.
| Field in app | Where to get it |
|---|---|
| Merchant location key | eBay Seller Hub → inventory location (e.g. default). In the app, try Load from eBay. |
| Payment policy ID | ebay.com/bp/manage → Payment → open policy → number in the URL. |
| Return policy ID | Same page → Return policy → number in URL. |
| Fulfillment policy ID | Same page → Shipping policy → number in URL. |
| Category ID | In the app: Suggest categories, or copy from eBay when listing something similar. |
Your first listing
- Create listing tab → add photos (click or drag).
- Optional: keywords or price hint → Generate listing.
- Review – edit title, description, bullets.
- Category & price – Category ID, research sold prices, set price.
- Publish – confirm policies → Publish selected channels.
Check title and price before publishing. The listing goes live on your eBay account.
My Listings
Track what you published from ListrApp: age, prices, item cost, estimated profit, views, watchers, shelf location, and status. Export to CSV anytime.
- Aging dots – a yellow dot means 20+ days with no sale (first nudge); a red dot means 45+ days (stale).
- -5% / -10% – drop the price on a flagged row with one tap (−10% appears on 45+ day rows for a deeper cut).
- Best Offer / Promote – turn on offers or set a Promoted Listings ad rate right from the row.
- Item cost & Shelf – click the cell to edit inline; item cost feeds estimated profit.
- Sync from eBay – update prices, views, and watchers.
- Edit on eBay – change title, description, or price on a live listing.
- Show Queue (Whatnot) – export an ordered sheet to prep a live show.
Channels: one-click vs Paste Kit
ListrApp labels every channel honestly so you always know what to expect:
- One-click today: eBay, Shopify, TikTok Shop.
- Coming soon (being added): Reverb; Etsy (creates a draft you activate — free until you do).
- Partner pending: Depop — use the Paste Kit until partner API access lands.
- Waitlisted: Whatnot — use Show Queue export until the seller API opens.
- Paste Kit: Poshmark, Mercari, Vinted, Grailed, Facebook Marketplace, OfferUp, Craigslist. Open the site's create page, then use Copy next field to move through the form in order with progress tracking.
Editing after publish
- Same session: Back → edit → Save changes to eBay.
- My Listings: Edit on eBay on an active row.
Price research
On step 3, click Research sold prices. ListrApp searches similar sold listings and suggests a price. This uses your listing title—not your eBay login details.
Get help
- Help chat – in the app sidebar (answers common questions automatically).
- This guide – sidebar → Guide, or print this page to PDF.
- Still stuck? Email support with the exact error text from the red banner and a screenshot.
Troubleshooting
| Issue | What to do |
|---|---|
| eBay: Not connected | Click Connect to eBay on this same site URL. Sign in and approve. Refresh the page. |
| Publish failed | Check Category ID and all four policy fields. Read the error message—it usually names what’s missing. |
| Page errors in Cursor preview | Use Chrome, Firefox, or Edge in a normal browser window. |
| Wrong account / someone else’s listings | Each invite is separate. Sign in with your invite; connect your eBay. Contact support if something looks wrong. |
| Category suggestions empty | Enter Category ID manually from a similar eBay listing. |
Save this guide as PDF
Click Print / Save as PDF at the top of this page, then choose Save as PDF in your browser.
Appendix: self-hosting (technical)
This section is for developers running their own copy—not beta testers on the hosted app.
Environment (.env)
Hosted ListrApp uses server-side keys. Self-hosters need ANTHROPIC_API_KEY, EBAY_CLIENT_ID, EBAY_CLIENT_SECRET, EBAY_RUNAME, and optional S3/Shopify variables. See .env.example in the project.
eBay Developer Portal
Create an app at developer.ebay.com, set RuName Auth Accepted URL to your callback (e.g. https://your-host/ebay/callback), set EBAY_SANDBOX=false for production.
Run locally
pip install -r requirements.txt
python main.pyFull technical docs: USER_GUIDE.md, EBAY_SETUP.md, SHOPIFY_SETUP.md.