diff --git a/README.md b/README.md
index 3868efb..c7b49db 100644
--- a/README.md
+++ b/README.md
@@ -1,4 +1,39 @@
 # Free Telegram Finder
 
-Асинхронный Python-скрипт, созданный в рамках бесплатной разработки на форуме Lolz.live для [g](https://telegram.me/ferrruchi); он сканирует страницы с
-  анкетами, извлекает Telegram-ссылки, проверяет свободные юзернеймы и сохраняет найденные результаты в текстовый файл.
\ No newline at end of file
+Небольшой асинхронный Python-скрипт для поиска свободных Telegram-юзернеймов.
+
+Скрипт:
+
+- обходит страницы каталога;
+- собирает ссылки на анкеты;
+- достает Telegram из каждой анкеты;
+- проверяет, свободен ли username;
+- сохраняет найденное в `free_telegram.txt`.
+
+## Запуск
+
+```bash
+pip install -r requirements.txt
+python main.py
+```
+
+## Настройки
+
+Основные параметры лежат в `config.py`:
+
+- город и целевой каталог;
+- размер страницы;
+- количество одновременных запросов;
+- паузы и повторы при проверке Telegram.
+
+## Результат
+
+Все найденные совпадения записываются в `free_telegram.txt` в формате:
+
+```text
+https://site/profile - username
+```
+
+## Примечание
+
+Скрипт завязан на текущую верстку сайта и поведение `t.me`, поэтому при изменениях на стороне сайта или Telegram может потребоваться правка парсинга.