Skip to main content

mst-python — Meta Search Tool (Python bindings)

Release PyPI Python Versions

CGO Python bindings for mst — a concurrent multi-engine web search tool with transparent RRF ranking. Fan out to 12+ engines in parallel, get merged JSON results with scores. No server, no setup.

import mst

# Search across all enabled engines
result = mst.search("rust async runtime comparison")

# Or pick specific engines
result = mst.search("riscv paging", engines=["ddg", "google"], limit=10)

print(f"Found {len(result['results'])} results in {result['took_ms']}ms")
for r in result['results']:
    print(f"  #{r['rank']}  {r['title']}  (score={r['score']})")

Features

  • 12 engines across general web, academic, reference, Q&A, and AI categories
  • Concurrent fan-out with per-engine timeouts — a slow engine never blocks the run
  • RRF ranking with configurable per-engine weights and smoothing constant
  • Keyless engines work out of the box: DuckDuckGo, Google, Wikipedia, arXiv, and more
  • Keyed engines (Brave, Bing, Tavily) ready when you set their API keys

Installation

pip install mst-python

Works on Linux (manylinux_2_34 x86_64) and macOS (Apple Silicon arm64).

Quick start

import mst

# List all engines and their status
engines = mst.list_engines()
for e in engines:
    print(f"{e['name']:20s}  {e['status']:15s}  weight={e['weight']}")

# Run a search
result = mst.search("python asyncio vs threading", limit=5)
print(result)

API

mst.search(query, engines=None, limit=10, offset=0, rrf_k=60, timeout="8s", weights=None)

Param Type Default Description
query str — Search query
engines list[str] or None None Engine whitelist (None = all enabled engines)
limit int 10 Max merged results (1–100)
offset int 0 Skip first N results
rrf_k int 60 RRF smoothing constant
timeout str "8s" Per-engine timeout duration
weights dict[str, float] or None None Per-engine weight overrides

Returns a dict with query, took_ms, results (list of ranked results).

mst.list_engines()

Returns a list of engine dicts with name, enabled, keyed, weight, category, status.

mst.__version__

Package version string (derived from the release tag when installed via PyPI).

Requirements

  • Python ≥ 3.11
  • Linux (x86_64, glibc ≥ 2.34) or macOS (arm64)

No runtime dependencies — the CGO shared library is bundled in the wheel.

License

Apache-2.0. See LICENSE.

Metadata

Release files for mst-python 0.4.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Built distributions (wheels)

Table of built distributions (wheels) for mst-python 0.4.1
File Actions
mst_python-0.4.1-cp313-cp313-manylinux_2_34_x86_64.whl CPython 3.13 CPython 3.13 Linux glibc 2.34+ x86-64 Details for mst_python-0.4.1-cp313-cp313-manylinux_2_34_x86_64.whl
mst_python-0.4.1-cp313-cp313-macosx_14_0_universal2.whl CPython 3.13 CPython 3.13 macOS 14.0+ universal2 (ARM64, x86-64) Details for mst_python-0.4.1-cp313-cp313-macosx_14_0_universal2.whl
mst_python-0.4.1-cp312-cp312-manylinux_2_34_x86_64.whl CPython 3.12 CPython 3.12 Linux glibc 2.34+ x86-64 Details for mst_python-0.4.1-cp312-cp312-manylinux_2_34_x86_64.whl
mst_python-0.4.1-cp312-cp312-macosx_14_0_universal2.whl CPython 3.12 CPython 3.12 macOS 14.0+ universal2 (ARM64, x86-64) Details for mst_python-0.4.1-cp312-cp312-macosx_14_0_universal2.whl
mst_python-0.4.1-cp311-cp311-manylinux_2_34_x86_64.whl CPython 3.11 CPython 3.11 Linux glibc 2.34+ x86-64 Details for mst_python-0.4.1-cp311-cp311-manylinux_2_34_x86_64.whl
mst_python-0.4.1-cp311-cp311-macosx_14_0_universal2.whl CPython 3.11 CPython 3.11 macOS 14.0+ universal2 (ARM64, x86-64) Details for mst_python-0.4.1-cp311-cp311-macosx_14_0_universal2.whl

