google-advanced-search

A simple tool to google with easy advanced search settings.

You can use this both...

• as a CLI tool to help you to google more easily and quickly
• as a library to generate a search URL for your projects

Installation

npm install google-advanced-search

Usage

$ npx advsearch -h
Usage: advsearch [options]

Options:
  -c, --configure    configure the default filter settings
  -t, --temporary    set temporary filter (does not apply the default filter settings)
  -n, --not-opening  display the result URL without opening your browser
  -h, --help         display help for command

Quick Start 1 (to use as a CLI tool)

Do google search with default filter settings

npx advsearch

Change and save your filter settings

npx advsearch -c

Other options

Set a temporary filter (without appling it to the default filter settings)

npx advsearch -t

Display the result URL without opening it in your browser

npx advsearch -n

Quick Start 2 (to use as a library)

Example:

// example.js
import { Filter, QueryFieldGroup, UrlBuilder } from 'google-advanced-search'

const query = new QueryFieldGroup({ queryWords: 'what is bullet train', except: 'movie' })
const filter = new Filter({
  language: 'English',
  region: 'any',
  lastUpdate: 'pastYear',
  siteOrDomain: 'wikipedia.org',
  termsAppearing:'anywhereInThePage',
  safeSearch: 'showExplicitResults',
  fileType: 'any',
  usageRights: 'any'
})
const urlBuilder = new UrlBuilder()

console.log(urlBuilder.generateGoogleSearchUrl(query, filter))

You will get:

$ node example.js
https://www.google.com/search?as_q=what+is+bullet+train&as_epq=&as_oq=&as_eq=movie&as_nlo=&as_nhi=&lr=lang_en&cr=&as_qdr=y&as_sitesearch=wikipedia.org&as_occt=any&safe=images&as_filetype=&tbs=

Parameters

You can set these parameters below as a search filter. If you didn't specify them, the filter is set to the default values.

For Search Key Words

They are properties of QueryFieldGroup.

|Name|Description| |----|----------| |queryWords|Find pages with all these words.| |exactWords|Find pages with this exact word or phrase.| |anyOfTheseWords|Find pages with ny of these words.| |except|Find pages with none of these words.| |numbersRangingFrom|Find pages within the range.| |numbersRangingTo|Find pages within the range.|

For Result Filter

Language codes and region codes were taken from the following site:

XML API reference appendices  |  Programmable Search Engine  |  Google Developers

Language

|key| |---| |any (default)| |Arabic| |Bulgarian| |Catalan| |Chinese_Simplified| |Chinese_Traditional| |Croatian| |Czech| |Danish| |Dutch| |English| |Estonian| |Finnish| |French| |German| |Greek| |Hebrew| |Hungarian| |Icelandic| |Indonesian| |Italian| |Japanese| |Korean| |Latvian| |Lithuanian| |Norwegian| |Polish| |Portuguese| |Romanian| |Russian| |Serbian| |Slovak| |Slovenian| |Spanish| |Swedish| |Turkish|

Region

