whatisgithub

What is multi-search-aggregator?

chen150450/multi-search-aggregator — explained in plain English

Analysis updated 2026-05-18

43PythonAudience · developerComplexity · 2/5Setup · moderate

In one sentence

A tool that queries over 30 search engines at once and merges the results into one ranked list, built for AI agents and research workflows.

Mindmap

mindmap
  root((repo))
    What it does
      Queries 30+ engines at once
      Deduplicates by URL
      Ranks merged results
    Tech stack
      Python backend
      YAML config
      REST API and CLI
    Use cases
      Broad AI agent research
      Cross-engine search
      Streamed live results
    Audience
      Developers
      AI agent builders
      Researchers

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Run one query across Google, Bing, arXiv, Stack Overflow, Reddit, and dozens of other engines simultaneously

USE CASE 2

Connect an AI agent to the REST API for broad, deduplicated web research results

USE CASE 3

Stream search results in real time as each engine responds instead of waiting for the full batch

USE CASE 4

Filter and browse results engine by engine through the built-in web interface

What is it built with?

PythonYAMLREST API

How does it compare?

chen150450/multi-search-aggregatoralibaba/omnidoc-tokenbencharccalc/dwmfix
Stars434343
LanguagePythonPythonPython
Setup difficultymoderatemoderateeasy
Complexity2/53/52/5
Audiencedeveloperresearchergeneral

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

Requires Python 3.10+ and API keys for whichever engines you want enabled.

So what is it?

This is a tool that runs a single search query across more than 30 different search engines at the same time, then merges the results into one ranked list. Instead of picking one search source and hoping it covers the topic, it fires all of them in parallel and combines what comes back. The README says it was designed specifically for AI agents and research workflows where broad coverage matters. The engines span a wide range. General web search includes Google, Bing, Brave, Startpage, and Qwant. Academic sources include arXiv, OpenAlex, and DBLP. Developer-focused sources include Stack Overflow, npm, and MDN. Social platforms include Reddit and Hacker News. There are also several Chinese-language engines and AI-powered search services. Any engine that lacks an API key is simply skipped rather than causing an error. Results from all engines are deduplicated by URL, then scored using a combination of keyword relevance, how authoritative a given source is considered to be, how recent the result is, and vector-based semantic similarity. The top results are returned in a single list. A web interface (on port 8200 by default) lets you search through a browser with an engine filter sidebar. A REST API provides the same results as JSON. A streaming option sends progress updates in real time as each engine finishes, so you can see results arriving rather than waiting for the full batch. Configuration lives in a YAML file where you set engine weights, timeouts, and which engines are enabled. Changes take effect without restarting the server. Adding a new engine means writing a Python function that takes a query string and returns a list of result dictionaries, then registering it in a single file. Setup requires Python 3.10 or later. You clone the repo, install the Python dependencies, copy the example environment file, and add API keys for whichever engines you want. A command-line interface is also available for one-off searches without starting the web server.

Copy-paste prompts

Prompt 1
Configure this tool's YAML file to enable only the academic and developer search engines
Prompt 2
Write a Python function that adds a new custom search engine to this aggregator
Prompt 3
Explain how this tool scores and deduplicates results from multiple search engines
Prompt 4
Set up the REST API from this repo so my agent can call it for research queries

Frequently asked questions

What is multi-search-aggregator?

A tool that queries over 30 search engines at once and merges the results into one ranked list, built for AI agents and research workflows.

What language is multi-search-aggregator written in?

Mainly Python. The stack also includes Python, YAML, REST API.

How hard is multi-search-aggregator to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is multi-search-aggregator for?

Mainly developer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.