POP MART Helper

A powerful bookmarklet for tracking and analyzing POP MART sets with automated navigation and range analysis.

✨ Features

$3

- Set Tracking: Automatically discovers and tracks sets with box states
- Clickable Sets: Click any discovered set to open it in a new tab
- Visual Highlighting: Middle numbers highlighted in set IDs for easy identification
- Local Storage: Saves set records per product page for persistence

$3

- Range Analysis: Automatically finds missing items in discovered ranges
- Smart Pattern Recognition: Extracts and analyzes 5-digit middle numbers from set IDs
- Clickable Missing Links: Direct links to all missing items in range
- Real-time Updates: Analysis updates as new sets are discovered

$3

- Smart Navigation: Automated clicking and set progression
- Stock Monitoring: Wait for out-of-stock items to become available
- Auto Box Selection: Handles box image clicking and navigation
- Delay Controls: Configurable timing with jitter for human-like behavior

$3

- Version Display: Shows current version in UI title
- Cache Busting: Always loads latest version from CDN
- JSON Inspection: View raw API responses for debugging
- Console Logging: Detailed logging for troubleshooting

🚀 Quick Start

$3

1. Visit https://lxe.github.io/popmarthelper/ for the online installer
2. Drag the "POP MART Helper" button to your bookmarks toolbar
3. Navigate to any POP MART product page (ending with /pop-now/set/{id})
4. Click the bookmarklet to activate

$3

1. Start Automation: Click "Start" on a product page to begin set discovery
2. Stock Waiting: Use "Wait Until In Stock" for out-of-stock items
3. View Analysis: Check the blue-bordered range analysis above sets
4. Click Sets: Click any discovered set to open it in a new tab
5. Missing Items: Click links in range analysis to jump to missing sets

🎮 Interface

$3

All buttons are conveniently inline:
- Start/Stop: Begin or halt automation
- Reset: Clear all discovered sets
- Wait Until In Stock: Monitor for stock availability
- Hide/Show Sets: Toggle set visualizer visibility
- Toggle JSON: View raw API responses

$3

- Yellow Highlighting: Middle numbers highlighted in set IDs
- Color Coding: Recent discoveries highlighted in yellow
- Box States: Visual representation of each box state
- Click to Open: Click any set to open in new tab
- Hover Effects: Sets scale and show shadow on hover

$3

- Blue Border: Always visible above sets
- Missing Count: Shows discovered vs missing items
- Direct Links: Click middle numbers to open missing sets
- Real-time: Updates automatically as sets are found

🛠️ Development

$3

- CDN Distribution: Published to npm, served via jsDelivr
- Cache Busting: Unique URLs prevent caching issues
- Version Injection: Automatic version headers in published scripts
- No Build Complexity: Simple copy and publish workflow

$3

``bash

Increment version and publish to npm

npm run deploy

CDN automatically updates at:

https://cdn.jsdelivr.net/npm/popmarthelper@latest/dist/script.js

`

$3

1. Edit script.js directly
2. Test by loading local file or via bookmarklet
3. Run npm run deploy when ready to publish
4. Users automatically get updates via CDN

$3

`
├── script.js # Main script (source)
├── publish.js # Version increment and npm publish
├── bookmarklet.html # Static installation page
├── package.json # npm package configuration
└── dist/
└── script.js # Published version with headers
`

📋 Technical Details

$3

- Extracts 5-digit middle numbers from set IDs
- Pattern: 1000[XXXXX]... (positions 4-8)
- Example: 10008782500350 → 87825

$3

- Finds lowest and highest discovered middle numbers
- Generates all possible IDs in range
- Identifies missing items with direct links
- Handles URL postfix removal for clean navigation

$3

- Clicks header logo to navigate away
- Uses browser back button to return
- Polls for visible next arrow (indicates stock)
- Seamlessly transitions to automation when available

$3

- window.POP_MART_HELPER_VERSION` set in published versions
- Displays in UI title: "POP MART Helper v1.0.8 - Set Tracker"
- Timestamp and CDN URL in script headers
- Cache busting via query parameters

⚠️ Important Notes

- Page Requirement: Only works on POP MART product pages
- Responsible Use: Follow POP MART's terms of service
- Browser Compatibility: Modern browsers with ES6+ support
- Local Storage: Data saved per product page URL
- CDN Delays: New versions available within minutes of publishing

🔧 Advanced Configuration

$3

- Base Delay: Minimum time between actions (default: 500ms)
- Jitter: Random variation to seem more human (default: 100ms)
- Combined: Actual delay = base ± random(jitter)

$3

- Reset Button: Clears all stored set data
- URL-Specific: Each product page has independent storage
- Persistent: Data survives browser restarts

$3

- JSON Toggle: View raw API responses
- Console Logging: Detailed operation logs
- Version Display: Always visible in UI
- Error Handling: Graceful fallbacks and retries

📈 Recent Updates

- ✅ Clickable sets opening in new tabs
- ✅ Inline button layout with flex-wrap
- ✅ Highlighted middle numbers (no more parentheses)
- ✅ CDN-based distribution with cache busting
- ✅ Automatic version injection and display
- ✅ Simplified publish workflow
- ✅ Enhanced range analysis with direct links
- ✅ Improved hover effects and visual feedback

---

Built for POP MART collectors by automation enthusiasts 🎁