A Python crawler for extensions from the Chrome Web Store.
Go to file
Achim D. Brucker c90bfb5fbb Added support for xz compressed archives. 2018-11-10 20:48:00 +00:00
ExtensionCrawler Fixed double-logging when not using forkserver. 2018-09-02 11:46:27 +01:00
bench Added md5 db benchmark. 2018-07-12 13:35:09 +01:00
database Added database documentation. 2018-08-09 14:20:01 +01:00
resources Updated regexps. 2017-09-01 22:26:30 +01:00
scripts Removed reporting of WorkerExceptions. 2018-11-10 16:50:13 +00:00
sge Restrict sharc jobs to 1 hour. 2018-08-02 16:13:25 +01:00
singularity Optimized image size. 2018-07-28 10:46:24 +01:00
.gitignore Updated image name(s). 2017-09-26 08:56:00 +01:00
LICENSE initial commit 2016-09-08 20:43:35 +02:00
README.md Added SPDX identifier. 2018-07-21 12:13:54 +01:00
cdnjs-git-miner Added SPDX identifier. 2018-09-02 10:22:56 +01:00
comparemd5 Changed way of parallelism for simhashbucket and added comparemd5. 2018-07-10 20:47:07 +01:00
crawler Added SPDX identifier. 2018-09-03 00:30:58 +01:00
create-db Added support for xz compressed archives. 2018-11-10 20:48:00 +00:00
crx-extract Added SPDX identifier. 2018-09-01 21:48:14 +01:00
crx-jsinventory Added SPDX identifier. 2018-09-02 10:25:41 +01:00
crx-jsstrings Added SPDX identifier. 2018-09-02 10:25:46 +01:00
crx-tool Added SPDX identifier. 2018-09-02 10:24:52 +01:00
extfind Fixed style errors and warnings. 2018-04-21 19:00:07 +01:00
extfind.py Updated grepper. 2017-09-27 14:05:16 +01:00
requirements.txt Increased requests version (dependency). 2018-10-29 19:28:44 +00:00
setup.py Fixed style errors and warnings. 2018-04-21 19:00:07 +01:00
simhashbucket Added MD5Table and made max simhash dist configurable. 2018-09-12 21:56:30 +01:00

README.md

ExtensionCrawler

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:

   archive
   ├── 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.6. The required modules are listed in the file requirements.txt.

Installation

Clone and use pip3 to install as a package.

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

Team

Contributors

  • Mehmet Balande

License

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.