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

  • 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)

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

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

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.5.0
File Actions
mst_python-0.5.0-cp314-cp314-win_amd64.whl CPython 3.14 CPython 3.14 Windows x86-64 Details for mst_python-0.5.0-cp314-cp314-win_amd64.whl
mst_python-0.5.0-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.5.0-cp314-cp314-manylinux_2_34_x86_64.whl
mst_python-0.5.0-cp314-cp314-macosx_26_0_universal2.whl CPython 3.14 CPython 3.14 macOS 26.0+ universal2 (ARM64, x86-64) Details for mst_python-0.5.0-cp314-cp314-macosx_26_0_universal2.whl
mst_python-0.5.0-cp314-cp314-macosx_11_0_universal2.whl CPython 3.14 CPython 3.14 macOS 11.0+ universal2 (ARM64, x86-64) Details for mst_python-0.5.0-cp314-cp314-macosx_11_0_universal2.whl
mst_python-0.5.0-cp314-cp314-macosx_11_0_arm64.whl CPython 3.14 CPython 3.14 macOS 11.0+ ARM64 Details for mst_python-0.5.0-cp314-cp314-macosx_11_0_arm64.whl
mst_python-0.5.0-cp313-cp313-win_amd64.whl CPython 3.13 CPython 3.13 Windows x86-64 Details for mst_python-0.5.0-cp313-cp313-win_amd64.whl
mst_python-0.5.0-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.5.0-cp313-cp313-manylinux_2_34_x86_64.whl
mst_python-0.5.0-cp313-cp313-macosx_26_0_universal2.whl CPython 3.13 CPython 3.13 macOS 26.0+ universal2 (ARM64, x86-64) Details for mst_python-0.5.0-cp313-cp313-macosx_26_0_universal2.whl
mst_python-0.5.0-cp313-cp313-macosx_11_0_universal2.whl CPython 3.13 CPython 3.13 macOS 11.0+ universal2 (ARM64, x86-64) Details for mst_python-0.5.0-cp313-cp313-macosx_11_0_universal2.whl
mst_python-0.5.0-cp313-cp313-macosx_11_0_arm64.whl CPython 3.13 CPython 3.13 macOS 11.0+ ARM64 Details for mst_python-0.5.0-cp313-cp313-macosx_11_0_arm64.whl
mst_python-0.5.0-cp312-cp312-win_amd64.whl CPython 3.12 CPython 3.12 Windows x86-64 Details for mst_python-0.5.0-cp312-cp312-win_amd64.whl
mst_python-0.5.0-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.5.0-cp312-cp312-manylinux_2_34_x86_64.whl
mst_python-0.5.0-cp312-cp312-macosx_26_0_universal2.whl CPython 3.12 CPython 3.12 macOS 26.0+ universal2 (ARM64, x86-64) Details for mst_python-0.5.0-cp312-cp312-macosx_26_0_universal2.whl
mst_python-0.5.0-cp312-cp312-macosx_11_0_universal2.whl CPython 3.12 CPython 3.12 macOS 11.0+ universal2 (ARM64, x86-64) Details for mst_python-0.5.0-cp312-cp312-macosx_11_0_universal2.whl
mst_python-0.5.0-cp312-cp312-macosx_11_0_arm64.whl CPython 3.12 CPython 3.12 macOS 11.0+ ARM64 Details for mst_python-0.5.0-cp312-cp312-macosx_11_0_arm64.whl
mst_python-0.5.0-cp311-cp311-win_amd64.whl CPython 3.11 CPython 3.11 Windows x86-64 Details for mst_python-0.5.0-cp311-cp311-win_amd64.whl
mst_python-0.5.0-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.5.0-cp311-cp311-manylinux_2_34_x86_64.whl
mst_python-0.5.0-cp311-cp311-macosx_26_0_universal2.whl CPython 3.11 CPython 3.11 macOS 26.0+ universal2 (ARM64, x86-64) Details for mst_python-0.5.0-cp311-cp311-macosx_26_0_universal2.whl
mst_python-0.5.0-cp311-cp311-macosx_11_0_universal2.whl CPython 3.11 CPython 3.11 macOS 11.0+ universal2 (ARM64, x86-64) Details for mst_python-0.5.0-cp311-cp311-macosx_11_0_universal2.whl
mst_python-0.5.0-cp311-cp311-macosx_11_0_arm64.whl CPython 3.11 CPython 3.11 macOS 11.0+ ARM64 Details for mst_python-0.5.0-cp311-cp311-macosx_11_0_arm64.whl

Total release size: 112.8 MB

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

