Инструменты данных

API веб-поиска для ИИ-агентов

Веб-поиск и чтение страниц для LLM: результаты с краткими изложениями для моделей и любая страница в виде чистого Markdown. Оплата за вызов, через REST или MCP.

Предоплата, без подпискиREST или MCPОдин ключ для моделей, данных и агентов
electric car prices site:reuters.com after:2026reuters.combloomberg.comft.comapnews.comsummary

Агенту, который отвечает по данным из интернета, нужны два вызова: один находит подходящие страницы, другой читает те, что стоит прочитать. Веб-поиск возвращает до 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>
01

Как это работает

010203
  1. Получите ключ

    Зарегистрируйтесь, пополните баланс от $5 и создайте ключ на странице API-ключи. Сам каталог инструментов открыт, поэтому схемы и цены можно посмотреть ещё до получения ключа.

  2. Ищите в интернете

    Отправьте запрос и, при желании, count (от 1 до 50 результатов) в input. Цена считается за поиск, поэтому count на неё не влияет.

    curl 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
      }'
  3. Прочитайте страницы, которые того стоят

    Передайте один URL в web-fetch и получите заголовок и текст страницы в Markdown, без меню и рекламы.

    cURL
    curl 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 и путь для опроса. Оба случая описаны в разделе «Запустить инструмент».

02

Инструменты поиска

Web
Веб-поиск

Поиск в интернете: до 50 результатов с заголовком, URL, датой, сайтом, коротким фрагментом и подробным пересказом для моделей (и текстом страницы по запросу). Операторы: site:, -site:, "exact phrase", -word, lang:, after:, before:.

$0.0009 / searchПодробности →
Web
Чтение веб-страницы

Любая публичная веб-страница в виде чистого Markdown: заголовок и текст без навигации и рекламы. Для одной страницы, URL которой уже известен.

$0.0009 / pageПодробности →
Google
Поиск в Google

Страницы выдачи Google по запросу: органические результаты (позиция, заголовок, URL, фрагмент, дата, быстрые ссылки) и похожие запросы. Один результат = одна страница выдачи (~10 ссылок).

$0.00125 / pageПодробности →
Google News
Поиск в Google News

Новостные статьи из Google News по запросу (работают операторы "exact phrase", OR, -word, site:, intitle:), при желании за указанный период: заголовок, источник, дата и ссылка на статью на сайте издания.

$0.006 / articleПодробности →

возвращает до 50 результатов с заголовком, URL, датой, сайтом, коротким фрагментом и подробным изложением, написанным для моделей. Задайте need_content, чтобы получить ещё и текст каждой страницы, и передайте исходный question пользователя, чтобы результаты ранжировались лучше.

— для страницы, URL которой у вас уже есть: заголовок и текст любой публичной страницы в Markdown.

возвращает собственные страницы выдачи Google: позицию, заголовок, URL, фрагмент, дату, быстрые ссылки и похожие запросы, с учётом country и языка интерфейса hl, с фильтрами по времени в tbs. Каждая страница выдачи примерно из десяти ссылок оплачивается как один результат.

возвращает статьи с заголовком, источником, датой и ссылкой на сайт издателя, отфильтрованные по периоду, например за последние 1d или в диапазоне dateFrom / dateTo.

возвращает динамику интереса к ключевому слову во времени и по регионам или самые популярные запросы в стране.

03

Поисковые операторы

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.

04

Используйте из агента через MCP

Подключите MCP-сервер, и ваш агент получит инструменты web_search и web_fetch рядом с остальным каталогом инструментов данных. Сервер подсказывает агенту использовать их для всего, что нужно найти или прочитать, а браузерного агента оставлять для страниц, по которым нужно кликать. Результаты приходят короткими и пронумерованными, а web_fetch возвращает длинные страницы частями примерно по 12 000 символов; продолжение чтения бесплатно.

Shell
claude mcp add --transport http lovely-tools https://lovelyrouter.com/mcp \
  --header "Authorization: Bearer $LOVELY_API_KEY"

Затем попросите Claude Code: «Найди на новостных сайтах анонсы этой недели о твердотельных батареях, прочитай три самые релевантные статьи и кратко изложи, что изменилось, со ссылками». В разделе «MCP-сервер» описана настройка для Cursor, Claude Desktop и других клиентов.

05

Рецепты

Что изменилось за месяц

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.

06

Сколько это стоит

web-search оплачивается за поиск — $0.0009, запрашиваете ли вы 1 результат или 50; поиск без результатов бесплатен. web-fetch оплачивается за страницу по той же цене; страница, которую не удалось прочитать, бесплатна. Поиск Google оплачивается за страницу выдачи, Google News — за статью, Google Trends — за вызов; актуальные цены — на карточках выше.

Каждый запуск резервирует свою максимальную стоимость на предоплаченном балансе и рассчитывается по тому, что вернул, поэтому вы знаете предельную стоимость запуска до его начала. Неудачный запуск платит только за выданные результаты. Подписки нет; все инструменты и модели — на странице цен.

07

Частые вопросы

?
Сколько стоит веб-поиск?+

$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 — в исследовательских агентах; о превращении целых сайтов в данные — в извлечении данных из интернета.

Один предоплаченный ключ для моделей, данных и агентов

Без подписки. Пополняйте баланс, используйте сколько нужно и смотрите каждое списание в логах.