|key| |---| |any (default)| |Afghanistan| |Albania| |Algeria| |American_Samoa| |Andorra| |Angola| |Anguilla| |Antarctica| |Antigua_and_Barbuda| |Argentina| |Armenia| |Aruba| |Australia| |Austria| |Azerbaijan| |Bahamas| |Bahrain| |Bangladesh| |Barbados| |Belarus| |Belgium| |Belize| |Benin| |Bermuda| |Bhutan| |Bolivia| |Bosnia_and_Herzegovina| |Botswana| |Bouvet_Island| |Brazil| |British_Indian_Ocean_Territory| |Brunei_Darussalam| |Bulgaria| |Burkina_Faso| |Burundi| |Cambodia| |Cameroon| |Canada| |Cape_Verde| |Cayman_Islands| |Central_African_Republic| |Chad| |Chile| |China| |Christmas_Island| |Cocos_Keeling_Islands| |Colombia| |Comoros| |Congo| |Congo_the_Democratic_Republic_of_the| |Cook_Islands| |Costa_Rica| |Cote_Divoire| |Croatia_Hrvatska| |Cuba| |Cyprus| |Czech_Republic| |Denmark| |Djibouti| |Dominica| |Dominican_Republic| |East_Timor| |Ecuador| |Egypt| |El_Salvador| |Equatorial_Guinea| |Eritrea| |Estonia| |Ethiopia| |European_Union| |Falkland_Islands_Malvinas| |Faroe_Islands| |Fiji| |Finland| |France| |France_Metropolitan| |French_Guiana| |French_Polynesia| |French_Southern_Territories| |Gabon| |Gambia| |Georgia| |Germany| |Ghana| |Gibraltar| |Greece| |Greenland| |Grenada| |Guadeloupe| |Guam| |Guatemala| |Guinea| |Guinea_Bissau| |Guyana| |Haiti| |Heard_Island_and_Mcdonald_Islands| |Holy_See_Vatican_City_State| |Honduras| |Hong_Kong| |Hungary| |Iceland| |India| |Indonesia| |Iran_Islamic_Republic_of| |Iraq| |Ireland| |Israel| |Italy| |Jamaica| |Japan| |Jordan| |Kazakhstan| |Kenya| |Kiribati| |Korea_Democratic_Peoples_Republic_of| |Korea_Republic_of| |Kuwait| |Kyrgyzstan| |Lao_Peoples_Democratic_Republic| |Latvia| |Lebanon| |Lesotho| |Liberia| |Libyan_Arab_Jamahiriya| |Liechtenstein| |Lithuania| |Luxembourg| |Macao| |Macedonia_the_Former_Yugosalv_Republic_of| |Madagascar| |Malawi| |Malaysia| |Maldives| |Mali| |Malta| |Marshall_Islands| |Martinique| |Mauritania| |Mauritius| |Mayotte| |Mexico| |Micronesia_Federated_States_of| |Moldova_Republic_of| |Monaco| |Mongolia| |Montserrat| |Morocco| |Mozambique| |Myanmar| |Namibia| |Nauru| |Nepal| |Netherlands| |Netherlands_Antilles| |New_Caledonia| |New_Zealand| |Nicaragua| |Niger| |Nigeria| |Niue| |Norfolk_Island| |Northern_Mariana_Islands| |Norway| |Oman| |Pakistan| |Palau| |Palestinian_Territory| |Panama| |Papua_New_Guinea| |Paraguay| |Peru| |Philippines| |Pitcairn| |Poland| |Portugal| |Puerto_Rico| |Qatar| |Reunion| |Romania| |Russian_Federation| |Rwanda| |Saint_Helena| |Saint_Kitts_and_Nevis| |Saint_Lucia| |Saint_Pierre_and_Miquelon| |Saint_Vincent_and_the_Grenadines| |Samoa| |San_Marino| |Sao_Tome_and_Principe| |Saudi_Arabia| |Senegal| |Serbia_and_Montenegro| |Seychelles| |Sierra_Leone| |Singapore| |Slovakia| |Slovenia| |Solomon_Islands| |Somalia| |South_Africa| |South_Georgia_and_the_South_Sandwich_Islands| |Spain| |Sri_Lanka| |Sudan| |Suriname| |Svalbard_and_Jan_Mayen| |Swaziland| |Sweden| |Switzerland| |Syrian_Arab_Republic| |Taiwan_Province_of_China| |Tajikistan| |Tanzania_United_Republic_of| |Thailand| |Togo| |Tokelau| |Tonga| |Trinidad_and_Tobago| |Tunisia| |Turkey| |Turkmenistan| |Turks_and_Caicos_Islands| |Tuvalu| |Uganda| |Ukraine| |United_Arab_Emirates| |United_Kingdom| |United_States| |United_States_Minor_Outlying_Islands| |Uruguay| |Uzbekistan| |Vanuatu| |Venezuela| |Vietnam| |Virgin_Islands_British| |Virgin_Islands_US| |Wallis_and_Futuna| |Western_Sahara| |Yemen| |Yugoslavia| |Zambia| |Zimbabwe|

Last update

|key| |---| |anytime (default)| |past24Hours| |pastWeek| |pastMonth| |pastYear|

Safe search

|key| |---| |showExplicitResults (default)| |hideExplicitResults|

Terms appearing

|key| |---| |anywhereInThePage (default)| |inTheTitleOfThePage| |inTheTextOfThePage| |inTheUrlOfThePage| |inLinksToThePage|

File type

|key| |---| |any |pdf| |ps| |dwf| |kml| |kmz| |xls| |ppt| |doc| |rtf| |swf|

Usage rights

|key| |---| |freeToUseOrShare| |freeToUseOrShareCommercially| |freeToUseShareOrModify| |freeToUseShareOrModifyCommercially|