Download URL mst_python-0.5.0-cp314-cp314-win_amd64.whl
Size 6.4 MB
Tags CPython 3.14 Windows x86-64
SHA-256 checksum
How to use checksums
7a54e7202a2c9237533bd6337a39d8e1faf8f1476ad15f2e6f850ec862d4ac8e
BLAKE2b-256 checksum
How to use checksums
e9e44808c443e60db3588cd3b3de1b2421aaec3631263721647802ab3fe54dad
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.5.0-cp314-cp314-manylinux_2_34_x86_64.whl

Download URL mst_python-0.5.0-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
4e710e49c71d7bdd6fbd0d75bf06984273ffd917c71650f905220e883660bdd7
BLAKE2b-256 checksum
How to use checksums
f050bdc50678c9ff920396e14e1f81223db07cb4822d23132a6ac7706a855c20
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.5.0-cp314-cp314-macosx_26_0_universal2.whl

Download URL mst_python-0.5.0-cp314-cp314-macosx_26_0_universal2.whl
Size 3.3 MB
Tags CPython 3.14 macOS 26.0+ universal2 (ARM64, x86-64)
SHA-256 checksum
How to use checksums
005a2f69495490cbc931a2b91d03d06cd3f36bf5405d6e1e21dca97302d943f2
BLAKE2b-256 checksum
How to use checksums
a88fd2b972703a09908c366383968bd69718a7e700b0f993719e2d3a54b4eb67
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.5.0-cp314-cp314-macosx_11_0_universal2.whl

Download URL mst_python-0.5.0-cp314-cp314-macosx_11_0_universal2.whl
Size 3.3 MB
Tags CPython 3.14 macOS 11.0+ universal2 (ARM64, x86-64)
SHA-256 checksum
How to use checksums
e70d176ae6717c6df96e80f8f9148a06c61a32ffd5f05f7d11f68869ccac685d
BLAKE2b-256 checksum
How to use checksums
10b64e24acf99220e3c2f7bb3ab54bf7150c56655e57c5292784cd279ca63152
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.5.0-cp314-cp314-macosx_11_0_arm64.whl

Download URL mst_python-0.5.0-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
ef63b4512dc7889ae630c8f051d1c479b95d6d7c01987aa0f9f03933902678e0
BLAKE2b-256 checksum
How to use checksums
c67ae422ec3c807d87f20261247cca03418b81ca9cf9a34d11e4a0a7df297ff0
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.5.0-cp313-cp313-win_amd64.whl

Download URL mst_python-0.5.0-cp313-cp313-win_amd64.whl
Size 6.3 MB
Tags CPython 3.13 Windows x86-64
SHA-256 checksum
How to use checksums
10b2e23138676a7d1c528a9ac9683773837d1ef2535c6249307ef0424f451640
BLAKE2b-256 checksum
How to use checksums
bff4805e638313cd81a45d3f23c7d944097a41298f1db1bcac68b1234520b58f
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.5.0-cp313-cp313-manylinux_2_34_x86_64.whl

Download URL mst_python-0.5.0-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
fd70c8e8cc9d47514d25c6e3518f1e61f33c389cbd784374902bb8f28d459d2c
BLAKE2b-256 checksum
How to use checksums
13c2b2262b72c9afcf21d9f2f341a18e322e2181bc7fb5c2f1fef04b21aa6e4f
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.5.0-cp313-cp313-macosx_26_0_universal2.whl

Download URL mst_python-0.5.0-cp313-cp313-macosx_26_0_universal2.whl
Size 3.3 MB
Tags CPython 3.13 macOS 26.0+ universal2 (ARM64, x86-64)
SHA-256 checksum
How to use checksums
aaf0d2c7bbee9c8703808a327b1ddff194984ac58ebff821aec49a671c0057e1
BLAKE2b-256 checksum
How to use checksums
3edca36e3e3259f26837751e70d1d053c062582cf88211292caf52f4c600484d
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.5.0-cp313-cp313-macosx_11_0_universal2.whl

Download URL mst_python-0.5.0-cp313-cp313-macosx_11_0_universal2.whl
Size 3.3 MB
Tags CPython 3.13 macOS 11.0+ universal2 (ARM64, x86-64)
SHA-256 checksum
How to use checksums
38ad3f6de3c56cb210ca54e6cb4c39544746378234b8112a78e38940a353a54c
BLAKE2b-256 checksum
How to use checksums
6c665ea116f23f66b2c4e01abe1cfc541aa6d003203ffb2a10f3f2a08c39291f
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.5.0-cp313-cp313-macosx_11_0_arm64.whl

Download URL mst_python-0.5.0-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
8b9cd99db13b82cd973c716a959e24c1ae9181b1a1bd949b1242876286570a7a
BLAKE2b-256 checksum
How to use checksums
b644234ff034861fe16944be2b738f96f66846472436aa6f74b6726160b18761
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.5.0-cp312-cp312-win_amd64.whl

