scottbeabing-cli
Execute Bing Search queries from the terminal including Web, News, Related Search, AutoSuggest, and Images. Images are displayed as colorized-ASCII art or as inline images directly (if using iTerm2).
Note: This project is not affiliated with Microsoft Corporation
Installation
First, install GraphicsMagick to support the image search features GraphicsMagick. In Mac OS X, you can simply use Homebrew and do:
$ brew install graphicsmagickThen, the Bing-CLI module is installed globally via npm:
$ npm install bing-cli -gUsage
This package is meant to be used as a command-line tool.
$ bing <search query> [-c <n>]
$ bing image <query> [-full] [-unsafe] [-c <n>] [-type <imageType>] [-size <imageSize> [-bw] [-grey] [-pixels] [-blocks] [-bg <rgb>]]
$ bing images <query> [-unsafe] [-c <n>]
$ bing news
$ bing news <query>
$ bing related <query>
$ bing suggest <query>
$ bing -versionExamples
This package is meant to be used as a command-line tool.
$ bing puff the magic dragon
$ bing -c 3 "sql server on linux"
$ bing images famous people
$ bing image yosemite -full
$ bing image apple logo -size small -full -scale 0.5 -ascii -bw -invert
$ bing image hawaii -ascii -pixels
$ bing news
$ bing news politics
$ bing news azure aws google cloud
$ bing related apache spark
$ bing suggest gaussi
$ bing netscaler manual fileType:pdf
$ bing image homeaway.com logo -ascii -blocks -size medium -invert -scale 0.8
Configuration
Subscribing to APIs
Bing-CLI requires API keys from Microsoft to work at scale. There is a trial set of API keys included with limited query quota that is enough for trying it out.
Sustained usage will require that you get your API keys, you will need to sign up for Microsoft Congnitive Services by creating a new account with an email, or by signing up with your GitHub or LinkedIn account. Once you do this, you can click on the Pricing link to subscribe to a free-tier of services (more than enough for personal use) for the following APIs:
- Bing Web Search - Free
- Bing Autosuggest - Free
Setting Environment Variables
Once you subscribe to each API, you can then click the Show link to reveal the API keys. Then copy these keys and put them in the exports for the .bash_profile (as mentioned above).
export BING_SEARCH_KEY=<your key here>
export BING_AUTOSUGGEST_KEY=<your key here>Make sure to restart the shell or source .bash_profile (or other shell profile file) for the changes to take effect.
$ source ~/.bash_profileDevelopment
Testing
npm testBugs
Please report any bugs here.
Changelog
Available here.
License
MIT