Agent Reach даёт агенту маршрут к разнотипным публичным данным: веб-страницам, репозиториям, видеоматериалам, лентам новостей и отдельным социальным платформам. Это не поисковик, а слой, который отбирает способ подключения, контролирует готовность каналов и сообщает, какой маршрут сейчас активен. Польза появляется, когда заранее определены вопрос, рамки источников и критерий, по которому результат считается готовым.
Что это
Agent Reach — инструмент с открытым кодом, который работает как уровень возможностей, а не как очередная обёртка над API. Его зона ответственности: подобрать метод подключения к платформе, проконтролировать готовность каналов и указать, какой маршрут задействован прямо сейчас. Само чтение и поиск выполняют внешние инструменты — gh для GitHub, yt-dlp для YouTube, feedparser для RSS, twitter-cli для X, OpenCLI для платформ с авторизацией через браузер.
Уровень возможностей означает, что Agent Reach стоит на шаг выше конкретных инструментов. Когда платформа меняет API или блокирует очередной способ доступа, Agent Reach переводит канал на запасной backend — без переписывания кода на стороне агента. Каждый канал содержит упорядоченный список вариантов: первый рабочий становится активным, остальные ждут своей очереди.
Ключевое правило: Agent Reach не читает источники сам. Он определяет, кто будет читать, проверяет, что этот инструмент работает, и сообщает агенту, что именно нужно вызвать.
Зачем нужно
- Дать агенту доступ к нескольким типам публичных данных без ручной настройки каждого по отдельности.
- Контролировать готовность каналов в одном месте: команда doctor показывает, что работает, что сломалось и как починить.
- Разделять открытые и закрытые источники. Публичные доступны сразу, авторизованные требуют отдельного решения — Agent Reach не смешивает их.
- Переводить маршруты при изменениях на платформе. Если один backend перестал работать, канал переключается на запасной без вмешательства.
- Хранить конфигурацию локально. Файлы cookie и токены лежат в ~/.agent-reach/ с правами 600, не передаются наружу.
Как устроено
| Канал | Что доступно без авторизации | Где остановиться |
|---|---|---|
| Сайты | Чтение публичных страниц | Закрытые кабинеты, платные разделы, страницы с персональными данными |
| GitHub | Публичные репозитории и поиск | Приватные репозитории, создание задач и запросов на слияние требуют входа |
| YouTube | Поиск и субтитры | Ролики без доступных субтитров или с ограничением доступа |
| RSS | Чтение RSS- и Atom-лент | Источники без открытой ленты |
| X | Чтение отдельной публикации | Поиск, лента и длинные публикации требуют настройки |
| Нет пути без настройки | Поиск и чтение требуют авторизации через OpenCLI или rdt-cli с файлами cookie |
Каждый канал внутри Agent Reach — упорядоченный список backend-ов. Для чтения веб-страниц используется Jina Reader, для YouTube — yt-dlp, для GitHub — gh CLI, для RSS — feedparser. Платформы с авторизацией (X, Reddit, Facebook, Instagram) работают через OpenCLI, который использует существующую сессию Chrome, или через специализированные CLI с файлами cookie.
Канал проверяет доступность backend-ов не по факту наличия команды в системе, а по реальной попытке вызова. Первый рабочий backend становится активным. Команда agent-reach doctor показывает, какой именно backend обслуживает канал — через поле active_backend в JSON-выводе.
Когда использовать
| Ситуация | Подходит / не подходит | Почему |
|---|---|---|
| Повторяющееся исследование по нескольким открытым источникам | Подходит | Agent Reach даёт готовый маршрут к сайтам, GitHub, YouTube и RSS без ручной настройки |
| Разовый поиск по одной ссылке | Не подходит | Одна ссылка не оправдывает установку слоя маршрутизации — проще вызвать инструмент напрямую |
| Мониторинг изменений у конкурента или в теме | Подходит | Фиксированный набор публичных URL и периодическая проверка через готовые каналы |
| Доступ к закрытому каналу ради одного факта | Не подходит | Авторизация — отдельное решение, не повод добавлять канал «на всякий случай» |
| Проверка готовности нескольких каналов одновременно | Подходит | Команда doctor показывает состояние всех каналов в одном выводе |
| Нужны приватные репозитории или создание задач | Не подходит без авторизации | Публичные репозитории и поиск доступны без входа, остальное требует отдельного доступа |
Пример
Исследование нового продукта перед решением о пилоте. Задача — понять, стоит ли тратить время на техническую оценку. Критерии: как развёртывается, с чем интегрируется, какая лицензия, насколько активно развивается, какие ограничения доступа есть у платформы. Источники: официальный сайт, документация, репозиторий, журнал изменений, RSS, YouTube.
# Проверка окружения без изменения системы
agent-reach install --env=auto
# Предварительный просмотр системных изменений
agent-reach install --env=auto --dry-run
# Диагностика каналов после установки
agent-reach doctor
# JSON-вывод с активным backend для каждого канала
agent-reach doctor --jsonРезультат исследования — карточка решения, где напротив каждого критерия указаны источник и статус: подтверждено, не подтверждено или данных недостаточно. Карточка позволяет принять решение или честно отложить его, а не достраивать вывод из непроверенных данных.
Для мониторинга изменений у конкурента или в выбранной теме используется тот же набор каналов. Постоянный набор открытых URL, период проверки и заранее зафиксированные поля для сравнения: дата, заголовок, версия, ссылка на изменение, краткое значение. В отчёте разделяются новые факты, изменённые и источники, которые проверить не удалось.
| Поле | Что записать |
|---|---|
| Вопрос | Что именно нужно решить |
| Критерий | По какому признаку будет принято решение |
| Факт | Краткая формулировка без интерпретации |
| Источник | Прямая публичная ссылка |
| Дата | Дата публикации или дата проверки |
| Статус | Подтверждено, не подтверждено или неизвестно |
| Следствие | Что этот факт меняет в решении |
Важно: agent-reach watch в официальной документации обозначен как экспресс-проверка состояния каналов и наличия обновлений у самого Agent Reach. Это не инструмент для отслеживания изменений у конкурента. Расписание, хранение предыдущих состояний, сравнение и отправка уведомлений требуют отдельной реализации.
Agent Reach окупает себя, когда задача повторяется, охватывает разнотипные открытые источники и при этом нельзя бесконтрольно расширять доступы. Если ответ на этот вопрос не готов, сначала нужно уточнить задачу — а не добавлять новые каналы.
Ограничения
Ограничения
Нет анонимного доступа к Reddit — Без авторизации Reddit недоступен: анонимные интерфейсы закрыты, официальный API требует ручного одобрения.
Нужен OpenCLI с браузерной сессией на рабочем столе или rdt-cli с файлами cookie. На сервере без браузера требуется ручная настройка cookie.
X ограничен без настройки — Чтение отдельной публикации доступно без входа.
Поиск, лента и длинные публикации требуют настройки через Cookie-Editor. Файлы cookie сохраняются только для проверки конфигурации, а прямой вызов twitter требует, чтобы переменные TWITTER_AUTH_TOKEN и TWITTER_CT0 были установлены в текущем процессе.
Расхождение в путях конфигурации — Главная страница репозитория указывает ~/.agent-reach/config.yaml, а инструкция по установке приводит ~/.agent-reach/config.json.
До удаления следует проверить, какой формат фактически используется на конкретной машине.
Зависимость от внешних инструментов — Agent Reach не работает без gh CLI, Node.js, yt-dlp и других upstream-инструментов.
Если окружение не содержит нужных зависимостей, каналы не будут работать, даже если agent-reach doctor показывает их как настроенные.
Платформы могут менять доступ без предупреждения — Маршруты каналов зависят от внешних платформ.
Bilibili заблокировал yt-dlp в июне 2026 года, и Agent Reach перевёл канал на bili-cli. Подобные изменения происходят регулярно и требуют обновления маршрутов.
Антипаттерны
Антипаттерны
Подключать ради одного сайта — Устанавливать Agent Reach ради разовой ссылки или единственного источника — избыточно.
Слой маршрутизации окупается, когда задача повторяется и охватывает разнотипные источники. Для одного запроса проще вызвать инструмент напрямую.
Добавлять авторизацию, чтобы закрыть пробел — Если для вывода не хватает открытого источника, это не повод незаметно добавлять авторизацию.
Закрытый канал — отдельная точка решения с собственным контуром согласования. Отсутствие публичного подтверждения — результат исследования, а не повод достраивать вывод.
Использовать основной аккаунт для cookie — Файлы cookie равнозначны полному доступу к аккаунту.
Платформа может ограничить аккаунт при обнаружении нестандартных вызовов. Для экспериментов нужно использовать отдельный аккаунт, а не основной.
Доверять выводу без проверки — Успешная диагностика agent-reach doctor подтверждает, что каналы настроены и доступны.
Но это не гарантирует точность собранных фактов, соответствие правилам платформы или полезность результата для решения. Каждый существенный вывод нужно открывать по прямой ссылке и перепроверять.
Чеклист
Чеклист
Рабочий вопрос сформулирован — Какие открытые данные нужны для решения, где они размещены и какой пробел требует отдельного разрешения.
Если ответа нет — сначала уточнить задачу, не добавляя новые каналы.
Критерии решения определены до сбора — Как развёртывается продукт, с чем интегрируется, какая лицензия, насколько активно развивается, какие ограничения доступа.
Критерии зафиксированы до начала поиска, не выведены из найденного.
Открытые источники проверены первыми — Официальный сайт, документация, репозиторий, журнал изменений, RSS, YouTube.
Переход к X, Reddit или закрытым задачам в репозитории — только после того, как публичных источников недостаточно и принято отдельное решение.
Для каждого факта записана прямая ссылка — Прямая публичная ссылка, дата публикации или просмотра, статус: подтверждено, не подтверждено, данных недостаточно.
Проверяемый результат — карточка, в которой любой вывод можно открыть и перепроверить.
Установка согласована — Какая машина и какой пользовательский профиль входят в контур, какие каналы нужны, разрешены ли сетевые загрузки и изменение окружения.
Для OpenClaw требуется включённое право exec.
Удаление проверено через dry-run — Перед удалением запущен agent-reach uninstall —dry-run.
Проверено, что именно будет удалено: файлы cookie, токены, файлы навыков, конфигурация mcporter. Если цель — защита учётных данных, —keep-config противоречит цели.
Ссылки
Ссылки
- Репозиторий: Panniantong/Agent-Reach
- Документация: Инструкция по установке