diff --git a/README.md b/README.md
new file mode 100644
index 0000000..d5a94da
--- /dev/null
+++ b/README.md
@@ -0,0 +1,35 @@
+# КлассПакета Скрейпер
+
+Скрипт для извлечения переменных `КлассПакета_*` из файлов 1C-проекта и формирования Markdown-таблицы.
+
+## Описание
+
+Рекурсивно сканирует указанную директорию, находит строки вида:
+
+```
+КлассПакета_Номенклатура = 3;
+КлассПакета_Контрагент = 5;
+```
+
+И выводит результат в Markdown-таблицу с колонками:
+- **КлассПакета** — имя переменной
+- **Значение** — числовое значение
+- **Присваивание** — исходная строка кода
+
+## Использование
+
+```
+python scraper.py "путь/к/директории" -o "путь/к/файлу.md"
+```
+
+### Пример
+
+```
+python scraper.py C:\path\to\project -o result.md
+```
+
+## Особенности
+
+- Дедупликация: при повторных вхождениях переменной используется первое значение
+- Сортировка по алфавиту
+- Игнорируются бинарные файлы и файлы с ошибками кодировки