PinPeek 📌

Distraction-free Pinterest visual previews inside a Chrome extension with AI-powered smart search.

✨ Features

• 🔍 Quick Search - Search Pinterest without leaving your current tab
• 🤖 AI Smart Search - Powered by Groq AI to optimize your search queries for better visual results
• 🎯 Distraction-Free - Clean, minimal interface showing only what matters - the pins
• ⚡ Fast Preview - Instant visual grid of top Pinterest results
• 🎨 Masonry Layout - Beautiful Pinterest-style grid layout
• 🔒 Privacy-First - Your API key is stored locally, never sent to our servers

📸 Screenshots

Screenshots will be added after capturing real extension usage

🚀 Installation

From Chrome Web Store (Recommended)

Coming soon - Store link will be added after submission

Manual Installation (Development)

1. Download or clone this repository
2. Open Chrome and navigate to chrome://extensions
3. Enable "Developer mode" in the top right
4. Click "Load unpacked" and select the extension directory
5. The PinPeek icon should appear in your extensions toolbar

🤖 Setting Up AI Search

PinPeek uses Groq for AI-powered search optimization:

1. Get a Free API Key

   • Visit console.groq.com
   • Sign up for a free account
   • Generate an API key

2. Add to Extension

   • Click the PinPeek extension icon
   • Toggle "Smart Search (AI)" on
   • Enter your Groq API key when prompted
   • Click "Save"

3. Start Searching

   • Type any search term
   • Press Enter
   • AI will optimize your query for better Pinterest results!

💡 How to Use

1. Click the PinPeek icon in your Chrome toolbar
2. Type what you're looking for (e.g., "cozy bedroom ideas")
3. Press Enter or toggle AI Search for enhanced results
4. Browse the visual grid of pins
5. Click "Open" on any pin to view it on Pinterest

🛠️ Tech Stack

• Frontend: Vanilla JavaScript, HTML5, CSS3
• AI: Groq API (Llama 3 8B model)
• Chrome APIs: Tabs, Scripting, Storage, Runtime
• Design: Pinterest-inspired minimal UI

🔐 Privacy Policy

PinPeek respects your privacy:

• No Data Collection: We don't collect, store, or transmit any of your personal data
• Local Storage Only: Your Groq API key is stored locally in your browser using Chrome's storage API
• No Tracking: No analytics, no tracking, no third-party scripts
• Open Source: All code is available for review in this repository

The extension only:

• Opens Pinterest search pages in background tabs
• Extracts pin images and links from public Pinterest pages
• Stores your AI toggle preference and API key locally

🧑‍💻 Development

Prerequisites

• Google Chrome (or Chromium-based browser)
• Basic knowledge of Chrome Extension development

Local Setup

# Clone the repository
git clone https://github.com/yourusername/pinpeek.git
cd pinpeek

# Load in Chrome
# 1. Open chrome://extensions
# 2. Enable Developer Mode
# 3. Click "Load unpacked"
# 4. Select the extension directory

File Structure

pintrestExtension/
├── manifest.json          # Extension configuration
├── background.js          # Service worker (handles search logic)
├── contentScript.js       # Extracts pins from Pinterest pages
├── popup/
│   ├── popup.html        # Extension popup UI
│   ├── popup.js          # Popup logic
│   └── popup.css         # Popup styles
├── img/
│   └── logo.png          # Extension icon
└── store-assets/         # Chrome Web Store assets

🤝 Contributing

Contributions are welcome! Feel free to:

• Report bugs
• Suggest new features
• Submit pull requests

📝 License

MIT License - feel free to use this project however you'd like!

🙏 Acknowledgments

• Pinterest for the inspiration
• Groq for providing fast AI inference
• Chrome Extensions team for the excellent documentation

---

Made with ❤️ for Pinterest lovers who want a cleaner browsing experience