Skip to content

search.md

Latest commit

 

History

History
65 lines (44 loc) · 2.47 KB

search.md

File metadata and controls

65 lines (44 loc) · 2.47 KB

Searching with Augmenta

Augmenta supports several search engines out of the box, with more available as MCP servers.

Some search engines have a rate limit, meaning they will only allow a certain number of searches in a given time period. You can configure Augmenta to respect this rate limit by setting the rate_limit parameter in your configuration file.

DuckDuckGo

DuckDuckGo is a privacy-focused search engine, and the simplest to get started with, as you don't need an API key.

search:
  engine: duckduckgo
  results: 10
  region: uk-en # optional, one of https://github.com/deedy5/duckduckgo_search?tab=readme-ov-file#regions
  safesearch: off # on, moderate, off. Defaults to "moderate".

In my experience, DuckDuckGo can be unreliable and will often refuse to return results. Additionally, the search results are sometimes subpar. I recommend you only use it for testing.

Brave

Brave is another privacy-focused search engine. You will need to sign up for a free API key, which will give you 2,000 free searches per month, or you can pay for more.

search:
  engine: brave
  country: GB  # optional, one of https://api-dashboard.search.brave.com/app/documentation/web-search/codes#country-codes
  results: 10
  rate_limit: 2 # brave has a rate limit

To use Brave, you will need to set the BRAVE_API_KEY environment variable to your API key.

BRAVE_API_KEY=XXXXX

Google

Google is the most powerful and highest-quality search engine, but it is limited to just 100 free searches per day. Additional requests cost $5 per 1000 queries, up to 10k queries per day.

search:
  engine: google
  results: 10
  lr: lang_ro # optional, restricts results to pages in the specified language

You can find the full list of optional parameters here.

You will need an API key and a custom search ID (CX) to use Google search. Get them by following the instructions here, and save them to your .env.

GOOGLE_API_KEY=XXXXX
GOOGLE_CX=XXXXX

Google provides the best search results, but it is also by far the most expensive.

Oxylabs

Oxylabs is a proxy provider that offers a search API. You will need to sign up for an account and get an API key.

instuctions coming soon