iflow-search-py

This repository is a Python software development kit that connects AI agents and language model applications to the iFlow Search API, a service that provides web search, image search, and web page retrieval. The SDK is aimed at developers building applications that need their AI systems to look things up on the internet in real time, rather than relying only on the model's built-in knowledge.

The core package lets you write a few lines of Python to search the web for a topic, find images by keyword, or fetch the content of a specific URL, all returning structured data ready for a language model to read. Both synchronous and asynchronous usage patterns are supported, so it fits into straightforward scripts as well as more complex async applications. The package is published on PyPI under the name iflow-search, though it is currently a pre-release and requires a flag when installing.

Alongside the core SDK, the repository also ships an MCP adapter, published as iflow-search-mcp. MCP is a protocol that lets AI assistants like Claude Desktop or Claude Code call external tools during a conversation. Installing this adapter and pointing your AI host at it gives the assistant access to web search and page fetching without any extra coding on your part.

The project follows careful security practices: the API key is read from an environment variable only and is never embedded in code, logs, or configuration files. All three search endpoints have been verified against the live API, and the test suite covers over 100 offline cases with strict type checking and linting in place.

Future adapters for LangChain and OpenAPI-based platforms like Open WebUI are planned but not yet released. The repository layout is clean and well-documented, with design documents covering both the core SDK and the MCP adapter.