E-commerce Logistics Aggregator（电商物流聚合）#

Query order logistics from Taobao, JD.com, Pinduoduo, and Douyin with persistent authentication.

Features#

• 🔗 Multi-platform: Taobao, PDD (JD & Douyin not supported due to anti-bot)
• 🔒 Persistent login: Cookie storage, no repeated logins
• 🛡️ Stealth mode: Bypass basic anti-bot detection
• ⏱️ Rate limiting: Built-in request throttling
• 📱 QR login: Graceful handling of expired sessions
• 🚚 In-transit filter: Only show orders currently in transit

Setup#

bash

# Install dependencies
cd scripts && npm install

# Required environment variables (optional, for headless operation)
export ECOM_LOGISTICS_DATA_DIR="$HOME/.ecommerce-logistics"

Usage#

First Time: Login to Platforms#

bash

cd scripts

# Login to Taobao (opens browser for QR scan)
npm run query -- --platform taobao --login

# Login to PDD
npm run query -- --platform pdd --login

# Note: JD and Douyin are not supported due to strict anti-bot measures

Query Logistics#

bash

# Query all platforms (requires prior login)
npm run query -- --all

# Query specific platform
npm run query -- --platform taobao
npm run query -- --platform pdd

# Query with custom data directory
npm run query -- --all --data-dir /path/to/cookies

# Run in headless mode (no browser window)
npm run query -- --all --headless

QR Login Process#

When cookies are missing or expired:

1. The skill opens a browser window with the platform login page
2. A QR code screenshot is saved to ~/.ecommerce-logistics/{platform}-qr.png
3. Scan the QR code with the platform's mobile app
4. Complete login in the browser window
5. Cookies are automatically saved for future use

Note: If you see "Cookie 已过期，需要重新登录", run the login command again.

Cookie Storage#

Cookies are stored encrypted in:

• Default: ~/.ecommerce-logistics/cookies/
• Each platform has separate cookie file
• Auto-refresh on expiration

Architecture#

text

scripts/src/
├── index.ts              # CLI entry
├── core/
│   ├── aggregator.ts     # Main orchestrator
│   ├── auth-manager.ts   # Cookie & QR login
│   ├── rate-limiter.ts   # Request throttling
│   └── stealth-browser.ts # Anti-detection browser
├── adapters/
│   ├── base-adapter.ts   # Abstract base class
│   ├── taobao-adapter.ts
│   ├── jd-adapter.ts
│   ├── pdd-adapter.ts
│   └── douyin-adapter.ts
└── types/
    └── index.ts          # TypeScript interfaces

references/
└── selectors.md          # Platform-specific CSS selectors

Error Handling#

ErrorHandlingCookie expiredPrompt QR re-loginRate limitedAuto-backoff retryLogin page detectedGraceful error with instructionsNetwork timeout3 retries with exponential backoff

Platform Support Status#

PlatformStatusNotesTaobao✅ AvailableOrder list + logistics infoJD❌ UnsupportedAnti-bot detection too strictPDD✅ AvailableOrder list + tracking number + pickup codeDouyin❌ UnsupportedRequires mobile app access

Implementation Notes#

Anti-Detection Measures#

The skill implements several stealth techniques:

1. navigator.webdriver override - Hides automation flag
2. Plugins spoofing - Simulates real browser plugins
3. Viewport & User-Agent - Uses realistic desktop/mobile profiles
4. Permissions API - Overrides notification permissions
5. Playwright-specific cleanup - Removes __playwright properties

Rate Limiting#

Each platform has independent rate limits:

PlatformMax RequestsWindowTaobao1060sJD1560sPDD860sDouyin1060s

Cookie Expiration#

• Cookies are considered expired after 30 days
• Expired cookies trigger QR re-login prompt
• Each platform stores cookies independently

Development#

Updating Selectors#

Platform websites change frequently. Update selectors in:

• references/selectors.md - Documentation
• src/adapters/*-adapter.ts - Implementation

Testing#

bash

# Compile TypeScript
cd scripts && npm run build

# Run in development mode
npm run dev -- --platform taobao

# Debug with visible browser
npm run query -- --platform taobao --headless=false