# Socialscan — проверяем использование электронной почты и имен пользователей в соцсетях

### Что такое Socialscan <a href="#chto-takoe-socialscan" id="chto-takoe-socialscan"></a>

Если кратко: инструмент командной строки для проверки использования электронной почты и имен пользователей социальных сетей. Просто задаёте адрес почты или имя пользователя → Socialscan сообщает, доступен ли он, занят или недействителен.

### В чём особенность работы <a href="#v-chyom-osobennost-raboty" id="v-chyom-osobennost-raboty"></a>

Socialscan напрямую запрашивает регистрационные серверы платформ. А после получает соответствующие CSRF-токены, заголовки и куки.

Это отличный вариант, если учитывать, что другие инструменты получают доступность через HTTP или текст ошибки на запрашиваемой странице. Такой подход не всегда работает:

* Большинство платформ имеют набор ключевых слов, которые они не разрешают использовать в именах. Например, `admin`, `home` и `root`.
* Ещё один минус: имена пользователей удаленных или забаненных аккаунтов недоступны, даже если страницы профиля не существуют.

Из-за этих двух особенностей подобные инструменты могут давать ложные результаты.

### В чём преимущества <a href="#v-chyom-preimushestva" id="v-chyom-preimushestva"></a>

* **Точность.** Тут повторимся: метод запросов Socialscan исключает ложные срабатывания и результаты, в отличие от других сервисов.
* **Скорость**. Socialscan использует asyncio вместе с aiohttp. Это позволяет одновременно выполнять все запросы, что ускоряет работу. Для массовых запросов, где есть сотни имен и адресов — такая же история. Давайте на цифрах: на тестовом компьютере со средними характеристиками и скоростью интернета 100 запросов были выполнены за 4 секунды.
* **Библиотека /CLI.** Socialscan можно запустить через CLI или импортировать как библиотеку Python для использования в уже работающем коде.

### Как установить и использовать <a href="#kak-ustanovit-i-ispolzovat" id="kak-ustanovit-i-ispolzovat"></a>

1. **Pip**

```
> pip install socialscan
```

**2. Устанавливаем исходники**

```
> git clone https://github.com/iojw/socialscan.git  
> cd socialscan  
> pip install .
```

**3. Используем по назначению**

```
usage: socialscan [list of usernames/email addresses to check]

optional arguments:
  -h, --help            show this help message and exit
  --platforms [platform [platform ...]], -p [platform [platform ...]]
                        list of platforms to query (default: all platforms)
  --view-by {platform,query}
                        view results sorted by platform or by query (default:
                        query)
  --available-only, -a  only print usernames/email addresses that are
                        available and not in use
  --cache-tokens, -c    cache tokens for platforms requiring more than one
                        HTTP request (Snapchat, GitHub, Instagram. Lastfm &
                        Tumblr), reducing total number of requests sent
  --input input.txt, -i input.txt
                        file containg list of queries to execute
  --proxy-list proxy_list.txt
                        file containing list of HTTP proxy servers to execute
                        queries with
  --verbose, -v         show query responses as they are received
  --show-urls           display profile URLs for usernames on supported platforms
                        (profiles may not exist if usernames are reserved or belong to deleted/banned accounts)
  --json json.txt       output results in JSON format to the specified file
  --version             show program's version number and exit
```

А вот ссылочка, чтобы всё [скачать](https://github.com/iojw/socialscan).


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://notes.kraken-security.ru/kraken/krupicy-znanii/instrumenty/socialscan-proveryaem-ispolzovanie-elektronnoi-pochty-i-imen-polzovatelei-v-socsetyakh.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.