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.2

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.2
File Actions
mst_python-0.4.2-cp314-cp314-win_amd64.whl CPython 3.14 CPython 3.14 Windows x86-64 Details for mst_python-0.4.2-cp314-cp314-win_amd64.whl
mst_python-0.4.2-cp314-cp314-manylinux_2_34_x86_64.whl CPython 3.14 CPython 3.14 Linux glibc 2.34+ x86-64 Details for mst_python-0.4.2-cp314-cp314-manylinux_2_34_x86_64.whl
mst_python-0.4.2-cp314-cp314-macosx_14_0_universal2.whl CPython 3.14 CPython 3.14 macOS 14.0+ universal2 (ARM64, x86-64) Details for mst_python-0.4.2-cp314-cp314-macosx_14_0_universal2.whl
mst_python-0.4.2-cp313-cp313-win_amd64.whl CPython 3.13 CPython 3.13 Windows x86-64 Details for mst_python-0.4.2-cp313-cp313-win_amd64.whl
mst_python-0.4.2-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.2-cp313-cp313-manylinux_2_34_x86_64.whl
mst_python-0.4.2-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.2-cp313-cp313-macosx_14_0_universal2.whl
mst_python-0.4.2-cp312-cp312-win_amd64.whl CPython 3.12 CPython 3.12 Windows x86-64 Details for mst_python-0.4.2-cp312-cp312-win_amd64.whl
mst_python-0.4.2-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.2-cp312-cp312-manylinux_2_34_x86_64.whl
mst_python-0.4.2-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.2-cp312-cp312-macosx_14_0_universal2.whl
mst_python-0.4.2-cp311-cp311-win_amd64.whl CPython 3.11 CPython 3.11 Windows x86-64 Details for mst_python-0.4.2-cp311-cp311-win_amd64.whl
mst_python-0.4.2-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.2-cp311-cp311-manylinux_2_34_x86_64.whl
mst_python-0.4.2-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.2-cp311-cp311-macosx_14_0_universal2.whl

Total release size: 82.8 MB

Release files / mst_python-0.4.2-cp314-cp314-win_amd64.whl

Download URL mst_python-0.4.2-cp314-cp314-win_amd64.whl
Size 5.8 MB
Tags CPython 3.14 Windows x86-64
SHA-256 checksum
How to use checksums
35972d1b4b04f4a50ed3931a14b98e97e6d029e612f601e1d1b6aee7c31d1e97
BLAKE2b-256 checksum
How to use checksums
5dd3eed59b04897315c658663686d168152fb0b8bc3ecde10d230a449df45717
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.2-cp314-cp314-manylinux_2_34_x86_64.whl

Download URL mst_python-0.4.2-cp314-cp314-manylinux_2_34_x86_64.whl
Size 11.9 MB
Tags CPython 3.14 Linux glibc 2.34+ x86-64
SHA-256 checksum
How to use checksums
4766acc0cbd1a6f46b8fead7120c7dd55449ae2c43d3c861899aa60e9dc1a380
BLAKE2b-256 checksum
How to use checksums
aefa5eee5781ed4b25d7b99cfb6b0a67c2b03e545523c47c8c5583bf306daa24
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.2-cp314-cp314-macosx_14_0_universal2.whl

Download URL mst_python-0.4.2-cp314-cp314-macosx_14_0_universal2.whl
Size 3.1 MB
Tags CPython 3.14 macOS 14.0+ universal2 (ARM64, x86-64)
SHA-256 checksum
How to use checksums
581908219226088988981ed48274bb0b51434f6eea5a11468a4afd739573b8e5
BLAKE2b-256 checksum
How to use checksums
b5bd370522a7817d4dcac0a4de8514f72de5916087c91f72107e667dbe2f7ea5
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.2-cp313-cp313-win_amd64.whl

Download URL mst_python-0.4.2-cp313-cp313-win_amd64.whl
Size 5.7 MB
Tags CPython 3.13 Windows x86-64
SHA-256 checksum
How to use checksums
f4f9a46032f4480091e5679cacae6cfa9316939e8dceb55bef61da19490257d6
BLAKE2b-256 checksum
How to use checksums
1212920ff2b278078968f47934398cdbec886055b847e513f0853093d05af10e
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.2-cp313-cp313-manylinux_2_34_x86_64.whl

Download URL mst_python-0.4.2-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
bc989d8fd90aa4cef1eb50eb8f10d5cedc23ed666879e8ebd6b0f49811c09ebe
BLAKE2b-256 checksum
How to use checksums
9f9ab39c6874120ddcb96d45d8ee15a2740afd2ec7ba233ee67493d44da48672
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.2-cp313-cp313-macosx_14_0_universal2.whl

Download URL mst_python-0.4.2-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
9ec614f4189d3b6de2b2352ca76f1fa6bf3e48add6d30bf05db354e6cd50e921
BLAKE2b-256 checksum
How to use checksums
48d44de468311498143380069eefc03e9fc346902c0e53fe6b751001f1a6df5a
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.2-cp312-cp312-win_amd64.whl

Download URL mst_python-0.4.2-cp312-cp312-win_amd64.whl
Size 5.7 MB
Tags CPython 3.12 Windows x86-64
SHA-256 checksum
How to use checksums
f57062bcbfbbc9de3ba8bbbd989b76499f054efaab518954418c7243b123536e
BLAKE2b-256 checksum
How to use checksums
93be0ec1d299c69fde773093b71b6552af5b9aa4842b0c00bc1fffede5750237
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.2-cp312-cp312-manylinux_2_34_x86_64.whl

Download URL mst_python-0.4.2-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
3b40b090b1dbb7bdfe6d0587f1fd2e1d1b781bcef1a06c17624e607e49832e8b
BLAKE2b-256 checksum
How to use checksums
ddc51f8a9b361fab82aa92c814d8b5b7e56f9c9d1d14eb1c6d40e2e41ef76bfc
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.2-cp312-cp312-macosx_14_0_universal2.whl

Download URL mst_python-0.4.2-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
a356e76604753ddeade0014b5c9ce1b912b13afedd346aff5855e5c63f769321
BLAKE2b-256 checksum
How to use checksums
8b82cffc57d057e0c6a65dbe7973ee73e36077d2044d758f03d146bdc5e61476
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.2-cp311-cp311-win_amd64.whl

Download URL mst_python-0.4.2-cp311-cp311-win_amd64.whl
Size 5.7 MB
Tags CPython 3.11 Windows x86-64
SHA-256 checksum
How to use checksums
aff7bf6ac5a13cc03d62717dedc06f08f9ba93777a4b15fd8afc3dae48fad8bb
BLAKE2b-256 checksum
How to use checksums
55e6819ad85c032c0ac0ab7eb98fd6af310c8b665180e4058d7ef060e8459ec4
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.2-cp311-cp311-manylinux_2_34_x86_64.whl

Download URL mst_python-0.4.2-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
e58048274b2afd4d3c1cf338c6dde3a3ef2a95bfc0d740b01d16bbe51cd9acbb
BLAKE2b-256 checksum
How to use checksums
4fbfe414685b0ca6bb40afb12db60cabec9f0fb21f70a628eed394fe9620d713
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.2-cp311-cp311-macosx_14_0_universal2.whl

Download URL mst_python-0.4.2-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
ad8d573fc3ccbf4bb9ff96e93b7ba39720dac621cd20c812cdc1dcbad3a2813e
BLAKE2b-256 checksum
How to use checksums
7d1a4506c8fd3688d47901d7ebdda9d2e322055c684258622fd3bd5c3f2943d6
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.2

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