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

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

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.

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