§03$ sss.engine.add()
Custom search engines: any site with a search box.
The extension ships with a catalog of popular engines, but the real unlock is custom engines — any site with its own search becomes a right-click target in under a minute.
§03.1
The %s template
Most search engines accept the query in their URL. To add one as a custom engine, you just need the URL of a search result, with your search term replaced by the placeholder %s. The extension substitutes your selected text for %s at search time.
- 01Visit the site whose search you want to add.
- 02Search for the literal word
TESTSEARCHin their search box. - 03Copy the URL of the results page. It will contain
TESTSEARCHsomewhere — that's the spot your real query goes. - 04Replace
TESTSEARCHwith%s. Paste the result into the extension's "Search URL" field. Give the engine a name. - 05You're done — the new engine appears in the right-click menu on every page from now on.
§03.2
Examples to get you started
A few common ones, ready to paste:
- GitHub code search:
https://github.com/search?q=%s&type=code - Reddit:
https://www.reddit.com/search/?q=%s - Stack Overflow:
https://stackoverflow.com/search?q=%s - MDN:
https://developer.mozilla.org/en-US/search?q=%s - Wikipedia:
https://en.wikipedia.org/w/index.php?search=%s - ChatGPT:
https://chatgpt.com/?q=%s - Hacker News (via Algolia):
https://hn.algolia.com/?q=%s
§03.3
The catalog
The Options page also has a browse-and-add catalog of popular engines — one click adds Wikipedia or Google Scholar or YouTube to your current set. The catalog is a convenience; the custom-engine builder above is what makes the extension actually open-ended.
§03.4
Tips
- →URLs with multiple placeholders work too — anywhere
%sappears, the selected text is substituted. - →If a site uses POST instead of GET for search, the
%stechnique won't work directly. Check whether the site has a URL-based search anywhere else; most do. - →You can group engines and nest groups to keep your right-click menu tidy.