Metadata-Version: 2.1
Name: yandex-images-crawler
Version: 1.3.1
Summary: Crawler/parser for Yandex Images
Home-page: https://github.com/suborofu/yandex-images-crawler
Author: suborofu
Author-email: alexfromsuvorov@gmail.com
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.7
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: Topic :: Internet :: WWW/HTTP
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: Scientific/Engineering :: Image Processing
Classifier: Topic :: Utilities
Requires-Python: >=3.7
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: numpy>=1.25.0
Requires-Dist: selenium>=4.15.0
Requires-Dist: Pillow>=9.0.0
Requires-Dist: requests>=2.30.0


# Yandex Images Crawler

[![PyPI - Version](https://img.shields.io/pypi/v/yandex-images-crawler?style=for-the-badge&color=blue)](https://pypi.org/project/yandex-images-crawler/)
[![PyPI - Downloads](https://img.shields.io/pypi/dm/yandex-images-crawler?style=for-the-badge&color=mediumpurple)](https://www.pepy.tech/projects/yandex-images-crawler)
[![PyPI - Python Version](https://img.shields.io/pypi/pyversions/yandex-images-crawler?style=for-the-badge)](https://pypi.python.org/pypi/yandex-images-crawler)
[![GitHub License](https://img.shields.io/github/license/suborofu/yandex-images-crawler?style=for-the-badge&color=limegreen)](https://opensource.org/licenses/MIT)

## Description

`Yandex Images Crawler` allows you to download images from [Yandex Images](https://yandex.com/images) automatically.

Unlike most other projects, this package allows you to download images according to certain filters. For example, you can download images of a specified size or similar images.

## Installation

You can use the `yandex_images_crawler/download.py` script or install the package via `pip`.

```cmd
pip install yandex-images-crawler
```

## Usage

```
C:\Users\suborofu> yandex-images-crawler --help
usage: yandex-images-crawler [-h] [--links LINK1,...] [--links-file FILE] [--size WxH] [--count N]
                             [--dir DIR] [--prev-dir DIR]

Yandex Images Crawler

options:
  -h, --help         show this help message and exit
  --links LINK1,...  Full links to image sets for download. Links should be separated by commas. Each    
                     link should lead to an open preview of the image.
  --links-file FILE  Text file with full links to image sets for download. Links should be separated by  
                     newlines. Each link should lead to an open preview of the image.
  --size WxH         Minimum size of images to download. Width an height should be separated by 'x'.     
  --count N          Required count of images to download. A message appears if the desired number of    
                     images are downloaded.
  --dir DIR          Directory for new images.
  --prev-dir DIR     Directory of previously loaded images. Program skips the loading of already loaded  
                     images in another directory. Useful for re-downloading.
```

### Links

To get correct links, follow the steps below:

1. Open [Yandex Images](https://yandex.com/images).
2. Search for images you need.
3. Set the search parameters:
   - Specify size, orientation, type or color.
   - Provide a site URL.
   - Find similar images.
4. Copy a link in the browser ([example](https://yandex.com/images/search?lr=10831&quality=95&rdrnd=531684&redircnt=1737888986.1&sign=304c88d47ac4545285d022ba151a7c35&text=rick%20roll%20meme&type=album)).
