linkedin-analyzer 0.6.0

Clean and export LinkedIn CSV data exports to Excel

LinkedIn Analyzer

Clean and analyze your LinkedIn data exports.
_{Web app or Python CLI. File contents stay local in the web app; optional diagnostics are opt-in.}

What it does

LinkedIn's data exports are messy. This tool fixes that.

• Shares.csv has weird nested quote escaping
• Comments.csv has backslash-escaped quotes
• messages.csv has mixed participant/profile fields that need normalization
• Connections.csv often includes preamble rows and noisy identity fields

Upload your files, get clean Excel outputs. Plus analytics dashboards, relationship views from messages/connections, and rule-based insights.

Quick start

Development: Install locked Python and Node dependencies:

# Requires Python 3.11+, uv, and Node.js 22.13.x or 24+
make setup

Web: Run the Vite dev server and open the local URL:

cp .env.example .env  # optional; set VITE_SENTRY_DSN + VITE_APP_RELEASE for opt-in diagnostics
make web

CLI: For automation:

pip install linkedin-analyzer
linkedin-analyzer shares
linkedin-analyzer comments
linkedin-analyzer messages
linkedin-analyzer connections
linkedin-analyzer all

Container: Run the published CLI image:

docker run --rm -v "$PWD/data:/app/data" ghcr.io/hermione-granger-1176/linkedin-analyzer:latest --version

Tech stack

Web app

Python CLI

Dev & CI

Features

Feature	Detail
100% client-side	File contents stay local in your browser
Local restore	Raw CSV data may be saved in browser storage until cleared
Light/dark theme	Hand-drawn sketch aesthetic
Guided tutorials	Per-page tutorials
Analytics	Timeline, topics, heatmap
Messages view	Top contacts, silent connections, fading chats
SPA routing	Hash routes with URL-synced filters
Excel export	Formatted .xlsx with proper columns
Connections	Network growth, top companies, top positions
Chart export	Download any chart as PNG
PWA-ready	Installable with auto-refreshing service worker caching
Session cleanup	Stale uploads and cached analytics cleared asynchronously
Social previews	Open Graph and Twitter Card meta tags
Type-safe CLI	Strict mypy, high test coverage (100% threshold)

Documentation

See the docs/ folder for:

• Web App Guide
• Python CLI Reference
• Development Setup
• Project Structure
• Style Guide
• Operations and Deployment

Architecture Decision Records: docs/adr/

Contributor guide: .github/CONTRIBUTING.md

Changelog (Python package): CHANGELOG.md

Security reporting guidelines: .github/SECURITY.md

License

MIT

---

_{Created by Aditya Kumar Darak}