Agent Reach — интернет-доступ для AI-агентов одной командой
📂 Исходный код на GitHubAgent Reach — capability layer для AI-агентов: сам выбирает, устанавливает и диагностирует инструменты для доступа в интернет. 15+ платформ (web, YouTube, Twitter, Reddit, Bilibili, XiaoHongShu, LinkedIn и др.), каждая с «первичным + запасным» списком бэкендов. Установка одной фразой через install.md, диагностика через agent-reach doctor. 78.5k звёзд на GitHub, MIT-лицензия.
Agent Reach — открытый инструмент от Panniantong, который за один шаг подключает к AI-агенту доступ в интернет: чтение и поиск в Twitter, Reddit, YouTube, GitHub, Bilibili, XiaoHongShu и ещё десятке платформ. Один CLI, ноль платы за API. 78.5k звёзд на GitHub, лицензия MIT, Python 3.10+.
Проект решает проблему, знакомую каждому, кто пробовал дать агенту «сходить в сеть»: YouTube не отдаёт субтитры, Twitter API платный, Reddit режет анонимные запросы 403, XiaoHongShu требует логин, Bilibili блокирует универсальные загрузчики, а в ответ на «прочитай страницу» агент получает мешанину из HTML-тегов. Каждая платформа — свои барьеры: платные API, антибот-защита, авторизация, грязные данные. Вместо того чтобы проходить этот путь заново для каждого агента, Agent Reach упаковывает всё в один шаг:
帮我安装 Agent Reach:https://raw.githubusercontent.com/Panniantong/agent-reach/main/docs/install.md
Достаточно скопировать эту фразу агенту (Claude Code, OpenClaw, Cursor, Windsurf и любому, кто умеет выполнять команды), и через несколько минут он умеет читать Twitter, искать в Reddit, смотреть YouTube и листать XiaoHongShu.
Что умеет из коробки
Часть каналов работает без какой-либо настройки:
| Сценарий | Команда за кулисами |
|---|---|
| Прочитать любую веб-страницу | curl https://r.jina.ai/URL (Jina Reader) |
| Что делает GitHub-репозиторий | gh repo view owner/repo |
| О чём видео на YouTube | yt-dlp — извлечение субтитров |
| Поиск на Bilibili | bili search (без логина) |
| Семантический поиск по всему интернету | Exa через MCP |
| Подписка на RSS/Atom | feedparser |
Команды запоминать не нужно — агент читает SKILL.md и сам знает, какой инструмент вызвать. Платформы, которым нужен логин (XiaoHongShu, Twitter, Reddit, Facebook, Instagram), разблокируются по фразе «помоги настроить XXX»: агент сам проведёт через необходимые шаги.
Почему это работает: архитектура
Agent Reach — это capability layer (слой возможностей), а не очередной инструмент. Он не читает сайты сам, а отвечает за три вещи: выбор, установку и диагностику. Само чтение выполняется агентом напрямую через проверенные upstream-инструменты — никакой обёртки поверх.
Каждый канал — это упорядоченный список «первичный + запасной» бэкендов:
channels/
├── web.py → Jina Reader
├── twitter.py → twitter-cli ▸ OpenCLI ▸ bird
├── youtube.py → yt-dlp
├── github.py → gh CLI
├── bilibili.py → bili-cli ▸ OpenCLI ▸ поиск API (yt-dlp выведен из эксплуатации)
├── reddit.py → OpenCLI ▸ rdt-cli (только с логином)
├── facebook.py → OpenCLI (браузерная сессия)
├── instagram.py → OpenCLI (браузерная сессия)
├── xiaohongshu.py → OpenCLI ▸ xiaohongshu-mcp ▸ xhs-cli
├── linkedin.py → mcp-server-linkedin ▸ Jina Reader
├── rss.py → feedparser
├── exa_search.py → Exa через mcporter
└── __init__.py → регистрация каналов
При вызове канал реально проверяет каждый кандидат (не просто «команда существует»), выбирает первый полностью рабочий, а сломанным выдаёт «рецепт починки». Сменить способ доступа = переставить порядок в списке, а не переписывать код. Пример из жизни: в июне 2026 антибот Bilibili (ошибка 412) убил yt-dlp — маршрут переключили на bili-cli без единого действия пользователя.
agent-reach doctor одной командой показывает статус каждого канала и какой бэкенд используется прямо сейчас.
Поддерживаемые платформы
| Платформа | Из коробки | После настройки |
|---|---|---|
| Веб | чтение любой страницы | — |
| YouTube | субтитры + поиск | — |
| RSS | любые RSS/Atom-ленты | — |
| Полнотекстовый поиск | — | семантический поиск (MCP, без ключа) |
| GitHub | публичные репозитории + поиск | приватные, Issues/PR, Fork |
| Twitter/X | чтение отдельного твита | поиск, таймлайн, длинные твиты |
| Bilibili | поиск + детали видео | субтитры |
| — (анонимный API закрыт) | поиск, посты, комментарии | |
| — | поиск, страницы, лента, группы | |
| — | поиск юзеров, профили, посты, Explore | |
| XiaoHongShu | — | поиск, чтение, комментарии |
| чтение публичных страниц | профили, компании, поиск вакансий | |
| V2EX | горячие посты, треды, пользователи | — |
| Xueqiu | котировки, поиск акций, топы | — |
| Xiaoyuzhou | — | транскрипция подкастов (Whisper) |
Установка и безопасность
Установка по умолчанию безопасна: agent-reach install не трогает систему — только проверяет окружение и перечисляет недостающее. Всё реальное происходит с явным флагом --system:
| Режим | Команда |
|---|---|
| Проверка по умолчанию | agent-reach install --env=auto |
| Установка зависимостей | agent-reach install --env=auto --system |
| Совместимый аналог | agent-reach install --env=auto --safe |
| Предпросмотр действий | agent-reach install --env=auto --dry-run |
Ключевые принципы безопасности:
- Cookie и токены живут только локально —
~/.agent-reach/config.yamlс правами 600 (доступ только владельцу), ничего не отправляется наружу - Полная открытость — и сам проект, и все зависимые инструменты с открытым исходным кодом, код можно аудитить
- Dry run —
install --dry-runпоказывает все операции без изменений - Плагинная архитектура — не доверяете компоненту? Замените один channel-файл, остальное не затрагивается
Для платформ с Cookie (Twitter, XiaoHongShu и др.) автор рекомендует отдельный аккаунт-«однодневку», а не основной: скриптовый доступ к API несёт риск бана, а Cookie равносильны полному доступу к аккаунту.
Удаление: agent-reach uninstall очищает ~/.agent-reach/ (включая все токены), SKILL-файлы агентов и MCP-конфигурацию mcporter. Есть флаги --dry-run и --keep-config (сохранить настройки для переустановки).
Стоимость
Всё бесплатно: и инструменты, и API открыты. Единственная возможная трата — прокси для серверного развёртывания (~$1/мес); локальной машине прокси не нужен.
Итог
Agent Reach закрывает один из самых раздражающих пробелов AI-агентов — доступ к живым данным в интернете. Он не привязывает вас к конкретному инструменту: если одна библиотека умирает, маршрут переключается на следующую, а вы об этом даже не узнаете. Для команд, которые используют агентов для исследований, мониторинга и автоматизации, это практичная замена связки самописных скриптов и устаревших токенов.
Проект распространяется по лицензии MIT, исходники на GitHub.