Total release size: 44.8 MB

Release files / mst_python-0.4.1-cp313-cp313-manylinux_2_34_x86_64.whl

Download URL mst_python-0.4.1-cp313-cp313-manylinux_2_34_x86_64.whl
Size 11.9 MB
Tags CPython 3.13 Linux glibc 2.34+ x86-64
SHA-256 checksum
How to use checksums
9aee7ef5a1ff0e5c410e191dbf9c8ad47613664bebc171a29ad452b68c1743f5
BLAKE2b-256 checksum
How to use checksums
6f22479120d68a23ec72c2b797128789950a4ece6e76b542dbc9268f0e550cf5
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.12.3

Release files / mst_python-0.4.1-cp313-cp313-macosx_14_0_universal2.whl

Download URL mst_python-0.4.1-cp313-cp313-macosx_14_0_universal2.whl
Size 3.1 MB
Tags CPython 3.13 macOS 14.0+ universal2 (ARM64, x86-64)
SHA-256 checksum
How to use checksums
0518c6ebf1ba6f9864816929e09095889722136c8a5bbb5e38eec10dd2598cf5
BLAKE2b-256 checksum
How to use checksums
ed95de77fd39fd1aa4c0381c9b173f1323cbb5c6ee477c6f204a3d5acfe10eaf
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.12.3

Release files / mst_python-0.4.1-cp312-cp312-manylinux_2_34_x86_64.whl

Download URL mst_python-0.4.1-cp312-cp312-manylinux_2_34_x86_64.whl
Size 11.9 MB
Tags CPython 3.12 Linux glibc 2.34+ x86-64
SHA-256 checksum
How to use checksums
49743eee8f1103fce92c3e75c2cc6a86b489fedffe23bd64203e381b9972eb74
BLAKE2b-256 checksum
How to use checksums
3822fcf16e05f08f0c7a57cffd9b168cf96eca162e5d26046a682eda3b83c15c
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.12.3

Release files / mst_python-0.4.1-cp312-cp312-macosx_14_0_universal2.whl

Download URL mst_python-0.4.1-cp312-cp312-macosx_14_0_universal2.whl
Size 3.1 MB
Tags CPython 3.12 macOS 14.0+ universal2 (ARM64, x86-64)
SHA-256 checksum
How to use checksums
5b29467b522a4e69f6a62a448037fc17ab39ed15d3e83936e877c2bbecd7aa06
BLAKE2b-256 checksum
How to use checksums
4ff8f2aa58da32673665ef0fa119e0a05583742b95b15f9d147882461aa8785a
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.12.3

Release files / mst_python-0.4.1-cp311-cp311-manylinux_2_34_x86_64.whl

Download URL mst_python-0.4.1-cp311-cp311-manylinux_2_34_x86_64.whl
Size 11.9 MB
Tags CPython 3.11 Linux glibc 2.34+ x86-64
SHA-256 checksum
How to use checksums
092d5934c7895c814738d7ae414354b7fffcf7bacbb6c6a5c25fa5d11098cd01
BLAKE2b-256 checksum
How to use checksums
6ec98932fb404f226abe968ba1fdb81429c81fdabd2a9ecaa0c4b4a6fb196dbe
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.12.3

Release files / mst_python-0.4.1-cp311-cp311-macosx_14_0_universal2.whl

Download URL mst_python-0.4.1-cp311-cp311-macosx_14_0_universal2.whl
Size 3.1 MB
Tags CPython 3.11 macOS 14.0+ universal2 (ARM64, x86-64)
SHA-256 checksum
How to use checksums
4209da8a9097a6ccaa6720d701348a4fb7e8e8ead90c44e81120007b8a509190
BLAKE2b-256 checksum
How to use checksums
a9300817546fd5cc151bdc17497ea98a934fe4026d2d7bae56469d121995e53d
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.12.3

Security for mst-python 0.4.1

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page