doing applied fediverse research
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.

46 lines
2.0 KiB

# doing applied fediverse research
5 years ago
* hands-on approach to verify statistics on fediverse from fediverse.network and the-federation.info
* draws conclusions from that
## Methods
5 years ago
### Mapping the network
`fedicrawler.py` is a utility to map the Fediverse and save that data as a json file.
5 years ago
Currently the script starts from <https://post.lurk.org> and queries `/api/v1/instance/peers` to find servers it is peering with. For each of the peering servers it hasn't seen before it does the same. This from the assumption that getting peer lists from Mastodon & Pleroma gives enough of a view of 'known fediverse' to work with.
5 years ago
> initial peer list
>> all peers of the initial peers
>>> all peers of the peers of the inintial peers
5 years ago
5 years ago
------------------------------------------------- +
the known fediverse?
#### Instance metadata
5 years ago
We try to query `/.well-known/nodeinfo` for instance meta-data such as software type etc. This is what both fediverse.network and the-federation.info do
When any request fails on a given instance it logs the raised `Exception`, if it is a HTTP error instead we currently log the answer.
Latest scrape results can be found in `instance_scrape.json`
### Gathering of ToS/CoC
`about_collector.py` is a utility to collect and document the `about/more/` pages of Mastodon instances found in `instance_scrape.json` data. It will collect three things per instance found: a screenshot of the page, the HTML of the page, and a separate file with the html containing the server description which usually also contains a ToS/CoC. The script makes a rough sorting based on whether an instance has any instance info at all.
You will find the collected results in `about_pages` and `about_pages/with_tos`.
This script requires `selenium` and the `gecko` web driver. See the [selenium documentation](https://selenium-python.readthedocs.io/installation.html) for more information.
## TODO FIXME
* multithread the screenshotting
5 years ago
* ~~add detailed error message to json when we get one~~
* ~~abstract the functions so we can multithread them~~