diff --git a/README.md b/README.md
new file mode 100644
index 0000000..1b0c036
--- /dev/null
+++ b/README.md
@@ -0,0 +1,18 @@
+# blocklist
+
+Пакет Go для получения списков плохих IP адресов от разных сервисов.
+
+## Установка
+```sh
+go get git.kor-elf.net/kor-elf-shield/blocklist
+```
+
+## Примеры использования
+- [Пример получения списка IP адресов от Spamhaus](/examples/spamhaus.go)
+- [Пример получения списка IP адресов от DShield](/examples/dshield.go)
+- [Пример получения списка IP адресов от honeypot](/examples/honeypot.go)
+- [Пример получения списка IP адресов от Tor](/examples/tor.go)
+
+## Лицензия
+
+[MIT](https://git.kor-elf.net/kor-elf-shield/blocklist/src/branch/main/LICENSE)
\ No newline at end of file