Temu Scraper 2.0

Easily Scrapes Temu product details manually.

### Overview Temu Scraper 2.0 is a powerful Chrome extension designed for researchers, e-commerce professionals, and data analysts who need to efficiently collect product information from Temu.com. This tool streamlines the process of gathering product details, managing product URLs, and exporting data for further analysis. ### ✨ Key Features **🎯 Smart Product Scraping** - **Single Product Scraping**: Scrape individual product pages with one click or keyboard shortcut (Ctrl+Shift+S) - **Batch Scraping**: Automatically scrape all open Temu product tabs sequentially (Ctrl+Shift+Q) - **Floating Action Button**: Convenient on-page scraping button that appears on product pages - **Automatic Tab Management**: Tabs automatically close after successful scraping **📊 Comprehensive Data Collection** - Product Title - Brand Name - Original Price & Sale Price - Product Images (up to 20 images per product) - Product Specifications (complete HTML) - Category/Breadcrumb Navigation - Available Quantities - Product URL (normalized and deduplicated) **📁 URL Management** - **Import URLs**: Upload CSV or TXT files containing product URLs for batch processing - **URL Normalization**: Automatically removes query parameters for clean data - **Duplicate Prevention**: Smart deduplication prevents scraping the same product twice - **URL Tracking**: Keep track of all imported and scraped product URLs **🎨 Smart Product Filtering** - **Remove Scraped Products**: Hide already scraped products from Temu listing pages - **Visual Indicators**: On-screen notifications show how many products were removed - **Works with Imported URLs**: Removes both scraped AND imported products from view **💾 Data Export & Management** - **CSV Export**: Export all scraped data to a well-formatted CSV file - **Persistent Storage**: All data is automatically saved to local storage - **Clear Data**: Easy one-click option to clear all stored data - **Status Logs**: Real-time status updates and operation logs (last 50 entries) **⚙️ Customizable Settings** - **Custom CSS Selectors**: Update selectors if Temu changes their website structure - **Configurable for All Elements**: Title, brand, price, images, specs, quantity, category selectors - **Reset to Defaults**: Easily restore default selector values - **Separate Settings Page**: Organized interface for managing all configurations **⌨️ Keyboard Shortcuts** - `Ctrl+Shift+S`: Scrape current product page - `Ctrl+Shift+Q`: Batch scrape all open Temu product tabs **🎯 User-Friendly Interface** - Modern, gradient-based UI with smooth animations - Responsive design that works on all screen sizes - Clear status indicators and error messages - Draggable floating button (position saves automatically) - Color-coded action buttons for easy navigation --- ## 📖 How to Use ### Getting Started 1. **Install the Extension**: Add Temu Scraper 2.0 to Chrome 2. **Navigate to Temu.com**: Open any Temu product page 3. **Start Scraping**: Use the floating button, keyboard shortcut, or popup menu ### Scraping Single Products **Method 1: Floating Button** - Navigate to any Temu product page - Click the purple "Scrape" button in the bottom-right corner - The product data will be collected and the tab will automatically close **Method 2: Keyboard Shortcut** - Navigate to any Temu product page - Press `Ctrl+Shift+S` - Product data is collected instantly **Method 3: Extension Popup** - Navigate to any Temu product page - Click the extension icon in your toolbar - Click "Scrape Product" button ### Batch Scraping Multiple Products 1. Open multiple Temu product pages in separate tabs 2. Click the extension icon 3. Click "Scrape All Tabs" or press `Ctrl+Shift+Q` 4. The extension will automatically: - Switch to each tab - Scrape the product data - Close the tab - Move to the next one 5. View progress in the status log ### Importing Product URLs 1. Prepare a CSV or TXT file with Temu product URLs - CSV: URLs can be in any column (typically first column) - TXT: One URL per line 2. Click the extension icon 3. Click "Import URLs" 4. Select your file 5. The extension will import and deduplicate URLs 6. Use these URLs with the "Remove Scraped" feature ### Hiding Scraped Products from Listings 1. Navigate to any Temu listing/search/category page 2. Click the extension icon 3. Click "Remove Scraped from Listing" 4. All products that have been scraped or imported will be hidden 5. A notification shows how many products were removed ### Exporting Your Data 1. Click the extension icon 2. Click "Export Data" 3. A CSV file named `temu_products.csv` will be downloaded 4. The CSV includes all scraped data with proper formatting ### CSV Export Format The exported CSV contains the following columns: - `url`: Product URL - `title`: Product title - `brand`: Brand name - `price`: Original price - `salePrice`: Sale/discounted price - `quantity`: Available quantity - `category`: Product category breadcrumb - `image-1` through `image-N`: All product images - `specs_html`: Product specifications in HTML format ### Customizing Selectors (Advanced) 1. Click the extension icon 2. Click "Settings" 3. Update any CSS selector fields as needed 4. Click "Save Settings" 5. Click "Reset to Defaults" to restore original values --- ## 🎯 Use Cases ### E-commerce Research - Compare product pricing across categories - Track price changes over time - Analyze product descriptions and specifications - Build product databases for comparison ### Market Analysis - Study product trends and categories - Analyze pricing strategies - Research competitor products - Gather market intelligence ### Academic Research - E-commerce platform studies - Pricing analysis research - Consumer behavior analysis - Product categorization studies ### Product Sourcing - Evaluate potential products for resale - Compare specifications across similar items - Track product availability - Build product catalogs --- ## 🔒 Privacy & Security **Your Privacy Matters** - ✅ **No Data Collection**: This extension does NOT collect, store, or transmit your personal data - ✅ **Local Storage Only**: All scraped data is stored locally on your computer - ✅ **No Analytics**: No tracking, analytics, or telemetry - ✅ **No External Servers**: Extension operates entirely in your browser - ✅ **Open Permissions**: Uses only necessary Chrome permissions (tabs, storage, scripting, downloads, cookies) **Required Permissions Explained** - `tabs`: To access and manage Temu product tabs for scraping - `storage`: To save scraped data and settings locally - `scripting`: To inject scraping scripts into Temu pages - `downloads`: To export CSV files to your computer - `cookies`: To manage Temu session cookies (optional feature) - `host_permissions (temu.com)`: To interact with Temu product pages --- ## ⚠️ Important Notes ### Responsible Use - This extension is designed for **research and educational purposes** - Always respect Temu's Terms of Service and robots.txt - Use reasonable delays between scraping requests - Avoid excessive automated scraping - Do not use scraped data for unauthorized commercial purposes ### Technical Considerations - Extension works only on Temu.com product pages - CSS selectors may need updates if Temu changes their website structure - Keep the extension updated for best compatibility - Some products may have incomplete data if page elements are missing ### Limitations - Works only on Temu.com (not other e-commerce sites) - Requires product pages to be fully loaded - Maximum 20 images per product - Status log keeps last 50 entries only --- ## 🆘 Troubleshooting **Extension Not Working?** - Ensure you're on a valid Temu product page (URL contains `.html` and `_oak_`) - Refresh the page and try again - Check if Temu has changed their page structure - Update CSS selectors in Settings if needed **Missing Data?** - Some products may have incomplete information - Try clicking specs/quantity sections manually before scraping - Check if Temu requires login for certain data - Verify selectors in Settings page **Batch Scraping Issues?** - Ensure all tabs are valid Temu product pages - Don't open too many tabs at once (recommended: 10-20 at a time) - Check your internet connection - Allow adequate time between tab switches **CSV Export Problems?** - Check if data was successfully scraped (view count in popup) - Ensure downloads are not blocked in Chrome - Check your Downloads folder for `temu_products.csv` - Try clearing data and re-scraping --- ## 🔄 Version History ### Version 2.1.0 (Current) - Enhanced UI with modern gradient design - Added draggable floating button on product pages - Improved batch scraping with better error handling - URL normalization and deduplication - "Remove Scraped" feature for listing pages - Customizable CSS selectors via Settings page - Automatic tab closing after scraping - Status log with 50-entry history - Keyboard shortcuts (Ctrl+Shift+S, Ctrl+Shift+Q) --- ## 📧 Support & Contact **Developer**: softametics@gmail.com **For Support**: - Report bugs and issues via email - Request feature enhancements - Get help with selector updates - Share feedback and suggestions **Please Include**: - Chrome version - Extension version - Screenshot of the issue - Product URL (if applicable) - Error messages from console (F12) --- ## 🌟 Rate & Review If you find this extension helpful, please: - ⭐ Leave a 5-star rating - ✍️ Write a review sharing your experience - 🔄 Share with colleagues who might benefit Your feedback helps improve the extension and helps others discover it! --- ## 📜 Legal Disclaimer This extension is provided "as is" without warranty of any kind. The developer is not responsible for: - How users choose to use this tool - Any violations of third-party terms of service - Data accuracy or completeness - Any consequences of using scraped data By using this extension, you agree to: - Use it responsibly and ethically - Comply with Temu's Terms of Service - Respect applicable laws and regulations - Take full responsibility for your usage --- ## 🎓 Educational Purpose This extension is developed for: - Learning web scraping techniques - Academic research purposes - Market research and analysis - E-commerce education - Data analysis studies Users should always prioritize ethical use and respect website terms of service.