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, 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.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.6.0
File Actions
mst_python-0.6.0-cp314-cp314-win_amd64.whl CPython 3.14 CPython 3.14 Windows x86-64 Details for mst_python-0.6.0-cp314-cp314-win_amd64.whl
mst_python-0.6.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.6.0-cp314-cp314-manylinux_2_34_x86_64.whl
mst_python-0.6.0-cp314-cp314-macosx_11_0_arm64.whl CPython 3.14 CPython 3.14 macOS 11.0+ ARM64 Details for mst_python-0.6.0-cp314-cp314-macosx_11_0_arm64.whl
mst_python-0.6.0-cp313-cp313-win_amd64.whl CPython 3.13 CPython 3.13 Windows x86-64 Details for mst_python-0.6.0-cp313-cp313-win_amd64.whl
mst_python-0.6.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.6.0-cp313-cp313-manylinux_2_34_x86_64.whl
mst_python-0.6.0-cp313-cp313-macosx_11_0_arm64.whl CPython 3.13 CPython 3.13 macOS 11.0+ ARM64 Details for mst_python-0.6.0-cp313-cp313-macosx_11_0_arm64.whl
mst_python-0.6.0-cp312-cp312-win_amd64.whl CPython 3.12 CPython 3.12 Windows x86-64 Details for mst_python-0.6.0-cp312-cp312-win_amd64.whl
mst_python-0.6.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.6.0-cp312-cp312-manylinux_2_34_x86_64.whl
mst_python-0.6.0-cp312-cp312-macosx_11_0_arm64.whl CPython 3.12 CPython 3.12 macOS 11.0+ ARM64 Details for mst_python-0.6.0-cp312-cp312-macosx_11_0_arm64.whl
mst_python-0.6.0-cp311-cp311-win_amd64.whl CPython 3.11 CPython 3.11 Windows x86-64 Details for mst_python-0.6.0-cp311-cp311-win_amd64.whl
mst_python-0.6.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.6.0-cp311-cp311-manylinux_2_34_x86_64.whl
mst_python-0.6.0-cp311-cp311-macosx_11_0_arm64.whl CPython 3.11 CPython 3.11 macOS 11.0+ ARM64 Details for mst_python-0.6.0-cp311-cp311-macosx_11_0_arm64.whl

Total release size: 86.9 MB

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

Download URL mst_python-0.6.0-cp314-cp314-win_amd64.whl
Size 6.5 MB
Tags CPython 3.14 Windows x86-64
SHA-256 checksum
How to use checksums
7ede332f9c294cc26ebc912a45a41cd50726d5e534f18e9898451af8d65cad84
BLAKE2b-256 checksum
How to use checksums
036d1c5806c75dc895bdd3098096fb2689d478f9a934120f18e09fc53995f455
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.0-cp314-cp314-manylinux_2_34_x86_64.whl

Download URL mst_python-0.6.0-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
d192bdac6528264b1eff871a7c7e8495425994f6e443a0ce813b07f47f6230d1
BLAKE2b-256 checksum
How to use checksums
f399eb9ca092a7b67fd8eec2264d53e1ea0272f01fb10ac7ada512731da3aa4d
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.0-cp314-cp314-macosx_11_0_arm64.whl

Download URL mst_python-0.6.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
543ab4d22cc0e59f7b6cb3289f57f634466911ce3c5638165c4a46e13957e5bb
BLAKE2b-256 checksum
How to use checksums
b5be82bed9d4ad24105639bdc4e54d73fc9b564539822be74a72e85fa56aa74f
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.0-cp313-cp313-win_amd64.whl

Download URL mst_python-0.6.0-cp313-cp313-win_amd64.whl
Size 6.3 MB
Tags CPython 3.13 Windows x86-64
SHA-256 checksum
How to use checksums
b194d4785fe34a2ae73c82753d2080d9eb97e018d3be5be737abb8ab00e2e79d
BLAKE2b-256 checksum
How to use checksums
724f13d655a440a216382b335571220ab2bd0133dbc2af24cf9cbbd75cb54ab4
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.0-cp313-cp313-manylinux_2_34_x86_64.whl

Download URL mst_python-0.6.0-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
f2b3d37252c1c269e21c7a19dac22a16874ae5cb2f1dc585380f7033fe34cb16
BLAKE2b-256 checksum
How to use checksums
bffc8b59947834a594e72cc86c6e5457766c889f636b55d921112a1b76b00bc3
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.0-cp313-cp313-macosx_11_0_arm64.whl

Download URL mst_python-0.6.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
1da7383000b1795e77571598fb13b4a64d097d5e6f6b58f443c3e4572dc4dfb9
BLAKE2b-256 checksum
How to use checksums
d0c6f0f01e56d36dd8bacdfe9b521dbe5dec50c7858b3d2316bbc1cf771854e3
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.0-cp312-cp312-win_amd64.whl

Download URL mst_python-0.6.0-cp312-cp312-win_amd64.whl
Size 6.3 MB
Tags CPython 3.12 Windows x86-64
SHA-256 checksum
How to use checksums
2677114eb2aba6628511fda99c0855f95f2e748ad970e4e44ede9e672e450e0c
BLAKE2b-256 checksum
How to use checksums
7ef5e114104de2868ea854abba0b1d059d19b5a718c18ead974f3256d6e6904e
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.0-cp312-cp312-manylinux_2_34_x86_64.whl

Download URL mst_python-0.6.0-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
51d4c05b4034c1bd1aa11c453886ffc7488cb87e792a76c6f08d7e31d1b5e353
BLAKE2b-256 checksum
How to use checksums
4b4a26a9138133607df1cf1227ad49cd45bf01bb17a6af0a098f2b4b962b2085
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.0-cp312-cp312-macosx_11_0_arm64.whl

Download URL mst_python-0.6.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
d784c2380f733a60259f51b20d6f6aff260c3f1cc5f63c30e282bcbeac377117
BLAKE2b-256 checksum
How to use checksums
fccf563dc1b960db2d5647c4dd65600ae1f58e62e1fea570b9d57c57a28bf977
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.0-cp311-cp311-win_amd64.whl

Download URL mst_python-0.6.0-cp311-cp311-win_amd64.whl
Size 6.3 MB
Tags CPython 3.11 Windows x86-64
SHA-256 checksum
How to use checksums
a694d4e8e1d057acf1277784910f51cd87d793a3690e4708d1f8bddf6cc27693
BLAKE2b-256 checksum
How to use checksums
34b0c60c83b5e1c8f812a71979c87c86eaec4c9d2c5375188417758877d928b3
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.0-cp311-cp311-manylinux_2_34_x86_64.whl

Download URL mst_python-0.6.0-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
6730408e5e3bb2e6f0bdc305eba4bea60c8e1eaab4832559d5e409ba6ff43580
BLAKE2b-256 checksum
How to use checksums
6a01283eb43d9d45256b7cd671de8279750173fa078ab97827bafb33fa642073
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.0-cp311-cp311-macosx_11_0_arm64.whl

Download URL mst_python-0.6.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
0093b138747c4df0a9d2c9956d9f0adbb2c79fa9ec194dea5caa9515cc0f44c3
BLAKE2b-256 checksum
How to use checksums
e7911c6389144c8897d2ecff1cafba9be26750556b54a4f12e45004aabbd8d5b
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.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