avito-sdk 0.1.0__tar.gz

avito_sdk-0.1.0/.github/workflows/ci.yml

@@ -0,0 +1,47 @@
+name: CI
+
+on:
+  push:
+    branches: [main, master]
+  pull_request:
+    branches: [main, master]
+
+jobs:
+  test:
+    name: Python ${{ matrix.python-version }} on ${{ matrix.os }}
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ubuntu-latest, windows-latest, macos-latest]
+        python-version:
+          - "3.8"
+          - "3.9"
+          - "3.10"
+          - "3.11"
+          - "3.12"
+          - "3.13"
+          - "3.14"
+        include:
+          - os: ubuntu-latest
+            python-version: "3.13-nogil"
+          - os: ubuntu-latest
+            python-version: "pypy3.10"
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python ${{ matrix.python-version }}
+        uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+          allow-prereleases: true
+
+      - name: Install dependencies
+        run: |
+          python -m pip install --upgrade pip
+          python -m pip install ".[dev,excel]"
+
+      - name: Run pytest
+        run: |
+          pytest -v

avito_sdk-0.1.0/.github/workflows/publish.yml

@@ -0,0 +1,38 @@
+name: Publish to PyPI
+
+on:
+  release:
+    types: [published]
+  workflow_dispatch:
+
+jobs:
+  build-and-publish:
+    runs-on: ubuntu-latest
+    permissions:
+      id-token: write
+      contents: read
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Install build tools
+        run: |
+          python -m pip install --upgrade pip build twine
+
+      - name: Build sdist and wheel
+        run: |
+          python -m build
+
+      - name: Check package
+        run: |
+          twine check dist/*
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          skip-existing: true

avito_sdk-0.1.0/.gitignore

@@ -0,0 +1,32 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# Distribution / packaging
+dist/
+build/
+*.egg-info/
+.eggs/
+
+# Virtual environments
+.venv/
+env/
+venv/
+ENV/
+
+# Testing and coverage
+.pytest_cache/
+.coverage
+htmlcov/
+
+# Local databases and output
+*.db
+*.sqlite3
+*.xlsx
+*.csv
+result/
+storage/
+logs/
+.DS_Store
+Thumbs.db

avito_sdk-0.1.0/CHANGELOG.md

@@ -0,0 +1,32 @@
+# Changelog
+
+All notable changes to `avito-sdk` will be documented in this file.
+
+## [0.1.0] - 2026-10-05
+
+### Added
+- **Core SDK & Clients**:
+  - `AvitoClient`: intuitive synchronous client for search, enrichment, and export.
+  - `AsyncAvitoClient`: native asyncio streaming client for bot and web frameworks (Aiogram 3, FastAPI, aiohttp).
+  - Headless execution with zero desktop GUI dependencies.
+- **Price Tracking Engine (PR #334 / Issue #214)**:
+  - `PriceTracker` backed by SQLite and in-memory engine.
+  - Automatic detection of price changes, drops (`price_drop`), and full price history log.
+- **Seller Information Extraction (PR #334 / Issue #333)**:
+  - Extraction of seller display name (`seller_name`) from API payloads and HTML markers.
+  - Extraction of seller profile/brand slug (`seller_id`).
+- **Item Parameters & Characteristics (PR #337 / Issue #335)**:
+  - Deep parser for Beduin scenario widget structures and Mobile API properties.
+  - Full support for real estate («О помещении», этаж, площадь), auto specs, electronics, and goods.
+- **Full Description Extraction (PR #329 / Issue #305)**:
+  - Support for multi-line description parsing from JSON scenarios and Schema.org microdata.
+- **Exporters**:
+  - Styled Excel (`.xlsx`) export via openpyxl with auto-sized columns.
+  - JSON and JSON Lines (`.jsonl`) streaming export.
+  - CSV export with utf-8-sig encoding.
+  - Pandas / Polars DataFrame conversion.
+- **CLI Tool**:
+  - Built-in `avito-sdk` and `avito-parser` command-line interfaces.
+- **Anti-Bot & Transport**:
+  - TLS browser impersonation via `curl_cffi` with graceful fallback to `httpx` and `requests`.
+  - Automatic retry logic on 429/403 with exponential backoff and jitter.

avito_sdk-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 eminsk (M_N_N@tut.by)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

avito_sdk-0.1.0/PKG-INFO

@@ -0,0 +1,237 @@
+Metadata-Version: 2.5
+Name: avito-sdk
+Version: 0.1.0
+Summary: High-performance headless Avito scraping & data extraction SDK with price tracking, parameters parsing, and async support
+Project-URL: Homepage, https://github.com/eminsk/avito-sdk
+Project-URL: Documentation, https://github.com/eminsk/avito-sdk#readme
+Project-URL: Repository, https://github.com/eminsk/avito-sdk
+Project-URL: Issues, https://github.com/eminsk/avito-sdk/issues
+Author-email: eminsk <M_N_N@tut.by>
+License: MIT
+License-File: LICENSE
+Keywords: api,avito,crawler,e-commerce,headless,parser,price-tracker,scraper,sdk
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Programming Language :: Python :: 3.15
+Classifier: Programming Language :: Python :: 3.16
+Classifier: Programming Language :: Python :: Implementation :: CPython
+Classifier: Programming Language :: Python :: Implementation :: PyPy
+Classifier: Topic :: Internet :: WWW/HTTP :: Indexing/Search
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.8
+Requires-Dist: beautifulsoup4>=4.10.0
+Requires-Dist: requests>=2.28.0
+Provides-Extra: all
+Requires-Dist: curl-cffi>=0.7.0; extra == 'all'
+Requires-Dist: httpx>=0.24.0; extra == 'all'
+Requires-Dist: openpyxl>=3.0.0; extra == 'all'
+Requires-Dist: pandas>=1.5.0; extra == 'all'
+Provides-Extra: async
+Requires-Dist: httpx>=0.24.0; extra == 'async'
+Provides-Extra: dataframe
+Requires-Dist: pandas>=1.5.0; extra == 'dataframe'
+Provides-Extra: dev
+Requires-Dist: openpyxl>=3.0.0; extra == 'dev'
+Requires-Dist: pytest-asyncio>=0.21.0; extra == 'dev'
+Requires-Dist: pytest>=7.0.0; extra == 'dev'
+Provides-Extra: excel
+Requires-Dist: openpyxl>=3.0.0; extra == 'excel'
+Provides-Extra: tls
+Requires-Dist: curl-cffi>=0.7.0; extra == 'tls'
+Description-Content-Type: text/markdown
+
+# avito-sdk
+
+[![PyPI Version](https://img.shields.io/pypi/v/avito-sdk.svg?color=blue)](https://pypi.org/project/avito-sdk/)
+[![Python Versions](https://img.shields.io/pypi/pyversions/avito-sdk.svg)](https://pypi.org/project/avito-sdk/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![Conda Forge](https://img.shields.io/conda/vn/conda-forge/avito-sdk.svg?color=green)](https://anaconda.org/conda-forge/avito-sdk)
+[![Free-Threaded No-GIL](https://img.shields.io/badge/PEP%20703-No--GIL%20Ready-brightgreen)](https://peps.python.org/pep-0703/)
+[![CI](https://github.com/eminsk/avito-sdk/actions/workflows/ci.yml/badge.svg)](https://github.com/eminsk/avito-sdk/actions)
+
+> **Высокопроизводительная библиотека и SDK для работы с Avito без GUI.**  
+> Разработана ключевым контрибьютором [`Duff89/parser_avito`](https://github.com/Duff89/parser_avito).
+
+---
+
+## 🚀 Возможности
+
+- 🚀 **100% Headless и легкий вес**: Никаких оконных библиотек (Tkinter, CustomTkinter, Flet, PyInstaller). Работает прямо в Linux, Docker, AWS, Raspberry Pi, macOS и Windows.
+- ⚡ **Asyncio и Синхронный режим**: `AsyncAvitoClient` для высоконагруженных Telegram-ботов (Aiogram 3, Telethon), FastAPI, и `AvitoClient` для простых скриптов.
+- 📉 **Отслеживание изменения цен (PR #334 / Issue #214)**: Автоматическая фиксация старой цены, вычисление снижения цены (`price_drop`) и ведение истории в SQLite.
+- 👤 **Извлечение данных продавца (PR #334 / Issue #333)**: Сбор имени продавца (`seller_name`) и slug/ID профиля/магазина (`seller_id`).
+- 📋 **Глубокий сбор характеристик (PR #337 / Issue #335)**: Извлечение всех параметров («О помещении», площадь, этаж, тех. характеристики авто и электроники) из Beduin-сценариев и Mobile API.
+- 📝 **Полный текст описания (PR #329 / Issue #305)**: Извлечение многострочного описания из микроразметки Schema.org и сценариев Avito.
+- 🛡️ **Обход TLS-fingerprinting**: Имитация сетевого отпечатка Chrome/Safari через `curl_cffi` с автоматическим фолбэком на стандартный HTTP-транспорт.
+- 📊 **Экспорт данных**: В Excel (`.xlsx` со стилями), CSV, JSON, JSONL, а также в Pandas и Polars DataFrame.
+- 💻 **Консольная утилита (CLI)**: Быстрый поиск прямо из терминала через `avito-sdk search` или `avito-parser`.
+- 🌐 **Мультиплатформенность**: Поддержка Python 3.8 – 3.16+, Free-Threaded No-GIL (3.13t–3.15t) и PyPy.
+
+---
+
+## 📦 Установка
+
+```bash
+# Базовая установка
+pip install avito-sdk
+
+# С поддержкой обхода анти-бот защиты (рекомендуется)
+pip install "avito-sdk[tls]"
+
+# Полная установка (Excel, TLS, Async, DataFrames)
+pip install "avito-sdk[all]"
+```
+
+Или через Conda / Mamba:
+```bash
+conda install -c conda-forge avito-sdk
+```
+
+---
+
+## ⚡ Быстрый старт
+
+### 1. Синхронный поиск объявлений
+
+```python
+from avito_sdk import AvitoClient
+
+client = AvitoClient()
+
+# Поиск ноутбуков в Москве до 80 000 ₽
+for item in client.search("ноутбук thinkpad", region="Москва", max_price=80000, limit=10):
+    print(f"[{item.id}] {item.title} — {item.price:,} ₽ | Продавец: {item.seller_name}")
+    if item.has_price_changed:
+        print(f"  🔥 Цена изменилась! Старая: {item.old_price:,} ₽ (Снижение: {item.price_drop:,} ₽)")
+```
+
+---
+
+### 2. Асинхронный стриминг (для Telegram-ботов и FastAPI)
+
+```python
+import asyncio
+from avito_sdk import AsyncAvitoClient
+
+async def main():
+    async with AsyncAvitoClient() as client:
+        async for item in client.search("rtx 4070", region="Санкт-Петербург", limit=20):
+            print(f"Найдено: {item.title} ({item.price:,} ₽) -> {item.url}")
+
+asyncio.run(main())
+```
+
+---
+
+### 3. Получение полных параметров и характеристик (PR #337)
+
+```python
+from avito_sdk import AvitoClient
+
+client = AvitoClient()
+
+# Получаем карточку объявления со всеми характеристиками
+item = client.get_item(1234567890)
+
+print("Название:", item.title)
+print("Цена:", item.price)
+print("Продавец:", item.seller_name)
+print("Просмотры:", f"{item.total_views} всего, {item.today_views} сегодня")
+
+print("\nХарактеристики (PR #337):")
+for param_name, param_val in item.params.items():
+    print(f"  • {param_name}: {param_val}")
+
+print("\nОписание (PR #329):")
+print(item.description)
+```
+
+---
+
+### 4. Отслеживание падения цен (PR #334)
+
+```python
+from avito_sdk import AvitoClient, PriceTracker
+
+client = AvitoClient(tracker_db="prices.db")
+
+# Запускаем сбор и авто-трекинг
+items = list(client.search("iPhone 15 Pro", region="Москва", limit=50))
+
+# Получаем список объявлений, у которых цена упала:
+tracker = client.tracker
+drops = tracker.get_price_drops()
+for drop in drops:
+    diff = drop["initial_price"] - drop["current_price"]
+    print(f"📉 Скидка! {drop['title']}: {drop['initial_price']:,} -> {drop['current_price']:,} ₽ (-{diff:,} ₽)")
+```
+
+---
+
+### 5. Экспорт в Excel / JSON / Pandas
+
+```python
+from avito_sdk import AvitoClient, to_excel, to_json, to_dataframe
+
+client = AvitoClient()
+items = list(client.search("PlayStation 5", limit=30, enrich_details=True))
+
+# 1. Красивый Excel с автошириной колонок и форматированием
+to_excel(items, "ps5_listings.xlsx")
+
+# 2. JSON Lines для ML и потоковой обработки
+to_json(items, "ps5_listings.json")
+
+# 3. Pandas DataFrame
+df = to_dataframe(items)
+print(df[["id", "title", "price", "seller_name"]].head())
+```
+
+---
+
+## 🖥️ Использование из консоли (CLI)
+
+Библиотека включает встроенную консольную команду `avito-sdk` (или `avito-parser`):
+
+```bash
+# Поиск с выводом на экран и сохранением в Excel:
+avito-sdk search "MacBook M2" --region moskva --max-price 90000 --output macbooks.xlsx
+
+# Просмотр детальной карточки объявления:
+avito-sdk item 3854129841
+
+# Просмотр всех зафиксированных снижений цен:
+avito-sdk drops --db prices.db
+```
+
+---
+
+## 🛠️ Сравнение: `parser_avito` (GUI) vs `avito-sdk` (Библиотека)
+
+| Функция | Duff89/parser_avito | **avito-sdk** |
+| :--- | :---: | :---: |
+| Назначение | Десктопное приложение для пользователей | Автономная Python-библиотека & SDK |
+| Графический интерфейс | ✅ Есть (CustomTkinter / GUI) | ❌ Отсутствует (100% Headless) |
+| Запуск на сервере / Docker / VPS | Требует виртуальный дисплей (xvfb) | ✅ Из коробки без зависимостей |
+| Асинхронный API (`asyncio`) | ❌ Нет | ✅ `AsyncAvitoClient` |
+| Использование в Telegram-ботах | Сложно | ✅ `pip install avito-sdk` |
+| Отслеживание цен (PR #334) | ✅ Есть | ✅ Встроенный `PriceTracker` |
+| Характеристики товара (PR #337) | ✅ Есть | ✅ Глубокий парсер Beduin & Mobile |
+| Поддержка Python 3.8 – 3.16+ | 3.11 – 3.13 | ✅ 3.8 – 3.16, No-GIL, PyPy |
+
+---
+
+## 📄 Лицензия
+
+Распространяется под свободной лицензией **MIT**.  
+Автор: **eminsk** ([M_N_N@tut.by](mailto:M_N_N@tut.by))

avito_sdk-0.1.0/README.md

@@ -0,0 +1,185 @@
+# avito-sdk
+
+[![PyPI Version](https://img.shields.io/pypi/v/avito-sdk.svg?color=blue)](https://pypi.org/project/avito-sdk/)
+[![Python Versions](https://img.shields.io/pypi/pyversions/avito-sdk.svg)](https://pypi.org/project/avito-sdk/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![Conda Forge](https://img.shields.io/conda/vn/conda-forge/avito-sdk.svg?color=green)](https://anaconda.org/conda-forge/avito-sdk)
+[![Free-Threaded No-GIL](https://img.shields.io/badge/PEP%20703-No--GIL%20Ready-brightgreen)](https://peps.python.org/pep-0703/)
+[![CI](https://github.com/eminsk/avito-sdk/actions/workflows/ci.yml/badge.svg)](https://github.com/eminsk/avito-sdk/actions)
+
+> **Высокопроизводительная библиотека и SDK для работы с Avito без GUI.**  
+> Разработана ключевым контрибьютором [`Duff89/parser_avito`](https://github.com/Duff89/parser_avito).
+
+---
+
+## 🚀 Возможности
+
+- 🚀 **100% Headless и легкий вес**: Никаких оконных библиотек (Tkinter, CustomTkinter, Flet, PyInstaller). Работает прямо в Linux, Docker, AWS, Raspberry Pi, macOS и Windows.
+- ⚡ **Asyncio и Синхронный режим**: `AsyncAvitoClient` для высоконагруженных Telegram-ботов (Aiogram 3, Telethon), FastAPI, и `AvitoClient` для простых скриптов.
+- 📉 **Отслеживание изменения цен (PR #334 / Issue #214)**: Автоматическая фиксация старой цены, вычисление снижения цены (`price_drop`) и ведение истории в SQLite.
+- 👤 **Извлечение данных продавца (PR #334 / Issue #333)**: Сбор имени продавца (`seller_name`) и slug/ID профиля/магазина (`seller_id`).
+- 📋 **Глубокий сбор характеристик (PR #337 / Issue #335)**: Извлечение всех параметров («О помещении», площадь, этаж, тех. характеристики авто и электроники) из Beduin-сценариев и Mobile API.
+- 📝 **Полный текст описания (PR #329 / Issue #305)**: Извлечение многострочного описания из микроразметки Schema.org и сценариев Avito.
+- 🛡️ **Обход TLS-fingerprinting**: Имитация сетевого отпечатка Chrome/Safari через `curl_cffi` с автоматическим фолбэком на стандартный HTTP-транспорт.
+- 📊 **Экспорт данных**: В Excel (`.xlsx` со стилями), CSV, JSON, JSONL, а также в Pandas и Polars DataFrame.
+- 💻 **Консольная утилита (CLI)**: Быстрый поиск прямо из терминала через `avito-sdk search` или `avito-parser`.
+- 🌐 **Мультиплатформенность**: Поддержка Python 3.8 – 3.16+, Free-Threaded No-GIL (3.13t–3.15t) и PyPy.
+
+---
+
+## 📦 Установка
+
+```bash
+# Базовая установка
+pip install avito-sdk
+
+# С поддержкой обхода анти-бот защиты (рекомендуется)
+pip install "avito-sdk[tls]"
+
+# Полная установка (Excel, TLS, Async, DataFrames)
+pip install "avito-sdk[all]"
+```
+
+Или через Conda / Mamba:
+```bash
+conda install -c conda-forge avito-sdk
+```
+
+---
+
+## ⚡ Быстрый старт
+
+### 1. Синхронный поиск объявлений
+
+```python
+from avito_sdk import AvitoClient
+
+client = AvitoClient()
+
+# Поиск ноутбуков в Москве до 80 000 ₽
+for item in client.search("ноутбук thinkpad", region="Москва", max_price=80000, limit=10):
+    print(f"[{item.id}] {item.title} — {item.price:,} ₽ | Продавец: {item.seller_name}")
+    if item.has_price_changed:
+        print(f"  🔥 Цена изменилась! Старая: {item.old_price:,} ₽ (Снижение: {item.price_drop:,} ₽)")
+```
+
+---
+
+### 2. Асинхронный стриминг (для Telegram-ботов и FastAPI)
+
+```python
+import asyncio
+from avito_sdk import AsyncAvitoClient
+
+async def main():
+    async with AsyncAvitoClient() as client:
+        async for item in client.search("rtx 4070", region="Санкт-Петербург", limit=20):
+            print(f"Найдено: {item.title} ({item.price:,} ₽) -> {item.url}")
+
+asyncio.run(main())
+```
+
+---
+
+### 3. Получение полных параметров и характеристик (PR #337)
+
+```python
+from avito_sdk import AvitoClient
+
+client = AvitoClient()
+
+# Получаем карточку объявления со всеми характеристиками
+item = client.get_item(1234567890)
+
+print("Название:", item.title)
+print("Цена:", item.price)
+print("Продавец:", item.seller_name)
+print("Просмотры:", f"{item.total_views} всего, {item.today_views} сегодня")
+
+print("\nХарактеристики (PR #337):")
+for param_name, param_val in item.params.items():
+    print(f"  • {param_name}: {param_val}")
+
+print("\nОписание (PR #329):")
+print(item.description)
+```
+
+---
+
+### 4. Отслеживание падения цен (PR #334)
+
+```python
+from avito_sdk import AvitoClient, PriceTracker
+
+client = AvitoClient(tracker_db="prices.db")
+
+# Запускаем сбор и авто-трекинг
+items = list(client.search("iPhone 15 Pro", region="Москва", limit=50))
+
+# Получаем список объявлений, у которых цена упала:
+tracker = client.tracker
+drops = tracker.get_price_drops()
+for drop in drops:
+    diff = drop["initial_price"] - drop["current_price"]
+    print(f"📉 Скидка! {drop['title']}: {drop['initial_price']:,} -> {drop['current_price']:,} ₽ (-{diff:,} ₽)")
+```
+
+---
+
+### 5. Экспорт в Excel / JSON / Pandas
+
+```python
+from avito_sdk import AvitoClient, to_excel, to_json, to_dataframe
+
+client = AvitoClient()
+items = list(client.search("PlayStation 5", limit=30, enrich_details=True))
+
+# 1. Красивый Excel с автошириной колонок и форматированием
+to_excel(items, "ps5_listings.xlsx")
+
+# 2. JSON Lines для ML и потоковой обработки
+to_json(items, "ps5_listings.json")
+
+# 3. Pandas DataFrame
+df = to_dataframe(items)
+print(df[["id", "title", "price", "seller_name"]].head())
+```
+
+---
+
+## 🖥️ Использование из консоли (CLI)
+
+Библиотека включает встроенную консольную команду `avito-sdk` (или `avito-parser`):
+
+```bash
+# Поиск с выводом на экран и сохранением в Excel:
+avito-sdk search "MacBook M2" --region moskva --max-price 90000 --output macbooks.xlsx
+
+# Просмотр детальной карточки объявления:
+avito-sdk item 3854129841
+
+# Просмотр всех зафиксированных снижений цен:
+avito-sdk drops --db prices.db
+```
+
+---
+
+## 🛠️ Сравнение: `parser_avito` (GUI) vs `avito-sdk` (Библиотека)
+
+| Функция | Duff89/parser_avito | **avito-sdk** |
+| :--- | :---: | :---: |
+| Назначение | Десктопное приложение для пользователей | Автономная Python-библиотека & SDK |
+| Графический интерфейс | ✅ Есть (CustomTkinter / GUI) | ❌ Отсутствует (100% Headless) |
+| Запуск на сервере / Docker / VPS | Требует виртуальный дисплей (xvfb) | ✅ Из коробки без зависимостей |
+| Асинхронный API (`asyncio`) | ❌ Нет | ✅ `AsyncAvitoClient` |
+| Использование в Telegram-ботах | Сложно | ✅ `pip install avito-sdk` |
+| Отслеживание цен (PR #334) | ✅ Есть | ✅ Встроенный `PriceTracker` |
+| Характеристики товара (PR #337) | ✅ Есть | ✅ Глубокий парсер Beduin & Mobile |
+| Поддержка Python 3.8 – 3.16+ | 3.11 – 3.13 | ✅ 3.8 – 3.16, No-GIL, PyPy |
+
+---
+
+## 📄 Лицензия
+
+Распространяется под свободной лицензией **MIT**.  
+Автор: **eminsk** ([M_N_N@tut.by](mailto:M_N_N@tut.by))