AMEX Offers Helper

Quickly add all American Express offers with one click.

# AMEX Offers Helper 🎯 ## Effortlessly add all available American Express Offers to your card with a single click! **Stop wasting time manually clicking through dozens of offers.** AMEX Offers Helper streamlines the entire process—just open your eligible offers page, hit "Add All Offers," and watch as every available offer gets activated instantly. ✨ **Save 5+ minutes per session** • **Never miss a valuable offer** • **100% automated**  --- ## Why Choose AMEX Offers Helper? ### 🚀 Lightning-Fast Automation One-click operation adds **all available offers in seconds**, not minutes. Our smart rate-limiting ensures natural interaction with the AMEX website while maximizing speed. ### 🎨 Sleek Matrix-Style Interface Featuring a futuristic green-on-black design with glowing effects, our popup is both stylish and functional. Real-time notifications appear in the bottom-right corner showing exactly how many offers were added. ### 🔒 Privacy-First & Secure - **Zero data collection** - Your information never leaves your browser - **Minimal permissions** - Only accesses the AMEX Offers page - **Open source** - Full transparency, inspect the code yourself - **No tracking, no analytics, no telemetry** ### ✨ Smart & Reliable - **Robust detection** works with all "Add to Card" buttons, even after AMEX redesigns - **Error handling** ensures the process completes even if individual offers fail - **Visual feedback** shows success/failure status with intelligent notifications - **Keyboard accessible** with full ARIA support for screen readers ### 💪 Built for Power Users - **Configuration constants** allow developers to customize timing - **Rate limiting** prevents detection as automated behavior - **Production-ready** code with no debug logging cluttering your console ## How It Works ⚡ ### It's as simple as 1-2-3: 1. **📌 Install and pin the extension** to your browser toolbar 2. **🌐 Visit your AMEX Offers page** (or use our quick "Go to AMEX Offers" button) 3. **✨ Click "Add All Offers"** and watch the magic happen! Within seconds, you'll see a sleek Matrix-style notification in the bottom-right corner confirming how many offers were successfully added to your card. No manual clicking, no hassle, no missed opportunities. ### What Happens Behind the Scenes? - The extension intelligently detects all "Add to Card" buttons on the page - Each offer is activated with a 200ms delay between clicks (appears human-like) - Only visible and enabled offers are processed - Real-time error handling ensures maximum success rate - You get instant feedback with detailed status notifications ## Technical Details The extension uses Chrome's scripting API to: 1. Inject a content script into the AMEX offers page 2. Find all "Add Offer" buttons using the `data-testid` attribute 3. Programmatically click each visible and enabled button with smart rate limiting 4. Display a notification showing the results ## 🔐 Permissions & Privacy ### We Take Your Privacy Seriously This extension operates **exclusively on the AMEX Offers page** and does not access or transmit any sensitive information. Period. #### Minimal Permissions Required: - **`scripting`** - To inject the offer-adding automation into the AMEX page - **`tabs`** - To open the AMEX offers page and communicate with the active tab - **`host_permissions`** - Limited strictly to `https://global.americanexpress.com/*` **That's it.** No access to your browsing history, passwords, personal data, or any other websites. #### Our Privacy Guarantee: ✅ **Zero data collection** - Nothing is stored, logged, or transmitted ✅ **No external servers** - Everything runs locally in your browser ✅ **No tracking or analytics** - We don't know you exist, and we like it that way ✅ **Open source transparency** - Inspect every line of code yourself ✅ **Content Security Policy** - Protection against XSS and injection attacks ✅ **Secure coding practices** - Individual DOM property assignment, proper error handling **Your data stays yours. Always.** ## Compatibility - **Chrome**: Version 88+ (Manifest V3 support) - **Edge**: Version 88+ (Chromium-based) - **Target Website**: https://global.americanexpress.com/offers/eligible ## ❓ Troubleshooting ### Extension not working? **First, check the basics:** 1. ✅ Are you on `https://global.americanexpress.com/offers/eligible`? 2. ✅ Has the page fully loaded? (Wait for all offers to appear) 3. ✅ Are offer buttons visible? (Scroll down if needed) **Still not working?** - Reload the extension: Go to `chrome://extensions/` → Click the reload icon - Refresh the AMEX page and try again - Check if the extension icon is active (not grayed out) ### No offers being added? **Look for the Matrix-style notification in the bottom-right corner:** - 🟢 **"✓ Added X offers!"** - Success! All offers were added - 🟡 **"⚠ No new offers to add"** - All offers are already on your card - 🔴 **"✗ Failed to add offers"** - An error occurred (see below) **If you see an error:** 1. The page structure may have changed - [Report an issue on GitHub](https://github.com/yourusername/amex-offers-add-all/issues) 2. Make sure you're logged into your AMEX account 3. Try using the extension during off-peak hours 4. Disable other AMEX-related extensions that might interfere ### Common Questions **Q: How many offers can it add at once?** A: Unlimited! The extension will process all visible offers on the page, no matter how many. **Q: Will this get my account banned?** A: No. The extension uses human-like delays (200ms between clicks) and only interacts with buttons you could click manually. It's just automation, not exploitation. **Q: Can I adjust the speed?** A: Yes! Developers can modify `CLICK_DELAY_MS` in `content.js` (line 5) to customize timing. **Q: Does it work on mobile?** A: No, this is a desktop browser extension for Chrome/Edge only. **Q: What if AMEX changes their website?** A: The extension uses robust `data-testid` selectors which are designed to be stable. If it breaks, please report an issue and we'll fix it quickly! ## Disclaimer This extension is not affiliated with, endorsed by, or sponsored by American Express. Use at your own risk. The extension automates clicks on the AMEX website but does not modify any data or bypass any security measures. ## License This project is open source. See LICENSE file for details. ## 📦 Version History ### v2.0 - **The Matrix Edition** (Current) *A complete overhaul focused on reliability, security, and style* **🎨 User Experience:** - Stunning Matrix-style UI with green glow effects and monospace fonts - Smart notification system in bottom-right corner with contextual messages - Enhanced visual feedback for all button interactions - Improved disabled button styling for better UX **🛡️ Security & Privacy:** - Content Security Policy (CSP) implementation - Secure DOM manipulation (no template literal injection risks) - Zero console logging in production - Enhanced error boundary protection **⚡ Performance & Reliability:** - Configuration constants for easy timing adjustments - Duplicate notification prevention system - Memory leak fixes in notification cleanup - Robust error handling in click loops - Smart rate limiting (200ms between clicks) **♿ Accessibility:** - Full ARIA support (`role="alert"`, `aria-live`) - Keyboard focus indicators with visible outlines - Proper `lang` attribute for HTML - Screen reader compatible notifications **🔧 Developer Experience:** - Cached DOM references for better performance - Clean, maintainable code structure - Semantic variable naming conventions - Comprehensive error reporting ### v1.0 - Initial Release - Basic one-click offer addition - Simple two-button interface - Manifest V3 compliance - Foundation for future enhancements ## Support If you encounter issues or have suggestions, please: - Open an issue on GitHub - Check existing issues for solutions - Provide browser version and error messages when reporting bugs --- ## 🌟 Show Your Support If AMEX Offers Helper saves you time and helps you maximize your rewards: - ⭐ **Star this repository** to help others discover it - 🐛 **Report bugs** to help us improve - 💡 **Suggest features** you'd like to see - 🔗 **Share with friends** who have AMEX cards - ☕ **Buy us a coffee** (link coming soon!) ## 🤝 Contributing We welcome contributions! Whether it's: - 🐞 Bug fixes - ✨ New features - 📝 Documentation improvements - 🎨 UI/UX enhancements - 🌍 Translations Please feel free to: 1. Fork the repository 2. Create a feature branch (`git checkout -b feature/AmazingFeature`) 3. Commit your changes (`git commit -m 'Add some AmazingFeature'`) 4. Push to the branch (`git push origin feature/AmazingFeature`) 5. Open a Pull Request --- **Made with ❤️ by AMEX cardholders, for AMEX cardholders** *Save time. Maximize rewards. Never miss an offer again.* 🎯 **AMEX Offers Helper** - Because your time is worth more than clicking buttons.