Download URL mst_python-0.5.0-cp312-cp312-win_amd64.whl
Size 6.3 MB
Tags CPython 3.12 Windows x86-64
SHA-256 checksum
How to use checksums
37e0d0c7cc325f8b4d32a7703fce8b400d0d7c5d88eb16883c1f5c104d7fc020
BLAKE2b-256 checksum
How to use checksums
5a1089fe3f7185450b83fc8f79fcfa18b6fa6ac8ea1789d6a7954dff9585c8fd
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.5.0-cp312-cp312-manylinux_2_34_x86_64.whl

Download URL mst_python-0.5.0-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
cf98944e1877a51be6ea5b5122af9594497eafa34d1fc6830c7a0043812e4aa6
BLAKE2b-256 checksum
How to use checksums
cce785400d7e89f47bdade8bab2ca52525171a8c48dc5f75a8f7ddac70beda0e
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.5.0-cp312-cp312-macosx_26_0_universal2.whl

Download URL mst_python-0.5.0-cp312-cp312-macosx_26_0_universal2.whl
Size 3.3 MB
Tags CPython 3.12 macOS 26.0+ universal2 (ARM64, x86-64)
SHA-256 checksum
How to use checksums
999a43f0653d8c520a0fb8f8db60a026f1fd0fa83cddb4926fdf20cd2c3b0b97
BLAKE2b-256 checksum
How to use checksums
fbeaa01e6aab054e3088bea3f32b94a0c3687bc6d5a8887e28c61a37a4714389
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.5.0-cp312-cp312-macosx_11_0_universal2.whl

Download URL mst_python-0.5.0-cp312-cp312-macosx_11_0_universal2.whl
Size 3.3 MB
Tags CPython 3.12 macOS 11.0+ universal2 (ARM64, x86-64)
SHA-256 checksum
How to use checksums
ec210dc6a1c632361c10e77b4313bbe06f08419a9cc8c636c45fa07f92621ffe
BLAKE2b-256 checksum
How to use checksums
3c7e735c7dd3d1a0f61e31d11c48c9645ab458a6cd1306fb26caf9e755344fe7
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.5.0-cp312-cp312-macosx_11_0_arm64.whl

Download URL mst_python-0.5.0-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
219cad4da51953557f9c6f532e497c7150cc3ce879d3b723938ff5f71f789f42
BLAKE2b-256 checksum
How to use checksums
c6cadabde83b1497ef882dec06d8221dd89b53352f4c6a64bb8f848b65924b77
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.5.0-cp311-cp311-win_amd64.whl

Download URL mst_python-0.5.0-cp311-cp311-win_amd64.whl
Size 6.3 MB
Tags CPython 3.11 Windows x86-64
SHA-256 checksum
How to use checksums
1852e002a203c7908327b48a0a56f1a60537c6415b0ef06c76fc7247edf70300
BLAKE2b-256 checksum
How to use checksums
333df08d07b5ebd89a92dcdcfe89ff40292d6f21795915f75bac6730a16bcae3
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.5.0-cp311-cp311-manylinux_2_34_x86_64.whl

Download URL mst_python-0.5.0-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
9c92b2f837be8d2c85c07d7778b7ad5f6b9d06cbb4f757439ee050d3d3276cea
BLAKE2b-256 checksum
How to use checksums
21c6c0c336dd582739aabb1aefd9aa1fc351852666e887dbedc6fa9b7b984197
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.5.0-cp311-cp311-macosx_26_0_universal2.whl

Download URL mst_python-0.5.0-cp311-cp311-macosx_26_0_universal2.whl
Size 3.3 MB
Tags CPython 3.11 macOS 26.0+ universal2 (ARM64, x86-64)
SHA-256 checksum
How to use checksums
bc564db66529556e7d90831d94f207d1495fe0c454b511e4e2e50c36e7f835be
BLAKE2b-256 checksum
How to use checksums
e80d73339ad9bc6e80e0f7db54da7e4df6bb717e9e7f37a17b09f97746503786
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.5.0-cp311-cp311-macosx_11_0_universal2.whl

Download URL mst_python-0.5.0-cp311-cp311-macosx_11_0_universal2.whl
Size 3.3 MB
Tags CPython 3.11 macOS 11.0+ universal2 (ARM64, x86-64)
SHA-256 checksum
How to use checksums
edc386e54a36878861fb03eef4e69df1122a028f246733bca3b785d8e7f27101
BLAKE2b-256 checksum
How to use checksums
5bd9c2a253adb589f89f2ea04f7d345c7d0b68014ebcf7f47d47c88161758f57
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.5.0-cp311-cp311-macosx_11_0_arm64.whl

Download URL mst_python-0.5.0-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
441d96febf2786f24927061fd6250238bacdbc3b0a63758ddce57dd0f2426bed
BLAKE2b-256 checksum
How to use checksums
ecbdb4489516dc711c63e6b4041713c2e0efc62c9cdbe98ae4dd8222a046685f
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.5.0

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