wb-market-parser

Парсер для получения информации о пунктах выдачи Wildberries. Библиотека предоставляет удобный API для работы с данными о пунктах выдачи, включая их адреса, координаты, режимы работы и другую информацию.

Особенности

• 🚀 Быстрый доступ к данным через кэширование
• 📍 Поддержка геолокации и координат
• 🌍 Мультиязычность (поддержка разных стран)
• 🔄 Автоматическое обновление данных
• 📦 Поддержка CommonJS и ESM
• 📝 Полная поддержка TypeScript

Установка

1npm install wb-market-parser

или

1yarn add wb-market-parser

Использование

CommonJS

1const { WbMarketParser } = require('wb-market-parser');
2
3const parser = new WbMarketParser();

ESM

1import { WbMarketParser } from 'wb-market-parser';
2
3const parser = new WbMarketParser();

API

Конструктор

1new WbMarketParser(config?: {
2  cacheDuration?: number; // длительность кэширования в миллисекундах (по умолчанию 5 минут)
3  logger?: {
4    log: (message: string) => void;
5    error: (message: string, error?: Error) => void;
6    debug: (message: string) => void;
7  };
8})

Методы

getCountries()

Возвращает список всех стран, где есть пункты выдачи.

1const countries = await parser.getCountries();
2// ['Russia', 'Belarus', ...]

getByCountry(country: string)

Возвращает список пунктов выдачи для указанной страны.

1const markets = await parser.getByCountry('Russia');
2// [{ id: 1, address: 'Moscow, Red Square 1', ... }, ...]

getById(id: number)

Возвращает пункт выдачи по его ID.

1const market = await parser.getById(1);
2// [{ id: 1, address: 'Moscow, Red Square 1', ... }]

markets()

Возвращает все данные о пунктах выдачи, сгруппированные по странам.

1const allMarkets = await parser.markets();
2// [{ country: 'Russia', markets: [...] }, ...]

Кэширование

Библиотека использует встроенное кэширование для оптимизации производительности и уменьшения нагрузки на API Wildberries.

Настройка кэширования

1const parser = new WbMarketParser({
2  cacheDuration: 10 * 60 * 1000 // кэш на 10 минут
3});

Особенности кэширования

• Данные кэшируются в памяти
• Кэш автоматически обновляется при истечении срока действия
• При ошибках загрузки данных используются кэшированные данные, если они доступны
• Кэш очищается при создании нового экземпляра парсера

Типы данных

1interface MarketType {
2  Items: {
3    country: string;
4    markets: {
5      id: number;
6      address: string;
7      coordinates: [number, number];
8      workTime: string;
9      photos: string[];
10      typePoint: number;
11      dtype: number;
12      isWb: boolean;
13      pickupType: number;
14      dest: number;
15      dest3: number;
16      sign: string;
17    }[];
18  }[];
19}

Разработка

Установка зависимостей

1npm install

Запуск тестов

1npm test

Сборка

1npm run build

Структура проекта

wb-market-parser/
├── src/
│   ├── index.ts        # Точка входа
│   ├── market.ts       # Основная логика парсера
│   ├── market.test.ts  # Тесты
│   └── types.ts        # Типы данных
├── package.json
└── README.md

Вклад в проект

Мы приветствуем вклад в развитие проекта! Вот как вы можете помочь:

1. Сообщения об ошибках

   • Используйте GitHub Issues
   • Опишите проблему максимально подробно
   • Приложите пример кода, если возможно

2. Pull Requests

   • Создавайте ветку для каждой новой функции
   • Следуйте существующему стилю кода
   • Добавляйте тесты для новой функциональности
   • Обновляйте документацию

3. Улучшение документации

   • Исправление ошибок
   • Улучшение примеров
   • Добавление новых разделов

Процесс разработки

1. Форкните репозиторий
2. Создайте ветку для ваших изменений
3. Внесите изменения
4. Запустите тесты: npm test
5. Создайте Pull Request

Требования к коду

• Следуйте стилю кода проекта
• Пишите тесты для новой функциональности
• Обновляйте документацию при необходимости
• Используйте TypeScript для типизации

Лицензия

MIT

Поддержка

Если у вас возникли проблемы или есть вопросы:

• Создайте Issue на GitHub
• Опишите проблему максимально подробно
• Приложите пример кода, если возможно

Безопасность

Если вы обнаружили уязвимость безопасности, пожалуйста, сообщите об этом через GitHub Issues или напрямую разработчикам.