anysearch-py

Typed Python clients for AnySearch.

The package has two first-class clients.

Client calls the REST Web API.

MCPClient calls the remote MCP tools/call API.

Both clients share the same Pydantic models, enums, validation, and serialization logic.

The API key is optional when the AnySearch endpoint permits anonymous access.

Install

uv add anysearch-py

REST Search

from anysearch_py import Client, SearchTag

with Client(api_key="YOUR_ANYSEARCH_API_KEY") as client:
    response = client.search(
        "Python 3.15 new features",
        tag=SearchTag.CODE_DOC,
        params={"library": "python"},
    )

print(response.data.results[0].url)

Async REST Search

import asyncio

from anysearch_py import AsyncClient


async def main() -> None:
    async with AsyncClient(api_key="YOUR_ANYSEARCH_API_KEY") as client:
        response = await client.search("Python 3.15 new features")

    print(response.data.results[0].url)


asyncio.run(main())

MCP Tools

from anysearch_py import Domain, MCPClient

with MCPClient(api_key="YOUR_ANYSEARCH_API_KEY") as client:
    markdown = client.get_sub_domains(domains=[Domain.FINANCE, Domain.HEALTH])

print(markdown)

MCP Search

from anysearch_py import MCPClient

with MCPClient(api_key="YOUR_ANYSEARCH_API_KEY") as client:
    markdown = client.search("Python 3.15 new features", max_results=5)

print(markdown)

Live Tests

Live tests read ANYSEARCH_API_KEY from the environment first, then .env.

If neither source provides a non-empty value, those tests skip automatically.

Package code never reads .env.