API веб-поиска для ИИ-агентов
Веб-поиск и чтение страниц для LLM: результаты с краткими изложениями для моделей и любая страница в виде чистого Markdown. Оплата за вызов, через REST или MCP.
Агенту, который отвечает по данным из интернета, нужны два вызова: один находит подходящие страницы, другой читает те, что стоит прочитать. Веб-поиск возвращает до 50 результатов, у каждого — краткое изложение, написанное для модели. Чтение веб-страницы — это API для перевода веб-страниц в Markdown: он возвращает любую публичную страницу в виде чистого Markdown. Оба стоят $0.0009 за вызов и используют тот же предоплаченный ключ и баланс, что и ваши вызовы моделей, — через REST-запрос или MCP-сервер.
Передайте это своему ИИ-агенту
Скопируйте этот промпт в Claude Code, Cursor, Codex или любой кодинг-агент. Он подскажет агенту, где документация и как использовать ваш API-ключ.
Add web search and page reading to this project with the Lovely Router web search API.
- Docs (read first): https://lovelyrouter.com/docs/tools.md and https://lovelyrouter.com/docs/tools/run.md
- Search: POST https://lovelyrouter.com/v1/tools/web-search/run. Read a page as clean text/Markdown: POST https://lovelyrouter.com/v1/tools/web-fetch/run. Get each tool's input fields first with GET https://lovelyrouter.com/v1/tools/web-search and GET https://lovelyrouter.com/v1/tools/web-fetch (public, no key needed).
- Request body: `{"input": {...}}`. A 202 means the run is still going: poll the `poll` path until `status` is final, then read `items`.
- If you support MCP, you can instead connect the server https://lovelyrouter.com/mcp (Streamable HTTP, same key; https://lovelyrouter.com/docs/tools/mcp.md) and use suggest_tools, get_tool and run_tool.
- Auth: read my API key from the LOVELY_API_KEY environment variable and send it as `Authorization: Bearer $LOVELY_API_KEY`. Never print or commit the key. If it is not set, ask me to create one at https://lovelyrouter.com/app/keys.
- Billing is prepaid: every call is charged to my balance, so test with a small request before running anything large.
- Every docs page is plain Markdown; the full index is https://lovelyrouter.com/llms.txt.
My task: <describe what you want to build or get>Как это работает
Получите ключ
Зарегистрируйтесь, пополните баланс от $5 и создайте ключ на странице API-ключи. Сам каталог инструментов открыт, поэтому схемы и цены можно посмотреть ещё до получения ключа.
Ищите в интернете
Отправьте запрос и, при желании,
count(от 1 до 50 результатов) вinput. Цена считается за поиск, поэтомуcountна неё не влияет.Shellcurl https://lovelyrouter.com/v1/tools/web-search/run \ -H "Authorization: Bearer $LOVELY_API_KEY" \ -H "content-type: application/json" \ -d '{ "input": {"query": "electric car prices site:reuters.com OR site:bloomberg.com after:2026", "count": 10}, "max_results": 1 }'Прочитайте страницы, которые того стоят
Передайте один URL в
web-fetchи получите заголовок и текст страницы в Markdown, без меню и рекламы.cURLcurl https://lovelyrouter.com/v1/tools/web-fetch/run \ -H "Authorization: Bearer $LOVELY_API_KEY" \ -H "content-type: application/json" \ -d '{"input": {"url": "https://en.wikipedia.org/wiki/Web_search_engine"}, "max_results": 1}'
По умолчанию каждый запрос ждёт завершения запуска до 60 секунд (wait можно поднять до 300). Завершённый запуск возвращается с 200, своим charge_usd и результатами в items; более долгий возвращает 202 и путь для опроса. Оба случая описаны в разделе «Запустить инструмент».
Инструменты поиска
Поиск в интернете: до 50 результатов с заголовком, URL, датой, сайтом, коротким фрагментом и подробным пересказом для моделей (и текстом страницы по запросу). Операторы: site:, -site:, "exact phrase", -word, lang:, after:, before:.
Любая публичная веб-страница в виде чистого Markdown: заголовок и текст без навигации и рекламы. Для одной страницы, URL которой уже известен.
Страницы выдачи Google по запросу: органические результаты (позиция, заголовок, URL, фрагмент, дата, быстрые ссылки) и похожие запросы. Один результат = одна страница выдачи (~10 ссылок).
Новостные статьи из Google News по запросу (работают операторы "exact phrase", OR, -word, site:, intitle:), при желании за указанный период: заголовок, источник, дата и ссылка на статью на сайте издания.
возвращает до 50 результатов с заголовком, URL, датой, сайтом, коротким фрагментом и подробным изложением, написанным для моделей. Задайте need_content, чтобы получить ещё и текст каждой страницы, и передайте исходный question пользователя, чтобы результаты ранжировались лучше.
— для страницы, URL которой у вас уже есть: заголовок и текст любой публичной страницы в Markdown.
возвращает собственные страницы выдачи Google: позицию, заголовок, URL, фрагмент, дату, быстрые ссылки и похожие запросы, с учётом country и языка интерфейса hl, с фильтрами по времени в tbs. Каждая страница выдачи примерно из десяти ссылок оплачивается как один результат.
возвращает статьи с заголовком, источником, датой и ссылкой на сайт издателя, отфильтрованные по периоду, например за последние 1d или в диапазоне dateFrom / dateTo.
возвращает динамику интереса к ключевому слову во времени и по регионам или самые популярные запросы в стране.
Поисковые операторы
web-search понимает эти операторы в своём query (от 1 до 128 символов):
| Оператор | Пример | Действие |
|---|---|---|
site: | site:a.com OR site:b.com | Только эти сайты |
-site: | -site:example.com | Исключить сайт |
"…" | "prompt caching" | Точная фраза |
-word, -"…" | -jobs | Исключить слово или фразу |
lang: | lang:en или lang:zh,en | Результаты на этих языках |
after:, before: | after:2026-01-01, before:2026-06 | Опубликовано в диапазоне (годы или даты) |
google-news принимает "exact phrase", OR, -word, site: и intitle:, а google-search принимает операторы в том виде, в каком вы ввели бы их в Google.
Используйте из агента через MCP
Подключите MCP-сервер, и ваш агент получит инструменты web_search и web_fetch рядом с остальным каталогом инструментов данных. Сервер подсказывает агенту использовать их для всего, что нужно найти или прочитать, а браузерного агента оставлять для страниц, по которым нужно кликать. Результаты приходят короткими и пронумерованными, а web_fetch возвращает длинные страницы частями примерно по 12 000 символов; продолжение чтения бесплатно.
claude mcp add --transport http lovely-tools https://lovelyrouter.com/mcp \
--header "Authorization: Bearer $LOVELY_API_KEY"Затем попросите Claude Code: «Найди на новостных сайтах анонсы этой недели о твердотельных батареях, прочитай три самые релевантные статьи и кратко изложи, что изменилось, со ссылками». В разделе «MCP-сервер» описана настройка для Cursor, Claude Desktop и других клиентов.
Рецепты
web-search с after:2026-10-01 и списком site: из надёжных источников, затем web-fetch для трёх лучших результатов.
Добавьте к запросу lang:zh,en, чтобы получить китайские и английские источники одним поиском.
Запускайте google-search с вашим keyword и country: "US" и записывайте позицию каждого результата со временем.
google-news с названием компании в кавычках и openEndedDateRange: "1d".
google-trends в режиме keyword с predefinedTimeframe: "today 12-m" и страной в geo.
Сколько это стоит
web-search оплачивается за поиск — $0.0009, запрашиваете ли вы 1 результат или 50; поиск без результатов бесплатен. web-fetch оплачивается за страницу по той же цене; страница, которую не удалось прочитать, бесплатна. Поиск Google оплачивается за страницу выдачи, Google News — за статью, Google Trends — за вызов; актуальные цены — на карточках выше.
Каждый запуск резервирует свою максимальную стоимость на предоплаченном балансе и рассчитывается по тому, что вернул, поэтому вы знаете предельную стоимость запуска до его начала. Неудачный запуск платит только за выданные результаты. Подписки нет; все инструменты и модели — на странице цен.
Частые вопросы
Сколько стоит веб-поиск?+
$0.0009 за поиск при любом count от 1 до 50 результатов. Поиск, который ничего не нашёл, бесплатен.
Чем web-search отличается от google-search?+
web-search возвращает результаты с изложениями, написанными для моделей, и поддерживает lang:, after: и before:. google-search возвращает собственные страницы выдачи Google с позициями, быстрыми ссылками и похожими запросами — это подходит для отслеживания позиций.
Можно ли получить полный текст каждой страницы?+
Да. Задайте need_content в web-search, чтобы включить текст каждой страницы, или передайте URL в web-fetch, чтобы прочитать одну страницу в Markdown.
Работает ли это с Claude Code и Cursor?+
Да. Добавьте MCP-сервер одной командой или одной записью в конфигурации, и агент получит инструменты web_search и web_fetch с оплатой с того же баланса.
Можно ли использовать это как поисковый API для RAG?+
Да. Найдите нужные страницы, затем задайте need_content или вызовите web-fetch, чтобы получить их текст в Markdown, и передайте этот текст модели как контекст.
Может ли он читать страницы за логином?+
Нет. web-fetch читает публичные страницы. Для страниц, где нужен вход, форма или несколько кликов, используйте браузерного агента.
Сколько поисков может выполняться одновременно?+
На аккаунте одновременно может выполняться до 10 запусков, включая запуски браузерного агента. Запуск сверх этого лимита получает 429; запустите его снова, когда завершится другой.
Об ответах с опорой на источники и RAG — в исследовательских агентах; о превращении целых сайтов в данные — в извлечении данных из интернета.
Один предоплаченный ключ для моделей, данных и агентов
Без подписки. Пополняйте баланс, используйте сколько нужно и смотрите каждое списание в логах.