Browser History Analysis Toolkit

A comprehensive collection of Python tools for analyzing browser history from Chromium-based browsers (Chrome and Brave). Extract URLs, page titles, visit dates, and browsing duration with advanced analytics and export capabilities.

📋 Project Overview

This toolkit provides powerful Python scripts for browser history analysis, digital forensics, and web analytics. Perfect for researchers, developers, and analysts who need to extract and analyze browsing data from Chrome and Brave browsers.

Keywords: Browser history analysis, Chrome Brave history tools, Python browser analytics, web data extraction, browser forensics, digital investigation tools, web usage analytics, browser data mining, Python development tools, cross-browser analysis, web history parser, browser comparison tools, Chromium-based browser tools

Hashtags: #BrowserHistory #BrowserAnalytics #PythonTools #WebAnalytics #DataExtraction #BrowserForensics #ChromeBrave #WebHistory #PythonScripts #BrowserAnalysis #ChromeTools #BraveTools #DataMining #WebUsage #BrowserComparison #PythonDevelopment #WebScraping #BrowserData #DataAnalysis #DigitalForensics #WebSecurity #ChromiumAnalysis #BrowserForensics #PythonAutomation #WebAnalytics #BrowserHistoryAnalysis #CrossBrowser #BrowserDetection #PrivacyTools #WebHistoryParser

🛠️ Tools Included

1. Chrome History Analyzer

• File: chrome_history_analyzer.py
• Purpose: Chrome-specific browser history analysis
• Features: URL extraction, titles, dates, duration, domain statistics
• Export: JSON and CSV formats

2. Brave History Analyzer

• File: brave_history_analyzer.py
• Purpose: Brave browser history analysis with enhanced privacy features
• Features: All Chrome features plus HTTP/HTTPS security analysis
• Export: JSON and CSV formats

3. Universal Browser Analyzer

• File: browser_history_analyzer.py
• Purpose: Multi-browser analysis with automatic detection
• Features: Works with both Chrome and Brave, auto-detection
• Export: JSON and CSV formats

4. Example Scripts

• File: example_usage.py - Chrome usage examples
• File: example_brave_usage.py - Brave usage examples

🚀 Quick Start

Universal Tool (Recommended)

# Auto-detect and analyze available browsers
python browser_history_analyzer.py --json --csv

# Specify browser
python browser_history_analyzer.py --browser chrome --json
python browser_history_analyzer.py --browser brave --csv

Individual Tools

# Chrome analysis
python chrome_history_analyzer.py --json --csv

# Brave analysis  
python brave_history_analyzer.py --json --csv

📊 Key Features

• 🔍 Multi-Browser Support: Chrome and Brave compatibility
• 🤖 Auto-Detection: Automatically finds available browsers
• 📊 Comprehensive Analytics: URLs, titles, dates, duration, domains
• 🔒 Security Analysis: HTTP/HTTPS statistics (Brave)
• 💾 Flexible Export: JSON and CSV formats
• ⏱️ Time Filtering: Filter by days or record count
• 🖥️ Cross-Platform: Windows, macOS, Linux support
• ⚡ Performance: Fast processing with auto-cleanup

📈 Use Cases

Web Analytics

• Analyze browsing patterns and behavior
• Track website usage and preferences
• Monitor online activity trends

Digital Forensics

• Browser history analysis for investigations
• Digital evidence collection
• Forensic data extraction

Research & Development

• User behavior studies
• Web usage research
• Browser comparison analysis

Data Science

• Web analytics datasets
• User behavior modeling
• Traffic pattern analysis

🔒 Privacy & Security

• Local Processing: All analysis done locally
• No Data Transmission: No data sent to external servers
• Temporary Files: Automatically cleaned up
• User Control: Full control over data export
• Compliance: Respects privacy regulations

📖 Documentation

• Chrome History Analyzer - Chrome-specific documentation
• Brave History Analyzer - Brave-specific documentation
• Universal Browser Analyzer - Comprehensive guide

⚠️ Important Notes

1. Close Browsers: Ensure browsers are closed before running scripts
2. File Locking: Browsers lock history files when running
3. Auto-Cleanup: Temporary files are automatically removed
4. Privacy: Respect user privacy and data protection laws
5. Permissions: May require appropriate file system permissions

🤝 Contributing

Contributions are welcome! Please feel free to submit pull requests or open issues for:

• Bug fixes and improvements
• Feature enhancements
• Documentation updates
• Additional browser support

📄 License

This project is provided "as is" for educational and research purposes. Users are responsible for complying with applicable laws and regulations regarding data privacy and browser usage.

---

Tags: #BrowserHistory #BrowserAnalytics #PythonTools #WebAnalytics #DataExtraction #BrowserForensics #ChromeBrave #WebHistory #PythonScripts #BrowserAnalysis #ChromeTools #BraveTools #DataMining #WebUsage #BrowserComparison #PythonDevelopment #WebScraping #BrowserData #DataAnalysis #DigitalForensics #WebSecurity #ChromiumAnalysis #BrowserForensics #PythonAutomation #WebAnalytics #BrowserHistoryAnalysis #CrossBrowser #BrowserDetection #PrivacyTools #WebHistoryParser

---

Chrome History Analyzer

Python скрипт для анализа истории браузера Chrome. Извлекает ссылки, названия страниц и даты посещения.

📋 Description

A powerful Python tool for analyzing Google Chrome browser history. Extract URLs, page titles, visit dates, and browsing duration with comprehensive analytics and export capabilities.

Keywords: Chrome history analyzer, browser data extraction, web analytics, Python browser tools, Chrome SQLite analysis, browsing statistics, web history parser, Chrome data mining, browser forensics, web usage analytics

Hashtags: #ChromeHistory #BrowserAnalytics #PythonTools #WebAnalytics #DataExtraction #BrowserForensics #ChromeData #WebHistory #PythonScripts #BrowserAnalysis #ChromeTools #DataMining #WebUsage #BrowserHistory #ChromeAnalytics #PythonDevelopment #WebScraping #BrowserData #ChromeParser #DataAnalysis

Возможности

• 📊 Анализ истории посещений Chrome
• 🔗 Извлечение URL, названий и дат
• ⏱️ Подсчет времени, проведенного на сайтах
• 📈 Статистика по доменам
• 💾 Экспорт в JSON и CSV форматы
• 🔍 Фильтрация по времени и количеству записей

Требования

• Python 3.6+
• Google Chrome (установленный браузер)
• Стандартные библиотеки Python (sqlite3, json, csv, datetime, argparse)

Установка

1. Скачайте файл chrome_history_analyzer.py
2. Убедитесь, что у вас установлен Python 3.6 или выше
3. Закройте все окна Chrome перед запуском скрипта

Использование

Базовый запуск

python chrome_history_analyzer.py

С ограничением количества записей

python chrome_history_analyzer.py --limit 100

Анализ только последних 7 дней

python chrome_history_analyzer.py --days 7

Сохранение в JSON файл

python chrome_history_analyzer.py --json

Сохранение в CSV файл

python chrome_history_analyzer.py --csv

Сохранение в оба формата с кастомным именем

python chrome_history_analyzer.py --json --csv --output my_history

Комбинированные опции

python chrome_history_analyzer.py --limit 500 --days 30 --json --csv

Параметры командной строки

• --limit N - Ограничить количество записей до N
• --days N - Анализировать только последние N дней
• --json - Сохранить результаты в JSON файл
• --csv - Сохранить результаты в CSV файл
• --output PREFIX - Указать префикс для выходных файлов

Выходные данные

Консольный вывод

Скрипт выводит:

• Общую статистику (количество записей, доменов)
• Топ-5 посещаемых доменов
• Временной диапазон посещений
• Общее время на сайтах
• Первые 10 записей истории

JSON файл

Содержит массив объектов с полями:

• url - URL страницы
• title - Название страницы
• visit_count - Количество посещений
• last_visit - Время последнего посещения
• visit_time - Время посещения
• duration_seconds - Длительность в секундах
• duration_formatted - Длительность в читаемом формате

CSV файл

Таблица с теми же полями, что и в JSON.

Примеры использования

Анализ последней недели

python chrome_history_analyzer.py --days 7 --json

Экспорт топ-100 посещений

python chrome_history_analyzer.py --limit 100 --csv --output recent_visits

Полный анализ с экспортом

python chrome_history_analyzer.py --json --csv --output full_analysis

Важные замечания

1. Закройте Chrome перед запуском скрипта, иначе файл истории будет заблокирован
2. Скрипт автоматически определяет путь к истории Chrome для Windows, macOS и Linux
3. Временные файлы автоматически удаляются после анализа
4. Если история не найдена, проверьте, что Chrome установлен и используется

Поддерживаемые операционные системы

• Windows
• macOS
• Linux

Структура файлов Chrome

Скрипт автоматически находит файл истории по следующим путям:

• Windows: %LOCALAPPDATA%\Google\Chrome\User Data\Default\History
• macOS: ~/Library/Application Support/Google/Chrome/Default/History
• Linux: ~/.config/google-chrome/Default/History

Устранение неполадок

Ошибка "Файл истории Chrome не найден"

• Убедитесь, что Chrome установлен
• Проверьте, что вы используете Chrome (не Chromium или другой браузер)
• Убедитесь, что Chrome был запущен хотя бы раз

Ошибка "database is locked"

• Закройте все окна Chrome
• Подождите несколько секунд и попробуйте снова

Пустая история

• Убедитесь, что в Chrome есть история посещений
• Проверьте, что история не была очищена

Лицензия

Этот скрипт предоставляется "как есть" для образовательных целей.