Start here (beta testers)
ListFast 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 ListFast 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 ListFast 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 ListFast 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 ListFast.
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 ListFast: age, prices, views, export to CSV.
- Refresh list – reload your tracked listings.
- Sync from eBay – update prices and view counts.
- Edit on eBay – change title, description, or price on a live listing.
- Price drop candidates – items listed 20+ days; apply a 10% drop with one click.
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. ListFast 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 ListFast 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.