sopel-search

Search plugin for Sopel IRC bots

Installing

Releases are hosted on PyPI, so after installing Sopel, all you need is pip:

$ pip install sopel-search

Google query suggestions

If you want users to be able to fetch query suggestions from Google using the .gsuggest command, you will need the gsuggest extra:

$ pip install sopel-search[gsuggest]

Configuring

The easiest way to configure sopel-search is via Sopel's configuration wizard—simply run sopel-plugins configure search and enter the values for which it prompts you. Available settings are:

• region: Set this to the primary geographical region of your bot's users, using one of the values from https://duckduckgo.com/params

  Setting this correctly may improve the relevance of both search results and query suggestions using .suggest.

• safesearch: Controls SafeSearch filtering of .search results; one of 'on', 'moderate', and 'off'.

Changelog

1.1.0

• Handle common errors with some amount of grace (#4)
• Refresh the DDGS client periodically to reduce errors (#5)

1.0.1

Bump DuckDuckGo library minimum version; older releases stopped working.

1.0.0

First release of sopel-search.

This new search plugin apes a lot of behaviors from Sopel's built-in search, with the following notable changes:

• .bing is no longer available
• .search is an alias to .ddg, as .g was already
• Search region and safesearch level are now configurable
• .suggest uses DuckDuckGo; Google suggestions are still available via the new .gsuggest command (if optional extra dependencies are installed)