HH Stats

Utility for a collection of a vacancies stats from hh.ru service.

Features

collection of vacancies key skills;
collection for every vacancy key skill:
- request frequency;
- median salary:
  - minimal;
  - maximal;
vacancies search options:
- area list (allowed values (in JSON format): https://api.hh.ru/areas);
- specialization list (allowed values (in JSON format): https://api.hh.ru/specializations);
- additional text query (it supports a query language: https://hh.ru/article/1175);
- search vacancies only with a salary;
automatic conversion of a salary currency via Fixer.io service;
output a collected stats:
- in a format:
  - CSV;
  - SVG;
- to:
  - specified file;
  - stdout (only for CSV format);
  - window via Matplotlib library (only for SVG format);
automatic adding of an output file extension, depending on a specified format.

Clone this repository:

$ git clone https://github.com/thewizardplusplus/hh-stats.git
$ cd hh-stats

Then install the app with pip tool:

$ sudo -H python3.5 -m pip install .

sudo command is required to install hh-stats console script. If it's not required, sudo command can be omitted:

$ python3.5 -m pip install .

But then the app should be started as python3.5 -m hh_stats.

$ hh-stats -v | --version
$ hh-stats -h | --help
$ hh-stats [options]

Options:

-v, --version — show program's version number and exit;
-h, --help — show this help message and exit;
-a AREA [AREA...], --areas AREA [AREA...] — vacancies areas (allowed values (in JSON format): https://api.hh.ru/areas; default: ['1']);
-s SPECIALIZATION [SPECIALIZATION...], --specializations SPECIALIZATION [SPECIALIZATION...] — vacancies specializations (allowed values (in JSON format): https://api.hh.ru/specializations; default: ['1.221']);
-q QUERY, --query QUERY — additional search query (it supports a query language: https://hh.ru/article/1175);
-r, --salary-required — search vacancies only with a salary;
-F REQUEST_FREQUENCY, --request-frequency REQUEST_FREQUENCY — the maximal request frequency (default: 30);
-S PAGE_SIZE, --page-size PAGE_SIZE — the maximal page size (default: 500);
-V VALUE_OF_INTEREST, --value-of-interest VALUE_OF_INTEREST — the minimal value of an interest (default: 5);
-O {num,min,max}, --order {num,min,max} — the order of stats items (default: num);
-f {csv,svg} [{csv,svg}...], --format {csv,svg} [{csv,svg}...] — the output format (default: ['svg']);
-o OUTPUT, --output OUTPUT — the output path.

Help message

Collection of a stats

Stats as a bar plot

The MIT License (MIT)