PopMart Stock Monitor
Overview
This skill monitors PopMart product availability across major Chinese e-commerce platforms:
- WeChat Mini Programs (official PopMart store)
- Taobao
- JD.com
- Tmall
Setup Requirements
API Keys & Authentication
- Taobao/Tmall: Requires Taobao Open Platform API access
- JD.com: Requires JD Open Platform API access
- WeChat: Requires official Mini Program access or web scraping (limited)
- Proxy/VPN: May be needed for reliable access to Chinese platforms
Installation
# Install required dependencies
pip install requests beautifulsoup4 selenium playwright
Usage Examples
Basic Product Monitoring
Monitor PopMart "Molly Ocean" series on all platforms
Check PopMart Labubu blind box stock status
Track availability of PopMart Dimoo Space series
Advanced Configuration
Monitor PopMart product ID 12345 every 30 minutes
Check PopMart stock with priority: JD > Tmall > Taobao
Alert me via Feishu when PopMart Molly is back in stock
Implementation Details
Platform-Specific Handlers
WeChat Mini Program
- Method: Web scraping (requires mobile user-agent)
- Limitations: Rate limiting, requires session cookies
- Reliability: Medium (depends on Mini Program updates)
Taobao/Tmall
- Method: Official API preferred, fallback to web scraping
- Authentication: OAuth 2.0 with Taobao developer account
- Rate Limits: 100 requests/minute per app
JD.com
- Method: Official JD Open Platform API
- Authentication: App key + secret authentication
- Rate Limits: 50 requests/minute per app
Stock Detection Logic
- Product Identification: Match by product name, SKU, or official product ID
- Availability Check:
- "In Stock" / "有货" status
- Add-to-cart button enabled
- Price displayed (not "sold out")
- False Positive Filtering:
- Exclude pre-order items
- Verify actual inventory vs display status
Notification System
Supported Channels
- Feishu: Webhook integration (recommended)
- Email: SMTP configuration required
- SMS: Requires telecom API integration
- Local: Desktop notifications
Alert Templates
🚨 POPMART RESTOCK ALERT 🚨
Product: {product_name}
Platform: {platform}
Status: Back in Stock!
Link: {product_url}
Price: {price}
Last Checked: {timestamp}
Configuration File
Create popmart_config.json in your workspace:
{
"products": [
{
"name": "Molly Ocean Series",
"sku": "PM-MLY-OCEAN-2026",
"platforms": ["wechat", "taobao", "jd", "tmall"],
"priority": ["jd", "tmall", "taobao", "wechat"]
}
],
"check_interval_minutes": 30,
"notification": {
"channel": "feishu",
"webhook_url": "YOUR_FEISHU_WEBHOOK_URL"
},
"api_keys": {
"taobao_app_key": "YOUR_TAOBAO_APP_KEY",
"taobao_app_secret": "YOUR_TAOBAO_APP_SECRET",
"jd_app_key": "YOUR_JD_APP_KEY",
"jd_app_secret": "YOUR_JD_APP_SECRET"
}
}
Limitations & Considerations
Technical Challenges
- Anti-bot measures: Chinese platforms have aggressive bot detection
- Session management: WeChat Mini Programs require valid sessions
- Rate limiting: All platforms enforce strict rate limits
- Dynamic content: Heavy JavaScript rendering on some platforms
Legal Compliance
- Respect robots.txt and terms of service
- Implement reasonable request intervals (≥30 seconds)
- Do not overload platform servers
- Use official APIs when available
Reliability Notes
- WeChat: Most unreliable due to frequent Mini Program updates
- Taobao/Tmall: Moderate reliability with proper API access
- JD.com: Most reliable with official API integration
Troubleshooting
Common Issues
- "Access Denied" errors: Check API credentials and rate limits
- False stock alerts: Adjust detection logic in
stock_detection.py - Connection timeouts: Increase timeout values or use proxy
- Missing products: Verify product identifiers and platform availability
Debug Mode
Enable debug logging by setting DEBUG=true in environment:
DEBUG=true python popmart_monitor.py
Maintenance
- Update selectors monthly (Chinese sites change frequently)
- Rotate user agents to avoid detection
- Monitor API quota usage
- Test with new PopMart product launches