Мониторинг упоминаний бренда в X с расширенными операторами поиска
Запросы расширенного поиска X (Twitter) и найденные твиты в JSON с текстом, автором, вовлечённостью и датой — для мониторинга бренда, продуктов и конкурентов.
Упоминания бренда в X бывают двух видов: с отметкой вашего аккаунта, которые вы видите, и те, где просто названо ваше имя, которых вы не видите. Именно во втором виде живут жалобы и советы о покупке. Lovely Router выполняет для вас расширенный поиск самого X. Отправьте запросы, получите по одному JSON-объекту на твит и платите за каждый твит с предоплаченного баланса. Вызывайте инструмент из скрипта по расписанию, Slack-бота или ИИ-агента с одним API-ключом.
Передайте это своему ИИ-агенту
Скопируйте этот промпт в Claude Code, Cursor, Codex или любой кодинг-агент. Он подскажет агенту, где документация и как использовать ваш API-ключ.
Мониторинг упоминаний бренда в X с расширенными операторами поиска. Use the Lovely Router data tools: each returns JSON and is billed per result.
- Docs (read first): https://lovelyrouter.com/docs/tools/find.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 inputs (links, keywords or accounts) and how many results you need>Как это работает
Составьте запросы
Один запрос на строку, в том же виде, что и в поиске X: ваш бренд в кавычках, названия продуктов, частые опечатки,
-from:yourhandle, чтобы исключить собственные посты,min_faves:, чтобы отсечь шум.Запустите инструмент с лимитом
Отправьте запросы в
POST /v1/tools/x-search/runвместе сmax_results. Запуск резервирует свою максимальную стоимость на балансе и возвращает твиты в виде JSON.Направляйте важное по адресу
Жалобы — в поддержку, вопросы — в продажи, посты с высокой вовлечённостью — тому, кто отвечает за бренд. Сохраняйте дату самого свежего твита, чтобы следующий запуск начинался после неё.
Поиск в X одним запросом
Поиск постов в X (Twitter) принимает запросы в searchTerms. maxItems задаёт лимит, а queryType — порядок: Latest, Top или Latest + Top:
curl https://lovelyrouter.com/v1/tools/x-search/run \
-H "Authorization: Bearer $LOVELY_API_KEY" \
-H "content-type: application/json" \
-d '{
"input": {
"searchTerms": ["\"brightloop\" -from:brightloop since:2026-10-20 lang:en"],
"maxItems": 50,
"queryType": "Latest"
},
"max_results": 50
}'Latest возвращает сначала самые новые твиты, что подходит для мониторинга; Top ранжирует по релевантности и не исчерпывающий. Запуск, который через 60 секунд ещё не завершился, возвращает 202; как опрашивать его статус, показано в разделе Запуск инструмента.
Что содержит каждый твит
| Группа полей | Что вы получаете |
|---|---|
| Контент | Текст твита |
| Автор | Кто его опубликовал |
| Вовлечённость | Показатели вовлечённости |
| Время | Дата публикации |
Среди операторов, которые перечисляет инструмент, — from:, to:, -from:, since:, until:, lang:, min_faves: и filter:, а также хэштеги, @упоминания, точные фразы, OR и исключения.
Рецепты
Ищите своё название с -from: и вашим аккаунтом и since:, равным вчерашней дате. Каждое утро публикуйте в канале команды твиты с наибольшей вовлечённостью.
Добавьте к бренду через OR слова вроде «refund», «broken» или «cancel», запускайте каждый час и пересылайте новые совпадения в поддержку.
Ищите название конкурента с min_faves:50, чтобы видеть только разошедшиеся посты. Обращайте внимание на то, чего, по словам клиентов, продукту не хватает.
Ищите свой хэштег с until: и since: вокруг дат кампании и считайте твиты по дням.
Добавьте в запрос lang:, чтобы читать твиты только на одном языке, или передайте поле lang.
Предпочитаете обычные слова? Подключите MCP-сервер и скажите Claude Code или Cursor: «Найди в X твиты с упоминанием brightloop начиная с понедельника, без моих собственных постов, сгруппируй жалобы по темам и перечисли пять самых залайканных. Установи max_results равным 100».
Сочетайте с другими источниками мониторинга
X — лишь одно из мест, где люди общаются. Отзывы, форумы и новости дополняют картину:
Твиты по поисковым запросам, хэштегам или от указанных аккаунтов: текст, автор, вовлечённость, дата. Каждый запрос поддерживает операторы расширенного поиска X (from:, since:, min_faves:, filter:, lang: …).
Ответы на посты X/Twitter по URL: текст, автор, вовлечённость, дата.
Данные профилей X/Twitter по никнеймам: био, подписчики, подписки, верификация, счётчики.
Посты Reddit по запросу или сабреддиту: заголовок, текст, рейтинг, число комментариев, автор, дата.
Новостные статьи из Google News по запросу (работают операторы "exact phrase", OR, -word, site:, intitle:), при желании за указанный период: заголовок, источник, дата и ссылка на статью на сайте издания.
x-repliesчитает ответы под конкретным постом, который нашёл поиск.x-profileпоказывает, кто стоит за автором с большим охватом.reddit-searchнаходит более длинные обсуждения того же бренда.google-newsдобавляет публикации в прессе к твитам.
О полной настройке по всем каналам см. мониторинг соцсетей.
Твиты публикуют реальные люди. Если вы сохраняете эти данные или связываетесь с авторами, вы отвечаете за законное использование данных, включая правила о конфиденциальности и против спама.
Сколько это стоит
Вы платите за твит: при старте запуск резервирует свою максимальную стоимость — плату за вызов плюс плату за твит, умноженную на max_results, — а итоговое списание равно тому, что он вернул. Остаток резерва возвращается на баланс. Запуск, который завершился ошибкой или по тайм-ауту, оплачивает только доставленные твиты, а запуск, отклонённый на старте, ничего не стоит.
Мониторинг 200 твитов в день оплачивается как 200 твитов в день. Нет ни подписки, ни ежемесячного минимума: пополняйте баланс от $5, и один баланс оплачивает и инструменты, и модели. Карточка выше показывает актуальную цену; на странице цен перечислены все инструменты.
Частые вопросы
Можно ли использовать расширенные операторы поиска X?+
Да. Каждый поисковый запрос их поддерживает, включая from:, since:, min_faves:, filter: и lang:.
Сколько твитов может вернуть один запуск?+
До 500, по умолчанию 20. Укажите нужное число в maxItems и max_results.
Можно ли искать посты только одного аккаунта?+
Да, с помощью from:handle в запросе. Инструмент также принимает twitterHandles, чтобы собрать посты аккаунта.
Как не читать одни и те же твиты дважды?+
Используйте since: с датой последнего запуска и оставьте queryType в значении Latest. Сохраняйте дату твита, до которого вы дошли.
Нужен ли аккаунт X или доступ к его API?+
Нет. Вы отправляете запросы и API-ключ.
Нужна ли подписка?+
Нет. Вы пополняете предоплаченный баланс, и каждый запуск списывает с него средства. Неудачные запуски оплачивают только доставленные результаты, и ничего не продлевается автоматически.
Следите больше чем за одним каналом? См. мониторинг соцсетей, поиск инфлюенсеров и остальной каталог инструментов.
Один предоплаченный ключ для моделей, данных и агентов
Без подписки. Пополняйте баланс, используйте сколько нужно и смотрите каждое списание в логах.