avito-sdk

Высокопроизводительная библиотека и SDK для работы с Avito без GUI.
Разработана ключевым контрибьютором 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.

📦 Установка

# Базовая установка
pip install avito-sdk

# С поддержкой обхода анти-бот защиты (рекомендуется)
pip install "avito-sdk[tls]"

# Полная установка (Excel, TLS, Async, DataFrames)
pip install "avito-sdk[all]"

Или через Conda / Mamba:

conda install -c conda-forge avito-sdk

⚡ Быстрый старт

1. Синхронный поиск объявлений

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)

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)

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)

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

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):

# Поиск с выводом на экран и сохранением в 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 (Библиотека)

📄 Лицензия

Распространяется под свободной лицензией MIT.
Автор: eminsk (M_N_N@tut.by)