1.0.4 • Published 3 years ago
google-advanced-search v1.0.4
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-searchUsage
$ 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 commandQuick Start 1 (to use as a CLI tool)
Do google search with default filter settings
npx advsearchChange and save your filter settings
npx advsearch -c
Other options
Set a temporary filter (without appling it to the default filter settings)
npx advsearch -tDisplay the result URL without opening it in your browser
npx advsearch -nQuick 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 |