popmart-stock-monitor（popmart 库存监控）

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

1. Product Identification: Match by product name, SKU, or official product ID
2. Availability Check:

- "In Stock" / "有货" status - Add-to-cart button enabled - Price displayed (not "sold out")

1. 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

1. "Access Denied" errors: Check API credentials and rate limits
2. False stock alerts: Adjust detection logic in stock_detection.py
3. Connection timeouts: Increase timeout values or use proxy
4. 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