Metasearch: A self-hosted metasearch engine

mrunix1 pts0 comments

GitHub - tiagozip/metasearch: search the web without slop. pretty, fast, privacy-friendly metasearch engine. · GitHub

/" data-turbo-transient="true" />

Skip to content

Search or jump to...

Search code, repositories, users, issues, pull requests...

-->

Search

Clear

Search syntax tips

Provide feedback

--><br>We read every piece of feedback, and take your input very seriously.

Include my email address so I can be contacted

Cancel

Submit feedback

Saved searches

Use saved searches to filter your results more quickly

-->

Name

Query

To see all available qualifiers, see our documentation.

Cancel

Create saved search

Sign in

/;ref_cta:Sign up;ref_loc:header logged out"}"<br>Sign up

Appearance settings

Resetting focus

You signed in with another tab or window. Reload to refresh your session.<br>You signed out in another tab or window. Reload to refresh your session.<br>You switched accounts on another tab or window. Reload to refresh your session.

Dismiss alert

{{ message }}

tiagozip

metasearch

Public

Notifications<br>You must be signed in to change notification settings

Fork

Star<br>18

main

BranchesTags

Go to file

CodeOpen more actions menu

Folders and files<br>NameNameLast commit message<br>Last commit date<br>Latest commit

History<br>74 Commits<br>74 Commits

.zed

.zed

migrations

migrations

public

public

scripts

scripts

src

src

.dev.vars

.dev.vars

.env.example

.env.example

.gitignore

.gitignore

LICENSE

LICENSE

README.md

README.md

biome.json

biome.json

bun.lock

bun.lock

package.json

package.json

wrangler.toml

wrangler.toml

x.txt

x.txt

View all files

Repository files navigation

search the web without AI slop. pretty, fast,<br>privacy-friendly metasearch engine.

start searching! »

search.tiago.zip is a lightweight yet powerful metasearch engine focused on user privacy and performance. it sources data from brave search and solves challenges to provide comprehensive answers without tracking or storing user data.

private by design

no tracking is used by default, and you can search the web with no cookies or accounts.

we do not log any type of data and your searches are never stored or analyzed.

bangs, rich answers, snippets

similar to duckduckgo, you can use !bangs to search other sites directly. instant answers for calculations, weather, crypto prices, and more are available right on the results page. we also show previews for lyrics, youtube views, and more.

fast and better dx

unlike html-only search engines, we start by serving css and html, only sending answers in js later, which results in a much better experience.

most keyboard shortcuts are also supported, and the image tab supports a built-in ai slop remover. on chromium-based browsers, you'll also benefit from view transitions between tabs.

rich answers & maps

we implement most of brave's rich answer features, including calculator, color picker, timer, weather, cryptocurrency prices, and more.

json api

once the instance author enables it, you can query the engine over a simple authenticated endpoint and get clean JSON back, no scraping required:

curl -X POST https://search.tiago.zip/api \<br>-H "Authorization: Bearer YOUR_KEY" \<br>-H "Content-Type: application/json" \<br>-d '{"query":"metasearch","type":"web","page":0}'

type is one of web, images, or news (defaults to web), and page is a zero-based offset with no cap. keys live in a D1 database (one row per key, so you can label and revoke them individually):

wrangler d1 create metasearch # paste the id into wrangler.toml<br>wrangler d1 migrations apply metasearch --remote

KEY=$(openssl rand -hex 32)<br>wrangler d1 execute metasearch --remote \<br>--command "INSERT INTO api_keys (key, label) VALUES ('$KEY', 'alice')"

full docs live at /api.

self-hosting

metasearch runs on cloudflare workers with static assets. to self-host:

# clone and install<br>git clone https://github.com/tiagozip/metasearch.git<br>cd metasearch<br>bun install

# set your jwt secret (used to sign search tokens)<br>wrangler secret put JWT_SECRET

# deploy to cloudflare workers<br>bun run deploy

updating bangs

bangs are embedded in the bundle for zero-latency lookups. to refresh them:

bun run bangs<br>bun run deploy

local development

.env

# start local dev server<br>bun run dev"># create a .env file with a dev secret<br>echo 'JWT_SECRET=dev-secret' > .env

# start local dev server<br>bun run dev

custom domain

after deploying, you can add a custom domain in the cloudflare dashboard under workers & pages > metasearch > settings > domains & routes.

license

all code is licensed under aGPL-v3.0. see LICENSE for more details.

About

search the web without slop. pretty, fast, privacy-friendly metasearch engine.

search.tiago.zip

Topics

metasearch

bun

Resources

Readme

License

AGPL-3.0 license

Uh oh!

There was an error while loading. Please reload this page.

Activity

Stars

18<br>stars

Watchers

watching

Forks

forks

Report repository

Contributors

Uh oh!

There was an error while loading. Please reload this...

metasearch search json wrangler engine license

Related Articles