Usernames

maigretusername1username2...

You can specify several usernames separated by space. Usernames arenot mandatory as there are other operations modes (see below).

Parsing of account pages and online documents

maigret--parseURL

Maigret will try to extract information about the document/account owner(including username and other ids) and will make a search by theextracted username and ids. See examples in theExtraction of information from account pages section.

Main options

Options are also configurable through settings files, seesettings section.

--tags - Filter sites for searching by tags: sites categories andtwo-letter country codes (not a language!). E.g. photo, dating, sport; jp, us, global.Multiple tags can be associated with one site.Warning: tags markup isnot stable now. Read morein the separate section.

-n,--max-connections - Allowed number of concurrent connections(default: 100).

-a,--all-sites - Use all sites for scan(default: top 500).

--top-sites - Count of sites for scan ranked by Alexa Top(default: top 500).

--timeout - Time (in seconds) to wait for responses from sites(default: 30). A longer timeout will be more likely to get resultsfrom slow sites. On the other hand, this may cause a long delay togather all results. The choice of the right timeout should be carriedout taking into account the bandwidth of the Internet connection.

--cookies-jar-file - File with custom cookies in Netscape format(aka cookies.txt). You can install an extension to your browser todownload own cookies (Chrome,Firefox).

--no-recursion - Disable parsing pages for other usernames andrecursive search by them.

--use-disabled-sites - Use disabled sites to search (may cause manyfalse positives).

--id-type - Specify identifier(s) type (default: username).Supported types: gaia_id, vk_id, yandex_public_id, ok_id, wikimapia_uid.Currently, you must add-a flag to run a scan on sites with customid types, sites will be filtered automatically.

--ignore-ids - Do not make search by the specified username or otherids. Useful for repeated scanning with found known irrelevant usernames.

--db - Load Maigret database from a JSON file or an online, valid,JSON file.

--retriesRETRIES - Count of attempts to restart temporarily failedrequests.

Reports

-P,--pdf - Generate a PDF report (general report on allusernames).

-H,--html - Generate an HTML report file (general report on allusernames).

-X,--xmind - Generate an XMind 8 mindmap (one report perusername).

-C,--csv - Generate a CSV report (one report per username).

-T,--txt - Generate a TXT report (one report per username).

-J,--json - Generate a JSON report of specific type: simple,ndjson (one report per username). E.g.--jsonndjson

-fo,--folderoutput - Results will be saved to this folder,results by default. Will be created if doesn’t exist.

Output options

-v,--verbose - Display extra information and metrics.(loglevel=WARNING)

-vv,--info - Display service information.(loglevel=INFO)

-vvv,--debug,-d - Display debugging information and siteresponses.(loglevel=DEBUG)

--print-not-found - Print sites where the username was not found.

--print-errors - Print errors messages: connection, captcha, sitecountry ban, etc.

Other operations modes

--version - Display version information and dependencies.

--self-check - Do self-checking for sites and database and disablenon-working onesfor current search session by default. It’s usefulfor testing new internet connection (it depends on provider/hosting onwhich sites there will be censorship stub or captcha display). Afterchecking Maigret asks if you want to save updates, answering y/Y willrewrite the local database.

--submitURL - Do an automatic analysis of the given account URL orsite main page URL to determine the site engine and methods to checkaccount presence. After checking Maigret asks if you want to add thesite, answering y/Y will rewrite the local database.