3bm / facebook

facebook.tracking.exposed - see, investigate, share your filter bubble

Facebook.Tracking.Exposed

https://facebook.tracking.exposed

Install and run locally

Note: you need to have mongodb on your machine in order to run the full project. If mongodb isn't active, the software will quit with an error at the first usage.

• Install project dependencies

$ sudo apt-get install mongodb
$ npm install
$ npm run build
$ npm run watch

At this point you should able to find your local version on your localhost address (port 8000).

Import the node data

Your server is empty, if you need mirror some data, import the few collected so far:

$ DEBUG=* source='https://facebook.tracking.exposed' operations/importer.js

Docker support

First, you need to install a mongodb docker image and run it as the basic dataset of your installation:

$ docker run -d --name mongo mongo

note: this container will maintain the dataset on your local machine, in order to restore it you have to simply start the container:

$ docker start mongo

If you need to start the node with an empty dataset, run:

$ docker run -d --name fbtrex -p 8000:8000 --link mongo:mongo fbtrex/fbtrex-app npm run watch

note: if the image is not present in your local docker registry will be automatic pulled from the docker hub.

Or if you need your instance filled with and synced with the main node, run:

$ docker run -d --name fbtrex -p 8000:8000 --link mongo:mongo fbtrex/fbtrex-app /bin/bash -c "DEBUG=* source='https://facebook.tracking.exposed' operations/importer.js && npm run watch"

If you want to build on your own the image:

$ docker build -t fbtrex .

UserScript

If you want debug, develop or investigate on the userScript, you've to add the line with 'localhost', because TamperMonkey don't permit arbitrary connections, you've to declare the connected hosts. This is in the header of the UserScrpt

// @connect      facebook.tracking.exposed
// @connect      localhost

Below in the code, change the line:

url = 'https://facebook.tracking.exposed',

To:

url = 'http://localhost:8000',

API

The API currently are undocumented, but the best way to seem them run is with the command:

$ DEBUG=* url='https://localhost:8000' operations/tryAPI.js