Skip to content

A tool for recording lists of external resources (JS trackers etc.) loaded when opening given websites

License

Notifications You must be signed in to change notification settings

mackuba/TrackerScanner

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

24 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Tracker Scanner

I wrote this tool for myself, but maybe someone else will find it useful.

The tool (in the form of an iOS app, because that was the easiest way to get it to work) uses a hidden WebKit WKWebView to load a list of URLs one by one and records all external resources loaded by a given website. The main goal is to find lesser known ad/tracker services that should be blocked in Safari using a content blocker.

Usage

  1. Create a page_list.txt file listing URLs to load, one on each line.
  2. Create a blocklist.json file (could be empty).
  3. Run the project in Xcode in an iPhone simulator.
  4. Wait for the app to finish running, and find the results.json file in the location mentioned at the beginning of the log.

If you want, you can provide a WebKit content blocker blocklist and only record resources that haven't been caught by the blocklist - in this case, switch the useBlocklist property in ViewController to true.

The Scripts directory contains some scripts in Ruby that can help you extract some statistics from results files.

Credits

Copyright © 2020 Kuba Suder. Licensed under WTFPL License.

The NSURLProtocol+WKWebViewSupport helper was created by Yeatse and is available under MIT license.

About

A tool for recording lists of external resources (JS trackers etc.) loaded when opening given websites

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published