hlfw.ca

gcli

ref: 71cfdcaf93e20347c5efd641daf1227ce31f27b0
dir: /README.md/

View raw version
# Search the web from the command line using a Google Custom Search engine
# Should work anywhere you have access to a Factotum (Plan9, 9front, plan9port)

## Installation

go get github.com/halfwit/google
go install github.com/halfwit/google

## Usage 

google [[-i] [-it type] [-is size] [-ic color] [-id scale]] [-m results] [-r url] [-a key] [-f type] [-e match] [-x exclude] [ -s safe] query
 -m Number of results per query
 -r Search for sites related to [url]
 -a Use API key instead of factotum
 -f File type [bmp|gif|png|jpg|svg|pdf]
 -e Match string exactly
 -x Phrase to exclude
 -s Safe search [active|high|medium|off]
 -i Image search
Requires -i
 -it Image type [clipart|face|lineart|news|photo]
 -is Image size [huge|icon|large|medium|small|xlarge|xxlarge]
 -ic Image color [black|blue|brown|gray|green|orange|ping|purple|red|teal|white|yellow]
 -id Image scale [color|gray|mono]

## Authentication

To use this, you need an API key for Google Custom Search engine.
See https://developers.google.com/custom-search/v1/introduction, select "Get A Key"

Additionally, you also have to create a Custom Search Engine itself.
Store these keys in your Factotum
`gcli` - your API key (AIza...)
`gcse` - your CSE key