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
- 14 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, Europe PMC, and more
- Keyed engines (Brave, Bing, Tavily, Jina) ready when you set their API keys
- Async API (
search_async) for asyncio consumers; the native call releases the GIL
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, proxy=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 |
proxy |
str or None |
None |
Per-call outbound proxy (http, https, socks5, socks5h); None/"" keeps HTTP_PROXY/HTTPS_PROXY behavior |
Returns a dict with query, took_ms, results (list of ranked results).
Route a call through the host's proxy without touching the process environment:
result = mst.search("rust async runtime", proxy="socks5h://127.0.0.1:1080")
An explicit proxy is never silently bypassed (it wins over NO_PROXY) and
never falls back to direct egress if the proxy is unreachable. An invalid URL or
unsupported scheme raises MSTError(code="usage", exit_code=2).
await mst.search_async(...)
Async wrapper around mst.search() with the same arguments, return value, and
MSTError behavior. It is additive: existing consumers that call
asyncio.to_thread(mst.search, ...) keep working and can adopt the wrapper
later without a breaking change. It forwards the blocking native call to
asyncio.to_thread, so the event loop keeps running during a search. The native
CGO library releases the GIL, so concurrent search_async() calls overlap
instead of serializing.
import asyncio
import mst
async def main():
results = await asyncio.gather(
mst.search_async("rust async", limit=5),
mst.search_async("python asyncio", limit=5),
mst.search_async("go concurrency", limit=5),
)
for result in results:
print(result["query"], len(result["results"]))
asyncio.run(main())
Cancellation note: asyncio.wait_for(asyncio.shield(...)) and task cancellation
stop the await, not the native call. The timeout argument bounds the Go-side
search; a cancelled worker may finish in the background, and subsequent calls
are unaffected.
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.6.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Built distributions (wheels)
Total release size: 86.8 MB
Release files / mst_python-0.6.1-cp314-cp314-win_amd64.whl
| Download URL | mst_python-0.6.1-cp314-cp314-win_amd64.whl |
|---|---|
| Size | 6.5 MB |
| Tags | CPython 3.14 Windows x86-64 |
|
SHA-256 checksum How to use checksums |
70aab32067954d6d26be92030dcdda7b1505a457e7d7775cc05b86e7773c3cc4
|
|
BLAKE2b-256 checksum How to use checksums |
207149303eff24ba24991b68f97fc92483549da6b41c772a46a7d58d38593832
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.14.4
|
Release files / mst_python-0.6.1-cp314-cp314-manylinux_2_34_x86_64.whl
| Download URL | mst_python-0.6.1-cp314-cp314-manylinux_2_34_x86_64.whl |
|---|---|
| Size | 12.0 MB |
| Tags | CPython 3.14 Linux glibc 2.34+ x86-64 |
|
SHA-256 checksum How to use checksums |
2840dbb2da28b2f29da79d78f67bb77a10369d9d62b4d1337ee5a23a2d9c675e
|
|
BLAKE2b-256 checksum How to use checksums |
9da142b07e7a30b7e7b08b7e53bf79a6c31f29217f3dcd54dc135667887d5d47
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.14.4
|
Release files / mst_python-0.6.1-cp314-cp314-macosx_11_0_arm64.whl
| Download URL | mst_python-0.6.1-cp314-cp314-macosx_11_0_arm64.whl |
|---|---|
| Size | 3.3 MB |
| Tags | CPython 3.14 macOS 11.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
a672d0a4de052ccea7c9a4f29cbb5b42fb48a91ff414967352c48bcd4da4263f
|
|
BLAKE2b-256 checksum How to use checksums |
392eab05129e117761ab34da0797c7766eb4152365f5a45fffb6708c17c989f6
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.14.4
|
Release files / mst_python-0.6.1-cp313-cp313-win_amd64.whl
| Download URL | mst_python-0.6.1-cp313-cp313-win_amd64.whl |
|---|---|
| Size | 6.3 MB |
| Tags | CPython 3.13 Windows x86-64 |
|
SHA-256 checksum How to use checksums |
33496feb83cd00395b57ffd2000f5d56238fe4894dfdfd18e8f1ecd759365301
|
|
BLAKE2b-256 checksum How to use checksums |
70e263d752094d9c242b83934136e31dd3afef0c2d699c20956fe458ba69aab0
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.14.4
|
Release files / mst_python-0.6.1-cp313-cp313-manylinux_2_34_x86_64.whl
| Download URL | mst_python-0.6.1-cp313-cp313-manylinux_2_34_x86_64.whl |
|---|---|
| Size | 12.0 MB |
| Tags | CPython 3.13 Linux glibc 2.34+ x86-64 |
|
SHA-256 checksum How to use checksums |
f5dc04b168623097a60014ec2744c562466b87c4251ea6ae60be5245ebea8ba7
|
|
BLAKE2b-256 checksum How to use checksums |
d9038861541d277d3e73c2f0ad5176fffee7c0686e0d0a7d2be07a9bc6d8347c
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.14.4
|
Release files / mst_python-0.6.1-cp313-cp313-macosx_11_0_arm64.whl
| Download URL | mst_python-0.6.1-cp313-cp313-macosx_11_0_arm64.whl |
|---|---|
| Size | 3.3 MB |
| Tags | CPython 3.13 macOS 11.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
990156e94cf4d17a99e6e751d21e492f8968031e7bb9d5023ee3a224ad0a3022
|
|
BLAKE2b-256 checksum How to use checksums |
83d0ae872d2fe7ec4794e27a618e6be4e5b913a840d6fd3d995e886c34647710
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.14.4
|
Release files / mst_python-0.6.1-cp312-cp312-win_amd64.whl
| Download URL | mst_python-0.6.1-cp312-cp312-win_amd64.whl |
|---|---|
| Size | 6.3 MB |
| Tags | CPython 3.12 Windows x86-64 |
|
SHA-256 checksum How to use checksums |
b685b7bd044991ab249ef03d4d622a0fe867577b6e4235dbb5ff3d766ba4505d
|
|
BLAKE2b-256 checksum How to use checksums |
5c6497e6bb559412c9c162dd87426bc0909c37252f9e7cfa0ba0aa75fd6325a3
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.14.4
|
Release files / mst_python-0.6.1-cp312-cp312-manylinux_2_34_x86_64.whl
| Download URL | mst_python-0.6.1-cp312-cp312-manylinux_2_34_x86_64.whl |
|---|---|
| Size | 12.0 MB |
| Tags | CPython 3.12 Linux glibc 2.34+ x86-64 |
|
SHA-256 checksum How to use checksums |
aa835265dce9fb853998c9fba6f0fd9bccd565e9904dac6b372a4ec6f3b85442
|
|
BLAKE2b-256 checksum How to use checksums |
b8be0c8e74aa940f7997e7eec5feb74e45311f904a690e08b6fe4c998cce033a
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.14.4
|
Release files / mst_python-0.6.1-cp312-cp312-macosx_11_0_arm64.whl
| Download URL | mst_python-0.6.1-cp312-cp312-macosx_11_0_arm64.whl |
|---|---|
| Size | 3.3 MB |
| Tags | CPython 3.12 macOS 11.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
cbeefb9a2430830f8159bec3f5aa2a703575b8351b7c8af26e95187604d70f00
|
|
BLAKE2b-256 checksum How to use checksums |
ea5f2ff8e726ac7e940c6b71313a0706577ff8478ab4deaca92934d59029529d
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.14.4
|
Release files / mst_python-0.6.1-cp311-cp311-win_amd64.whl
| Download URL | mst_python-0.6.1-cp311-cp311-win_amd64.whl |
|---|---|
| Size | 6.3 MB |
| Tags | CPython 3.11 Windows x86-64 |
|
SHA-256 checksum How to use checksums |
dddc48a36d6a1a8ae2efa26d982ee9de4d600bcdc629ddc63f78e594b766c794
|
|
BLAKE2b-256 checksum How to use checksums |
a55906ec657e7d207949d57324cd809f4414813e0976f645fc43794513ef87b3
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.14.4
|
Release files / mst_python-0.6.1-cp311-cp311-manylinux_2_34_x86_64.whl
| Download URL | mst_python-0.6.1-cp311-cp311-manylinux_2_34_x86_64.whl |
|---|---|
| Size | 12.0 MB |
| Tags | CPython 3.11 Linux glibc 2.34+ x86-64 |
|
SHA-256 checksum How to use checksums |
e5e14acaad98c56a8ed3bfa429af15c321ee0f1d447f8afcf3bcb45877caaf59
|
|
BLAKE2b-256 checksum How to use checksums |
fce1efd7f6e2493b25cd57384bdfc11a2a101bedf7ce4aaccb3b9c3461a310c9
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.14.4
|
Release files / mst_python-0.6.1-cp311-cp311-macosx_11_0_arm64.whl
| Download URL | mst_python-0.6.1-cp311-cp311-macosx_11_0_arm64.whl |
|---|---|
| Size | 3.3 MB |
| Tags | CPython 3.11 macOS 11.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
2256e9d706f781392b17d98b994ea584158853eaebf21afdbb91c5ec12150cca
|
|
BLAKE2b-256 checksum How to use checksums |
c45a18a5bf1a4658508f210da2fa9370558ace63e11c8bad8a0f02dde32271e7
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.14.4
|
Security for mst-python 0.6.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.