API для агентов глубокого исследования — веб-данные для RAG
Дайте агенту-исследователю веб-поиск, чистый текст страниц, обход сайтов, расшифровки видео, новости и тренды по MCP или REST. Оплата за поиск или страницу.
Исследовательский агент хорош ровно настолько, насколько хорошо то, что он может прочитать. Дайте своему агенту веб-поиск с пересказами, написанными для моделей, любую страницу в виде чистого Markdown, обход целых сайтов для RAG-индекса, расшифровки YouTube и TikTok, Google News, Google Trends и обсуждения на Reddit. Ваш агент вызывает их по MCP, а ваш пайплайн — по REST, с тем же ключом, которым оплачивается модель.
Передайте это своему ИИ-агенту
Скопируйте этот промпт в Claude Code, Cursor, Codex или любой кодинг-агент. Он подскажет агенту, где документация и как использовать ваш API-ключ.
Do grounded research for me with web search, clean page text, whole-site crawls, video transcripts, news and trends, and cite your sources. Use the Lovely Router data tools: each returns JSON and is billed per result.
- Docs (read first): https://lovelyrouter.com/docs/tools/mcp.md and https://lovelyrouter.com/docs/tools/run.md
- Plan first: POST https://lovelyrouter.com/v1/tools/suggest with `{"task": "<my task in plain words>"}` (free). It returns the tools to run in order, each with an example `input`, the `input_required` fields, an estimated cost and a ready-made `run` request. Replace the example values with my task's; if a field is unclear, read the tool with GET https://lovelyrouter.com/v1/tools/<id>. To browse instead, POST https://lovelyrouter.com/v1/tools/discover searches the catalog.
- Show me the plan and its estimated cost (`total_est_cost_usd`) before running anything large.
- Run: POST https://lovelyrouter.com/v1/tools/<id>/run with `{"input": {...}, "max_results": N}`. A 200 has the finished run with `items`; a 202 means it is still running, so poll the `poll` path until `status` is `succeeded`, `failed`, `timed_out` or `stopped`.
- Only delivered results are billed. Keep max_results small on the first run, check the output, then scale up.
- If you support MCP, connect https://lovelyrouter.com/mcp instead (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: <the research question and the format of the answer>Как это работает
Поиск
Веб-поиск возвращает до 50 результатов, у каждого — заголовок, URL, дата, сайт, короткий фрагмент и подробный пересказ, написанный для моделей. Сузить выдачу можно операторами
site:,-site:,"exact phrase",-word,lang:,after:иbefore:.Чтение
Чтение веб-страницы возвращает одну страницу в виде чистого Markdown: её заголовок и текст без меню и рекламы. Обход сайта в Markdown делает то же самое для целого сайта или раздела.
Ответ с опорой на источники
Агент пишет ответ на основе прочитанного и приводит ссылки на URL. Для RAG вы разбиваете полученный при обходе Markdown на фрагменты и кладёте их в собственный индекс.
Подключите агента
MCP-сервер одной командой даёт Claude Code, Cursor и любому MCP-клиенту web_search, web_fetch и весь каталог данных:
claude mcp add --transport http lovely-tools https://lovelyrouter.com/mcp \
--header "Authorization: Bearer $LOVELY_API_KEY"Затем попросите: «Выясни, какие автопроизводители начали выпускать твердотельные батареи в 2026 году. Ищи с after:2026-01-01, прочитай пять самых релевантных источников, проверь Google News за последние 7 дней и напиши сводку со ссылкой на URL для каждого утверждения.»
По MCP web_fetch возвращает длинные страницы частями примерно по 12 000 символов, и продолжение чтения бесплатно.
Вызов из собственного пайплайна
Те же инструменты работают по REST. Один поиск — это один запуск web-search:
curl https://lovelyrouter.com/v1/tools/web-search/run \
-H "Authorization: Bearer $LOVELY_API_KEY" \
-H "content-type: application/json" \
-d '{
"input": {
"query": "solid-state battery production site:reuters.com OR site:bloomberg.com after:2026",
"count": 10,
"question": "Which carmakers produce solid-state batteries in 2026?"
}
}'count задаёт число результатов, от 1 до 50, при той же цене за поиск. question передаёт исходный вопрос пользователя, чтобы результаты ранжировались лучше, а need_content добавляет текст каждой страницы, когда пересказов недостаточно. Поиск и чтение страниц подробнее описаны на странице API веб-поиска.
Инструменты
Поиск в интернете: до 50 результатов с заголовком, URL, датой, сайтом, коротким фрагментом и подробным пересказом для моделей (и текстом страницы по запросу). Операторы: site:, -site:, "exact phrase", -word, lang:, after:, before:.
Любая публичная веб-страница в виде чистого Markdown: заголовок и текст без навигации и рекламы. Для одной страницы, URL которой уже известен.
Обходит весь сайт (или его раздел) и возвращает каждую страницу в чистом Markdown, готовом для LLM. Подходит для RAG и сайтов документации.
Полные расшифровки (субтитры) видео YouTube с таймкодами: по одной на ссылку, на нужном языке, если он есть у видео.
Расшифровки речи из видео TikTok по URL.
Новостные статьи из Google News по запросу (работают операторы "exact phrase", OR, -word, site:, intitle:), при желании за указанный период: заголовок, источник, дата и ссылка на статью на сайте издания.
Динамика интереса в Google Trends по времени и регионам для ключевого слова.
Посты Reddit по запросу или сабреддиту: заголовок, текст, рейтинг, число комментариев, автор, дата.
| Задача | Инструмент | Важные входные параметры |
|---|---|---|
| Найти источники | web-search | query с операторами, count, need_content, question |
| Прочитать одну страницу | web-fetch | url |
| Проиндексировать сайт для RAG | website-crawl | startUrls, maxCrawlPages, maxCrawlDepth, includeUrlGlobs, excludeUrlGlobs, useSitemaps |
| Учиться по видео | youtube-transcript | startUrls, lang: полные расшифровки с таймкодами |
| Проверить, что говорится в TikTok | tiktok-transcript | videos: расшифровки речи |
| Текущие события | google-news | query с операторами, openEndedDateRange, dateFrom, dateTo, language |
| Интерес во времени | google-trends | mode keyword, keyword, predefinedTimeframe, geo, fetchRegionalData |
| О чём спрашивают люди | reddit-search | queries, subredditName, sort, timeframe |
Tip
Пусть первый проход сделают пересказы. Каждый результат web-search содержит подробный пересказ, написанный для модели, поэтому web-fetch агенту обычно нужен только для тех немногих страниц, которые он цитирует.
Рецепты
web-search с after: для свежих источников, web-fetch для трёх лучших, google-news с "openEndedDateRange": "7d" для новостей недели, затем модель пишет обзор со ссылками.
Запустите website-crawl с "startUrls": [{"url": "https://docs.example.com/"}], "useSitemaps": true и "excludeUrlGlobs": ["https://docs.example.com/changelog/**"]. Каждая страница возвращается в виде готового для LLM Markdown, который можно разбить на фрагменты и превратить в эмбеддинги в собственном пайплайне.
Отправьте URL докладов с конференций в youtube-transcript с "lang": "en". Таймкоды позволяют агенту сослаться на момент, когда спикер что-то сказал.
Запустите google-trends с "mode": "keyword", "predefinedTimeframe": "today 5-y", страной в geo и "fetchRegionalData": true, затем reddit-search — чтобы узнать, что покупатели спрашивают по теме.
Передайте URL видео TikTok в tiktok-transcript и попросите модель сравнить слова авторов с техническими характеристиками товара.
Сколько это стоит
Веб-поиск и чтение страниц стоят $0.0009 за поиск или страницу. Поиск без результатов или страница, которую не удалось прочитать, ничего не стоят. Остальные инструменты тарифицируются за результат: за обойдённую страницу (плюс плата за вызов), за расшифровку, за статью или за пост; Google Trends — за вызов. На карточках выше указаны текущие цены. Каждый запуск резервирует свою максимальную стоимость, а итоговое списание соответствует тому, что он вернул. Модель, которая рассуждает, оплачивается за токены по собственной цене с того же предоплаченного баланса; сравнить модели можно на странице «Модели». Без подписки. Подробнее — на странице «Цены».
Частые вопросы
Чем веб-поиск отличается от чтения страницы?+
Веб-поиск находит страницы по запросу и возвращает заголовки, URL, даты и пересказы, написанные для модели. Чтение страницы принимает один URL и возвращает её полный текст в виде чистого Markdown, без меню и рекламы.
Как построить RAG-индекс по сайту?+
Запустите инструмент website-crawl для нужного сайта или раздела, задав шаблоны URL, чтобы включить или исключить пути. Он возвращает каждую страницу в Markdown — её остаётся разбить на фрагменты и добавить эмбеддинги в ваш индекс.
Какие поисковые операторы поддерживает веб-поиск?+
site:, -site:, "exact phrase", -word, lang:, after: и before:. Несколько сайтов можно объединить через OR, а даты можно указывать годами или полностью.
Может ли мой агент читать видео на YouTube?+
Да. Инструмент youtube-transcript — API расшифровок YouTube для агентов — возвращает полные субтитры видео с таймкодами на запрошенном языке, если он у видео есть, включая автоматически созданные субтитры.
Какая модель должна управлять исследовательским агентом?+
Подойдёт любая чат-модель, доступная по вашему ключу, например claude-sonnet-5.5, gpt-6.1-sol или gemini-3.1-pro. Инструменты стоят одинаково, какая бы модель их ни вызывала.
Смотрите также: извлечение веб-данных для структурированного JSON, мониторинг соцсетей для обсуждений и документацию MCP-сервера с настройкой других клиентов.
Один предоплаченный ключ для моделей, данных и агентов
Без подписки. Пополняйте баланс, используйте сколько нужно и смотрите каждое списание в логах.