https://github.com/digitalmethodsinitiative/zoekplaatje
Zoekplaatje is a Firefox extension to facilitate the capture of search engine results.
https://github.com/digitalmethodsinitiative/zoekplaatje
Last synced: 5 months ago
JSON representation
Zoekplaatje is a Firefox extension to facilitate the capture of search engine results.
- Host: GitHub
- URL: https://github.com/digitalmethodsinitiative/zoekplaatje
- Owner: digitalmethodsinitiative
- License: other
- Created: 2023-09-18T16:04:52.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2025-09-15T13:06:52.000Z (9 months ago)
- Last Synced: 2025-09-15T14:46:55.055Z (9 months ago)
- Language: JavaScript
- Size: 3.1 MB
- Stars: 9
- Watchers: 4
- Forks: 1
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE
- Zenodo: .zenodo.json
Awesome Lists containing this project
README
# 🕵️ Zoekplaatje
[](https://doi.org/10.5281/zenodo.8356391)
[](https://github.com/digitalmethodsinitiative/zoekplaatje/blob/main/LICENSE)
Zoekplaatje is a browser extension that monitors search results as you see them in your browser and allows you to later
download them as a .CSV spreadsheet. It is intended to facilitate systematic analysis of search results, e.g. for
(algorithmic) bias.
Currently, it supports the following search engines:
* [Baidu](https://baidu.com)
* [Bing](https://www.bing.com)
* [DuckDuckGo](https://duckduckgo.com) (organic results only)
* [Google](https://www.google.com)
* [Najdi.si](https://najdi.si)
* [Seznam](https://seznam.cz)
* [Yandex](https://yandex.com)
Engine support requires regular maintenance to keep up with changes to the engines. If something does not work, we
welcome issues and pull requests.
The extension does not interfere with your normal browsing and never uploads data. It uses the
[WebRequest](https://developer.mozilla.org/en-US/docs/Mozilla/Add-ons/WebExtensions/API/webRequest) browser API to
locally collect and parse the data search engines are sending to your browser as you use it.
## Installation
Zoekplaatje is in active development. .xpi files that you can use to install it in your browser are available on the
[releases](https://github.com/digitalmethodsinitiative/zoekplaatje/releases) page. These are signed and can be installed
in any Firefox-based browser. If you want to run the latest development version instead, you can [do so from the Firefox
debugging console](https://www.youtube.com/watch?v=J7el77F1ckg) after cloning the repository locally.
## How to use
Install the browser extension in a Firefox browser. A button with the Zoekplaatje logo (a silhouette) will appear in the
browser toolbar. Click it to open the Zoekplaatje interface. Enable capturing for the search engines you want to
capture from.
Next, simply search for things as you normally would. While Zoekplaatje is enabled, results will be saved in the
background. You can then download the results as a .csv file with the button in the interface when you are done and
want to inspect the results. Make sure to cross-reference the results with what you see in your browser, at least
initially, to understand what data is (and is not!) collected and how it is parsed.
## Credits & license
Zoekplaatje was developed by Stijn Peeters for the [Digital Methods Initiative](https://digitalmethods.net) and is
licensed under the Mozilla Public License, 2.0. Refer to the LICENSE file for more information. It is heavily based on
[Zeeschuimer](https://github.com/digitalmethodsinitiative/zeeschuimer/).
Graphics based on [an image generated by Dall-E](https://labs.openai.com/s/vrkwH6n7rLErCBsKKhIcPzT6), for the prompt
'detail of a 1914 metaphysical painting by giorgio de chirico depicting a hard-boiled detective writing down results in
a notebook'. Interface background pattern by [Travis Beckham](https://travisbeckham.com/). Interface icons by
[Font Awesome](https://fontawesome.com/license/free). [Open Sans](https://fonts.google.com/specimen/Open+Sans) and
[Permanent Marker](https://fonts.google.com/specimen/Permanent+Marker) fonts from Google Fonts.
Development is supported by the Dutch [PDI-SSH](https://pdi-ssh.nl/en/) foundation through the [CAT4SMR
project](https://cat4smr.humanities.uva.nl/).