mst-python — Meta Search Tool (Python bindings)
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)
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.