sss@v3.0.0install ⏎
§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.

  1. 01Visit the site whose search you want to add.
  2. 02Search for the literal word TESTSEARCH in their search box.
  3. 03Copy the URL of the results page. It will contain TESTSEARCHsomewhere — that's the spot your real query goes.
  4. 04Replace TESTSEARCH with %s. Paste the result into the extension's "Search URL" field. Give the engine a name.
  5. 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 %s appears, the selected text is substituted.
  • If a site uses POST instead of GET for search, the %s technique 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.