cloudshell-tutorial.md
Maigret collects a dossier on a person by username only, checking for accounts on a huge number of sites and gathering all the available information from web pages. No API keys required.
Google Cloud Shell does not ship with all the system libraries Maigret needs (libcairo2-dev, pkg-config). The helper script below installs them and then builds Maigret from the cloned source.
Copy the command and run it in the Cloud Shell terminal:
./utils/cloudshell_install.sh
When the script finishes, verify the install:
maigret --version
Run a basic search for a username. By default Maigret checks the 500 highest-ranked sites by traffic — pass -a to scan the full 3,000+ database.
maigret soxoj
Search several usernames at once:
maigret user1 user2 user3
Narrow the run to sites related to cryptocurrency via the crypto tag (you can also use country tags):
maigret vitalik.eth --tags crypto
Generate reports in HTML, PDF, and XMind 8 formats:
maigret soxoj --html
maigret soxoj --pdf
maigret soxoj --xmind
Download a generated report from Cloud Shell to your local machine:
cloudshell download reports/report_soxoj.pdf
Tune reliability on flaky networks — raise the timeout and retry failed checks:
maigret soxoj --timeout 60 --retries 2
For the full list of options see maigret --help or the CLI documentation.
Full project documentation: maigret.readthedocs.io