view release on metacpan or  search on metacpan

.env.example  view on Meta::CPAN

# Copy to .env and fill in what you have. The live test (t/50-live.t) and
# ex/search.pl read these variables. All TEST_WEBSEARCH_* vars are OPT-IN —
# without any of them set, no live network calls happen.

# Keyless — opts into the DuckDuckGo + Reddit (public) live tests AND into
# the combined aggregation-plus-fetch test. Set this ALONGSIDE any paid
# key vars below if you want keyless tests to run as well.
TEST_WEBSEARCH_LIVE=1

# SearxNG (self-hosted, see ex/docker-compose.searxng.yml)
# TEST_WEBSEARCH_SEARXNG_ENDPOINT=http://10.5.5.222:8888
# TEST_WEBSEARCH_SEARXNG_API_KEY=

# Brave Search API — https://brave.com/search/api/ → api.search.brave.com/app/dashboard
# Free tier in 2026: $5 in credits per month (= ~1000 queries/month at
# $5/1000). Plan selection is mandatory on signup, even for the free
# usage. Credit card required on signup as an anti-fraud check.
# TEST_WEBSEARCH_BRAVE_API_KEY=

# Serper.dev — https://serper.dev (key shown in the dashboard after signup)
# 2500 free queries on signup, no credit card.
# TEST_WEBSEARCH_SERPER_API_KEY=

# Google Programmable Search
#   - Create a PSE at https://programmablesearchengine.google.com
#     (you can flip "Search features" → "Search the entire web" on;
#     the toggle is a bit buried)
#   - Enable the Custom Search API and mint an API key in Google Cloud
#     Console. Free: 100 queries/day, paid $5/1000 up to 10k/day.
# TEST_WEBSEARCH_GOOGLE_API_KEY=
# TEST_WEBSEARCH_GOOGLE_CX=

# Yandex Search API
#   Signup: https://console.yandex.cloud/link/search-api/
#   Docs:   https://yandex.cloud/en/docs/search-api/
# Requires a Yandex Cloud account + folder + service account with the
# role search-api.executor. There is a free trial (Cloud credits).
# TEST_WEBSEARCH_YANDEX_API_KEY=
# TEST_WEBSEARCH_YANDEX_FOLDERID=

# Reddit OAuth — https://www.reddit.com/prefs/apps
# Free. Create an app (type "script" works). 100 QPM per client_id.
# TEST_WEBSEARCH_REDDIT_CLIENT_ID=
# TEST_WEBSEARCH_REDDIT_CLIENT_SECRET=
# TEST_WEBSEARCH_REDDIT_USER_AGENT="net-async-websearch-tests/0.001 by /u/YOURNAME"