diff --git a/README.md b/README.md
index a3124fb..8e98755 100644
--- a/README.md
+++ b/README.md
@@ -1,4 +1,4 @@
-# wscraper
+<h1><img src="assets/logo.svg" alt="wscraper logo" width="34" style="vertical-align:middle; margin-right:10px;" />wscraper</h1>
 
 [![Gitea](https://img.shields.io/badge/Gitea-Repository-609926?logo=gitea&logoColor=white)](https://gitea.wisecolt-panda.net/wisecolt/Bookmark-Tracker)
 ![Python](https://img.shields.io/badge/Python-3.12%2B-3776AB?logo=python&logoColor=white)
diff --git a/assets/logo.svg b/assets/logo.svg
new file mode 100644
index 0000000..4f39c05
--- /dev/null
+++ b/assets/logo.svg
@@ -0,0 +1,16 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512" role="img" aria-labelledby="title desc">
+  <title id="title">wscraper logo monochrome</title>
+  <desc id="desc">Minimal black and white logo with stylized W and search mark.</desc>
+
+  <rect width="512" height="512" rx="108" fill="#FFFFFF"/>
+  <rect x="72" y="84" width="368" height="344" rx="44" fill="#FFFFFF" stroke="#D4D4D8" stroke-width="8"/>
+
+  <path d="M126 160 L170 352 L212 244 L254 352 L298 160" fill="none" stroke="#111111" stroke-width="28" stroke-linecap="round" stroke-linejoin="round"/>
+
+  <rect x="324" y="192" width="84" height="16" rx="8" fill="#6B7280"/>
+  <rect x="324" y="232" width="64" height="16" rx="8" fill="#6B7280"/>
+  <rect x="324" y="272" width="92" height="16" rx="8" fill="#6B7280"/>
+
+  <circle cx="372" cy="340" r="28" fill="none" stroke="#111111" stroke-width="12"/>
+  <path d="M391 359 L420 388" fill="none" stroke="#111111" stroke-width="12" stroke-linecap="round"/>
+</svg>