@mpelka/aliorders
v1.0.0
Published
CLI tool to fetch and display your AliExpress order history using browser cookies
Readme
@mpelka/aliorders
CLI tool to fetch and display your AliExpress order history, including tracking info, by using the internal web API.
Requirements
- macOS (cookie extraction uses Chrome's local database)
- Google Chrome with an active AliExpress login
- Bun runtime
Install
# From npm
npm install -g @mpelka/aliorders
# Or clone and run directly
git clone https://github.com/mpelka/aliorders.git
cd aliorders
bun install
bun linkUsage
aliorders # Show active orders (default)
aliorders -s all # Show all orders including completed
aliorders -s shipped # Filter by status
aliorders -s completed # Show completed orders
aliorders -n 20 # Fetch up to 20 orders
aliorders -p 2 # Show page 2
aliorders --json # Output as JSON for scripting/agents
aliorders --no-details # Skip tracking lookups (faster)
aliorders statuses # List all status filtersBy default, only active orders are shown (awaiting payment, awaiting shipment, in transit). Use -s all to include completed and cancelled orders.
Status filters
| Filter | Aliases | Description |
|-------------|----------------------|------------------------|
| all | | All orders (no filter) |
| waitpay | paying | Awaiting payment |
| waitsend | shipping | Awaiting shipment |
| waitaccept| shipped, transit | Shipped / In transit |
| finish | completed, done | Completed |
| close | cancelled | Cancelled / Closed |
JSON output
Use --json to get structured output, useful for piping to jq or feeding to LLM agents:
aliorders --json | jq '.[].status'
aliorders --json --no-details # Faster, skips tracking API callsExit codes
| Code | Meaning |
|------|-----------------|
| 0 | Success |
| 1 | Error |
| 2 | No orders found |
How it works
Every run extracts fresh authentication cookies directly from Chrome's local database for aliexpress.com. These cookies are used to sign requests to AliExpress's internal API endpoints. Nothing is persisted to disk — cookies are always read fresh from Chrome.
Troubleshooting
Token expired / empty response: Visit aliexpress.com in Chrome and browse around (this refreshes the auth token), then run again.
Security
Cookies are read directly from Chrome's database and held in memory only for the duration of the command. Nothing is written to disk.
License
MIT
