Skip to content

cse-bridge 1.0.1

Choose a tag to compare

@Booyaka101 Booyaka101 released this 03 Aug 12:17
· 26 commits to main since this release

First public release of cse-bridge: a self-hosted drop-in for Google's Custom Search JSON API (retiring 2027-01-01), backed by your own SearXNG instance.

  • GET /customsearch/v1 returns a Google-exact customsearch#search body
  • Unmodified @googleapis/customsearch, google-api-python-client and LangChain GoogleSearchAPIWrapper clients work by changing only the endpoint
  • Honest lower-bound totalResults (SearXNG's JSON has no count field)
  • Stable per-query result sets so start=1/11/21 pages are disjoint
  • Google-exact error envelopes (400/403/404/429/503)
  • cx -> engine/category/site profiles via profiles.yml
  • docker compose up -d brings up SearXNG (json format pre-enabled) + the bridge

Install: npm i -g cse-bridge, or docker pull ghcr.io/booyaka101/cse-bridge:1.0.1

1.0.1 fixes the GHCR image name casing in docker-compose.yml (1.0.0's compose file failed on clean clones).