.. _usage-examples:

Usage examples
==============

You can use Maigret as:

- a command line tool: initial and a default mode
- a `web interface <#web-interface>`_: view the graph with results and download all report formats on a single page
- a library: integrate Maigret into your own project

Use Cases
---------


1. Search for accounts with username ``machine42`` on top 500 sites (by default, according to Majestic Million rank) from the Maigret DB.

.. code-block:: console

  maigret machine42

2. Search for accounts with username ``machine42`` on **all sites** from the Maigret DB.

.. code-block:: console

  maigret machine42 -a

.. note::
   Maigret will search for accounts on a huge number of sites,
   and some of them may return false positive results. At the moment, we are working on autorepair mode to deliver 
   the most accurate results. 
   
   If you experience many false positives, you can do the following:

   - Install the last development version of Maigret from GitHub
   - Run Maigret with ``--self-check --auto-disable`` flag and agree on disabling of problematic sites

3. Search for accounts with username ``machine42`` and generate HTML and PDF reports.

.. code-block:: console

  maigret machine42 -HP

or

.. code-block:: console

  maigret machine42 -a --html --pdf


4. Search for accounts with username ``machine42`` on Facebook only.

.. code-block:: console

  maigret machine42 --site Facebook

5. Extract information from the Steam page by URL and start a search for accounts with found username ``machine42``.

.. code-block:: console

  maigret --parse https://steamcommunity.com/profiles/76561199113454789 

6. Search for accounts with username ``machine42`` only on US and Japanese sites.

.. code-block:: console

  maigret machine42 --tags us,jp

7. Search for accounts with username ``machine42`` only on sites related to software development.

.. code-block:: console

  maigret machine42 --tags coding

8. Search for accounts with username ``machine42`` on uCoz sites only (mostly CIS countries).

.. code-block:: console

  maigret machine42 --tags ucoz

