JobCLI

Job search from the command line

Features

More than 15K jobs in software development, engineering and data science
Companies in 🇺🇸 and 🇩🇪 (for now)
Simple command line interface
CSV or JSON output

Installation
Usage
Pretty-printing
- CSV
- JSON
Local database

Prerequisites

PIP - python package manager (How to install PIP)

🔌 Installation

$ pip install jobcli

💻 Usage

To list all available options in your command line, do:

$ jobcli --help

Usage: jobcli [OPTIONS]

  JobCLI: Your Command Line Job Board

Options:
  -c, --country [US|DE]    iso-alpha2 country code
  -l, --location TEXT      city
  -j, --jobtitle TEXT      job title
  -s, --skills TEXT        search terms
  -f, --firm TEXT          company name
  -p, --page INTEGER       search result page
  -o, --output [CSV|JSON]  output format
  -v, --version            Show the version and exit.
  --help                   Show this message and exit.

Example 1: simple search

To list engineering jobs, do:

$ jobcli -j engineer

Example 2: multiple criteria

To list front-end jobs in Germany that mention 'react' in their description, do:

$ jobcli -j frontend -c DE -s react

Example 3: pagination

You only receive 100 records at a time. To paginate through the entire result set, use the --page or -p option:

$ jobcli -j developer -c US -p 2

Pretty-printing

CSV

For csv output, csvkit comes with csvlook:

$ jobcli | csvlook | head

| url                        | jobtitle                                              | company              | location             | country | page |
| -------------------------- | ----------------------------------------------------- | -------------------- | -------------------- | ------- | ---- |
| http://jobcli.com/9xUIe0Ju | UX Research Analyst                                   | Quantix/Protech      | Cleveland, OH        | US      | 1    |
| http://jobcli.com/QPnZx-Kk | senior systems engineer, Starbucks Technology - Se... | Starbucks            | Seattle, WA          | US      | 1    |
| http://jobcli.com/qEP3KyUV | Drafter/Designer                                      | UPMC                 | New York, NY         | US      | 1    |
| http://jobcli.com/pKlL-WbP | Project Manager (HVAC)/Systems Specialist             | Johnson Controls     | Syosset, NY          | US      | 1    |
| http://jobcli.com/NPnYSJbV | Aem Developer                                         | TCS                  | Cleveland, OH        | US      | 1    |
| http://jobcli.com/4gu9gW3q | Floral Designer                                       | Daniels Foods Sentry | Walworth, WI         | US      | 1    |
| http://jobcli.com/sXgOPNlq | Android Developer                                     | BuzzHero             | San Francisco, CA    | US      | 1    |
| http://jobcli.com/GuVB_NUi | Graphic Designer                                      | Jillian's Circus     | Oceanside, NY        | US      | 1    |

You can install csvkit with pip:

$ pip install csvkit

An alternative from the Rust ecosystem is the excellent xsv and it's table command.

JSON

For json output, there's a handy tool in the python standard library:

$ jobcli -o json | python -m json.tool | less

[
    {
        "url": "http://jobcli.com/9xUIe0Ju",
        "jobtitle": "UX Research Analyst",
        "company": "Quantix/Protech",
        "location": "Cleveland, OH",
        "country": "US",
        "page": 1
    },
    {
        "url": "http://jobcli.com/qEP3KyUV",
        "jobtitle": "Drafter/Designer",
        "company": "UPMC",
        "location": "New York, NY",
        "country": "US",
        "page": 1
    },
    [...]

Saving to a local database

If you prefer to load the data into your own database and query from there, this schema might come in handy:

CREATE TABLE jobs(
  url varchar(30),
  jobtitle varchar(50),
  company varchar(25),
  location varchar(20),
  country varchar(2),
  page int
);

You can use the url as primary key.

jobcli / jobcli-app