** Английский ** * 中

Search2ai

** Самостоятельный шлюз поиска для агентов ИИ и клиентов ИИ.**

Подключите службы поиска и извлечения страниц, которые вы настраиваете, через MCP, HTTP API или библиотеку JavaScript / TypeScript. Когда провайдер ограничен по ставке, разгоняется или выходит из строя, шлюз пробует следующий в настроенном порядке и сообщает, какая служба ответила и почему другие потерпели неудачу.

Конечные точки поиска возвращают структурированные результаты и содержимое страницы для использования вашим агентом или приложением. Дополнительный прокси-сервер chat также позволяет моделям, поддерживающим инструмент, вызывать поиск в Интернете при ответе.

Постоянные результаты: title, url, snippet и дополнительные поля, такие как date и content. Поиск, новости и содержание страницы: search, news и crawl, в зависимости от настроенных провайдеров. ** Ваш выбор поставщиков**: URL-адреса или учетные данные по мере необходимости; неконфигурированные поставщики никогда не включаются автоматически. Обратная связь и кэширование: отдельные цепи за операцию, кэширование в памяти и кэширование Cloudflare KV. Гибкая интеграция: локальный MCP, автономный HTTP-сервис, прямые библиотечные звонки и устанавливаемые маршруты Hono.

English · 简体中文

search2ai

A self-hosted search gateway for AI agents and AI clients.

Connect the search and page extraction services you configure through MCP, an HTTP API, or a JavaScript / TypeScript library. When a provider is rate limited, times out, or fails, the gateway tries the next one in your configured order and reports which service answered and why others failed.

Search endpoints return structured results and page content for your agent or application to use. An optional chat proxy also lets models that support tool calling search the web while answering.

• Consistent results: title, url, snippet, and optional fields such as date and content.
• Search, news, and page content: search, news, and crawl, depending on the configured providers.
• Your choice of providers: supply service URLs or credentials as needed; unconfigured providers are never enabled automatically.
• Fallback and caching: separate chains per operation, in-memory caching, and Cloudflare KV caching.
• Flexible integration: local MCP, a standalone HTTP service, direct library calls, and mountable Hono routes.
• Existing API clients: supported Exa, Tavily, Search1API, SearXNG and Firecrawl single-page calls can use dedicated HTTP API / SDK compatibility endpoints.

Looking for hosted search? Search1API is this project’s companion hosted service for search, news, and page extraction. Use its API directly or configure it as a search2ai provider. It also offers hosted compatible APIs to help existing integrations switch with minimal changes. The examples below use Search1API; you can choose any other supported provider.

Website · Quick start · Choose an integration · Providers and configuration · HTTP API · API / SDK compatibility · Deployment · Chat proxy · Upgrading · Development and contributing

Quick start

The local CLI and npm package require Node.js ≥ 22.18. Configure at least one provider that supports the operation you need. In the current version, search requests return 503 when no search provider is configured.

Create .env in your working directory with your search provider key:

SEARCH1API_KEY=your_provider_key

Start a local HTTP service:

npx -y search2ai serve --host 127.0.0.1

Search from another terminal:

curl http://localhost:3014/v1/search \
  -H 'Content-Type: application/json' \
  -d '{"query":"hono cloudflare workers","max_results":3}'