Uzei - Literature Review Extension

A Chrome browser extension that automatically extracts and analyzes content from web pages and PDF documents, seamlessly integrating with Uzei Literature Review web application for efficient research paper collection and management.

Features

• 🔍 Smart Content Extraction: Automatically detects and extracts article content, metadata, authors, and publication dates
• 📄 PDF Support: Processes PDF documents opened in the browser with server-side text extraction
• 🤖 AI-Powered Relevance Analysis: Built-in AI (Gemini Nano) analyzes how relevant papers are to your project before adding to collections
• 📊 Multi-tab Processing: Batch process multiple tabs simultaneously for efficient research workflows
• 🗂️ Smart Tab Management: Auto-close of successfully processed tabs to keep your workspace organized
• ✅ Content Validation: Smart badges indicate which tabs contain valid extractable content
• 🔄 Session Management: Automatically syncs with your web app login status
• 🎯 Academic Publisher Support: Enhanced extraction for major academic publishers (IEEE, ACM, Springer, ScienceDirect, etc.)

Prerequisites

• Google Chrome browser (version 127+ recommended for AI features)
• Access to the Uzei Literature Review web application at https://uzei.bostonlistener-career.org
• Valid user account on the web application

Installation (Developer Mode)

Step 1: Download the Extension Files

Ensure you have all the following files in a single folder:

uzei-literature-review-extension/
├── manifest.json
├── background.js
├── content.js
├── popup.html
├── popup.js
├── options.html
├── options.js
├── README.md
├── PromptAPISetupGuide.md
├── LICENSE
└── icons/
    ├── icon16.png
    ├── icon48.png
    └── icon128.png

Step 2: Enable Developer Mode in Chrome

1. Open Google Chrome
2. Navigate to chrome://extensions/
3. Toggle "Developer mode" in the top-right corner
4. You should now see additional buttons: "Load unpacked", "Pack extension", "Update"

Step 3: Load the Extension

1. Click "Load unpacked" button
2. Navigate to and select the folder containing the extension files
3. Click "Select Folder"
4. The extension should now appear in your extensions list with a green "On" toggle

Step 4: Pin the Extension (Optional)

1. Click the extensions icon (puzzle piece) in Chrome's toolbar
2. Find "Uzei - Literature Review" in the dropdown
3. Click the pin icon to pin it to your toolbar for easy access

Usage Instructions

Initial Setup

1. Log into the Web App: Visit https://uzei.bostonlistener-career.org and log in with your credentials (Registration Code: J2YH7G1MAWH3)
2. Create a Project: Create or select a literature review project in the web app
3. Verify Connection: The extension icon should show a green checkmark when logged in

Adding Single Pages

1. Navigate to any webpage or PDF document you want to add
2. Click the extension icon in your toolbar
3. Select your target project from the dropdown
4. Choose the appropriate source type (Research Paper, Web Article, etc.)
5. Analyze with AI: Click "Analyze Relevance with AI" to get an intelligent assessment before adding
6. Click "Add to Project" to extract and save the content

AI Relevance Analysis

Before adding a paper to your project, you can use the built-in AI to assess its relevance:

1. Extract content from the current tab (happens automatically)
2. Select your project to provide the project context for the AI
3. Click "Analyze Relevance with AI"
4. Review the AI's assessment, which includes:
   • Relevance rating (highly relevant, moderately relevant, marginally relevant, or not relevant)
   • Clear recommendation on whether to add the paper
   • Explanation of the reasoning
5. Decide whether to add the paper based on the analysis

Requirements: Chrome 127+ with built-in AI enabled. The AI model may need to download on first use. See the Prompt API Setup Guide for detailed installation instructions.

Batch Processing Multiple Tabs

Perfect for researchers who open 30-40 paper tabs and need to process them efficiently:

1. Open multiple tabs with content you want to process
2. Click the extension icon
3. Switch to "Multiple Tabs" mode
4. Select the tabs you want to process (use "Valid Only" to auto-select)
5. Choose your project and default source type
6. Click "Process Selected Tabs"
7. Wait for processing to complete (progress bar shows status)
8. Choose whether to close successfully processed tabs to organize your workspace

Supported Content Types

Webpages

• Research articles and academic papers
• Blog posts and news articles
• Documentation and technical guides
• Any article-style content with sufficient text

PDF Documents

• Academic papers and research documents
• Technical reports and whitepapers
• Any PDF opened in the browser
• Server-side text extraction and analysis

Extension Settings

Access settings by:

1. Right-clicking the extension icon and selecting "Options"
2. Or visiting chrome://extensions/ and clicking "Details" → "Extension options"

Available settings:

• Auto-extract content on page load
• Show notifications for successful additions
• Enable context menus
• Enable multi-tab batch processing
• Content length limits
• Badge display preferences

Tips for Best Results

For AI Analysis

• Make sure your project has clear research questions defined in the web app
• The AI uses your project context (Project Overview, Research Strategy, Review Questions) for better recommendations
• Works completely on-device - no data sent to external servers

For Batch Processing

• Use "Valid Only" button to automatically select tabs with extractable content
• The extension will ask if you want to close successfully processed tabs - great for keeping your workspace clean
• Process multiple tabs simultaneously by default for optimal performance

For PDF Processing

• Open PDFs directly in Chrome's PDF viewer for best results
• The extension extracts the actual PDF URL, not the browser viewer URL
• Server-side processing ensures accurate text extraction

Troubleshooting

AI Analysis Not Available

• Ensure you're using Chrome 127 or later
• Check that built-in AI features are enabled in Chrome
• The AI model may need to download on first use (wait for the download to complete)
• Follow the Prompt API Setup Guide for step-by-step instructions

Content Extraction Issues

1. Check the browser console for error messages
2. Verify network connectivity to the web application
3. Ensure all extension files are present and properly loaded
4. Try refreshing the page and extracting again
5. For PDFs, ensure they're opened in Chrome's built-in viewer

Batch Processing

• If tabs close unexpectedly, they may have been closed during processing
• Progress bar shows real-time status of batch operations
• Successfully processed tabs can be optionally closed to keep workspace organized

Support

For issues or questions:

1. Check the browser console for error messages
2. Verify network connectivity to the web application
3. Ensure all extension files are present and properly loaded
4. Test with a simple webpage first before trying complex content

---

Version: 2.4
Compatibility: Chrome (Manifest V3)
Web App: https://uzei.bostonlistener-career.org

Help Us Keep This Project Running

If you find this extension helpful, consider supporting our development: