Skip to content

patrice012/linkedin-ext-scraper

Repository files navigation

LinkedIn Extension Scraper (v1.0) - Legacy

Version License Status

Original LinkedIn & Sales Navigator data extraction tool

InstallationDevelopmentMigration


⚠️ Important Notice

This is the legacy version (v1.0). For new projects, use Prospecty v2.0 which offers:

  • ✨ TypeScript architecture
  • 🚀 Better performance (Plasmo)
  • 🎨 Modern UI (TailwindCSS + shadcn)
  • 📦 Easier maintenance

🔗 Project Links


🎯 Overview

Chrome extension for extracting data from LinkedIn and Sales Navigator. Built with React and Create React App.

Features

Data Sources (11 Types):

  • LinkedIn Profiles & Companies
  • LinkedIn Search Results (People & Companies)
  • Sales Navigator Leads & Companies
  • Sales Navigator Search Results
  • Sales Navigator Lists & Saved Searches

Capabilities:

  • Export to JSON or CSV
  • List management
  • Rate limiting (3000/day Sales Nav, 50/day LinkedIn)
  • Demo mode for testing

🛠 Technology Stack

  • Build: Create React App (Webpack 5)
  • Language: JavaScript (ES6+)
  • UI: React 18.3+ with TailwindCSS
  • State: React Query
  • Font: Poppins (Google Fonts)

📦 Prerequisites

  • Node.js >= 16.0.0
  • npm >= 8.0.0
  • Google Chrome

🚀 Installation

Developers

# Clone repository
git clone https://github.com/patrice012/linkedin-ext-scraper.git
cd linkedin-ext-scraper

# Install dependencies
npm install

# Configure environment
cp .env.example .env
# Edit .env:
# REACT_APP_API_URL=https://your-api-url.com
# REACT_APP_DEMO_MODE=true

# Build extension
npm run build

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

End Users

# Download from releases
# https://github.com/patrice012/linkedin-ext-scraper/releases

# Extract and load
unzip linkedin-ext-v1.0.0.zip -d linkedin-extension

# Load in Chrome (chrome://extensions/ → Load unpacked)

⚙️ Configuration

Environment Variables

Create .env file:

REACT_APP_API_URL=https://your-api-url.com
REACT_APP_DEMO_MODE=true
REACT_APP_SALES_NAV_LIMIT=3000
REACT_APP_LINKEDIN_LIMIT=50

💻 Development

Commands

npm start      # React dev server (UI only, port 3000)
npm run build  # Build production extension
npm test       # Run tests

Project Structure

linkedin-ext-scraper/
├── public/
│   ├── manifest.json       # Extension manifest
│   ├── background.js       # Service worker
│   └── app/scraping/       # 11 scraper scripts
├── src/
│   ├── pages/ItemList/     # Main dashboard
│   ├── components/         # UI components
│   └── utils/              # API helpers
└── .env                    # Configuration

🌐 Supported URLs

LinkedIn

  • linkedin.com/in/[username]
  • linkedin.com/company/[name]
  • linkedin.com/search/results/people
  • linkedin.com/search/results/companies

Sales Navigator

  • linkedin.com/sales/lead/[id]
  • linkedin.com/sales/company/[id]
  • linkedin.com/sales/search/people
  • linkedin.com/sales/search/company
  • linkedin.com/sales/lists/people
  • linkedin.com/sales/accounts/dashboard
  • linkedin.com/sales/search/*?savedSearchId=*

🔄 Migration to v2.0

Why Migrate?

Feature v1.0 v2.0
Language JavaScript TypeScript ✅
Framework CRA Plasmo ✅
Build Time ~30s ~5s ✅
Bundle Size ~2.5MB ~1.2MB ✅
Hot Reload
Modern UI Basic shadcn/ui ✅

Migration Steps

  1. Review v2.0: Visit Prospecty-LinkedIn
  2. Clone v2.0: git clone https://github.com/patrice012/Prospecty-LinkedIn.git
  3. Migrate custom scrapers: Copy from public/app/scraping/ to scripts/
  4. Update env vars: Rename REACT_APP_* to PLASMO_PUBLIC_*
  5. Test thoroughly: Build and verify data accuracy

🐛 Troubleshooting

Build Fails

rm -rf node_modules/ build/
npm install
npm run build

Extension Not Loading

  1. Check build/manifest.json exists
  2. Verify files in build/ directory
  3. Check Chrome console for errors
  4. Reload extension

Scraping Issues

  1. Verify you're on supported LinkedIn URL
  2. Check rate limits in popup
  3. Open DevTools Console (F12)
  4. Check if LinkedIn changed HTML structure

🤝 Contributing

⚠️ Note: This version is in maintenance mode. New features go to v2.0.

Bug fixes:

  1. Fork: https://github.com/patrice012/linkedin-ext-scraper
  2. Create branch: git checkout -b fix/bug-name
  3. Make changes and test
  4. Commit: git commit -m "Fix: Description"
  5. Create Pull Request

🔒 Privacy

For educational purposes only. Respect LinkedIn's Terms of Service.

Important:

  • ⚠️ Use at your own risk
  • ⚠️ LinkedIn prohibits automated scraping
  • ⚠️ Only for legitimate business purposes
  • ⚠️ Respect rate limits and privacy

📄 License

MIT License

Copyright (c) 2024 Prospecty Team


🔗 Links


🙏 Acknowledgments


Consider migrating to Prospecty v2.0

⬆ Back to Top

About

Chrome extension for extracting data from LinkedIn and Sales Navigator. Built with React and Create React App.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages