A Python crawler for extensions from the Chrome Web Store.
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Achim D. Brucker d8d2e41dc6 Merge branch 'master' of logicalhacking.com:BrowserSecurity/ExtensionCrawler 4 months ago
ExtensionCrawler Use ast parser to parse ETag, also in db.py. 4 months ago
PermissionAnalysis Don't crash on invalid categories. 4 months ago
analysis/library-detector Improved plotting for angular. 8 months ago
database Added database documentation. 1 year ago
resources Updated regexps. 2 years ago
scripts Various bug fixes. 4 months ago
sge Added option to handle more than one extension per sharc job. 4 months ago
.gitignore Added pycharm folders to gitignore. 4 months ago
LICENSE initial commit 3 years ago
README.md Updated python version. 7 months ago
cdnjs-git-miner Update to Python 3.7. 7 months ago
crawler Store log in montly directory and replace : by _ in names of log files. 7 months ago
create-db Switched to python 3.7. 7 months ago
crx-extract Using python 3.7. 8 months ago
crx-jsinventory Moved to Python 3.7. 8 months ago
crx-jsstrings Moved to Python 3.7. 8 months ago
crx-tool Using python 3.7. 8 months ago
extgrep Use ast parser to parse ETag. 4 months ago
requirements.txt Increased requests version (dependency). 10 months ago
setup.py Fixed style errors and warnings. 1 year ago
simhashbucket Switched to python 3.7. 7 months ago



A collection of utilities for downloading and analyzing browser extension from the Chrome Web store.

  • crawler: A crawler for extensions from the Chrome Web Store.
  • crx-tool: A tool for analyzing and extracting *.crx files (i.e., Chrome extensions). Calling crx-tool.py <extension>.crx will check the integrity of the extension.
  • crx-extract: A simple tool for extracting *.crx files from the tar-based archive hierarchy.
  • crx-jsinventory: Build a JavaScript inventory of a *.crx file using a JavaScript decomposition analysis.
  • crx-jsstrings: A tool for extracting code blocks, comment blocks, and string literals from JavaScript.
  • create-db: A tool for updating a remote MariaDB from already existing extension archives.

The utilities store the extensions in the following directory hierarchy:

   ├── conf
   │   └── forums.conf
   ├── data
   │   └── ...
   └── log
       └── ...

The crawler downloads the most recent extension (i.e., the *.crx file as well as the overview page. In addition, the conf directory may contain one file, called forums.conf that lists the ids of extensions for which the forums and support pages should be downloaded as well. The data directory will contain the downloaded extensions.

The crawler and create-db scripts will access and update a MariaDB. They will use the host, datebase, and credentials found in ~/.my.cnf. Since they make use of various JSON features, it is recommended to use at least version 10.2.8 of MariaDB.

All utilities are written in Python 3.7. The required modules are listed in the file requirements.txt.


Clone and use pip3 to install as a package.

git clone git@logicalhacking.com:BrowserSecurity/ExtensionCrawler.git
pip3 install --user -e ExtensionCrawler



  • Mehmet Balande


This project is licensed under the GPL 3.0 (or any later version).

SPDX-License-Identifier: GPL-3.0-or-later

Master Repository

The master git repository for this project is hosted by the Software Assurance & Security Research Team at https://git.logicalhacking.com/BrowserSecurity/ExtensionCrawler.