Agent Reach
Panniantong/Agent-ReachAgent Reach — инструмент для AI-агентов, позволяющий читать и искать контент в Twitter, Reddit, YouTube, GitHub, Bilibili, XiaoHongShu и других платформах. Устанавливается одной командой, не требует платных API. Подходит для Claude Code, Cursor, Windsurf и любых агентов с доступом к CLI.
Подключение
git clone https://github.com/Panniantong/Agent-Reach.gitREADME
Зачем нужен Agent Reach?
AI-агент уже умеет писать код, редактировать документы, управлять проектами — но стоит попросить его найти что-то в интернете, и он беспомощен:
- 📺 «Расскажи, о чём этот YouTube-туториал» → не может: нет доступа к субтитрам
- 🐦 «Поищи в Twitter, что люди думают об этом продукте» → не может: Twitter API платный
- 📖 «Посмотри на Reddit, кто-нибудь сталкивался с таким багом» → 403: серверный IP заблокирован
- 📕 «Проверь репутацию бренда на XiaoHongShu» → не открывается: требует авторизации
- 📺 «Суммируй технический ролик с Bilibili» → недоступно: IP заблокирован
- 🔍 «Найди свежие сравнения LLM-фреймворков» → нет нормального поиска: либо платно, либо низкое качество
- 🌐 «Что написано на этой странице» → куча HTML-тегов, нечитаемо
- 📦 «Что делает этот GitHub-репозиторий? Что в Issues?» → работает, но настройка аутентификации громоздкая
- 📡 «Подпишись на эти RSS-ленты и уведоми об обновлениях» → нужно самому ставить библиотеки и писать код
Всё это реализуемо — но требует ручной настройки.
Каждая платформа имеет свои барьеры: платные API, блокировки, обязательная авторизация, грязные данные. Приходится разбираться с каждой по отдельности, устанавливать инструменты, настраивать конфиги — и только чтобы агент мог прочитать один твит.
Agent Reach сводит всё это к одной фразе:
Помоги мне установить Agent Reach: https://raw.githubusercontent.com/Panniantong/agent-reach/main/docs/install.md
Отправь это своему агенту — через несколько минут он сможет читать Twitter, искать по Reddit, смотреть YouTube и листать XiaoHongShu.
Уже установлено? Обновление — тоже одна строка:
Помоги мне обновить Agent Reach: https://raw.githubusercontent.com/Panniantong/agent-reach/main/docs/update.md
⭐ Поставь звезду проекту — мы следим за изменениями платформ и добавляем новые каналы. Если платформа заблокировала инструмент — починим; появился новый канал — добавим.
✅ Что стоит знать перед использованием
| 💰 Полностью бесплатно | Все инструменты открытые, все API бесплатные. Единственная возможная трата — серверный прокси (~$1/мес), на локальном компьютере не нужен |
| 🔒 Безопасность | Cookie хранятся только локально, никуда не передаются. Код полностью открыт |
| 🔄 Регулярные обновления | Базовые инструменты (yt-dlp, twitter-cli, rdt-cli, Jina Reader и др.) отслеживаются и обновляются |
| 🤖 Совместимость | Claude Code, OpenClaw, Cursor, Windsurf — любой агент с доступом к CLI |
| 🩺 Встроенная диагностика | agent-reach doctor покажет, что работает, что нет и как починить |
Поддерживаемые платформы
| Платформа | Работает сразу | После настройки | Как настроить |
|---|---|---|---|
| 🌐 Веб | Чтение любых страниц | — | Не требуется |
| 📺 YouTube | Субтитры + поиск видео | — | Не требуется |
| 📡 RSS | Чтение RSS/Atom-лент | — | Не требуется |
| 🔍 Поиск | — | Семантический поиск по всему вебу | Автоматически (MCP, бесплатно, без ключа) |
| 📦 GitHub | Публичные репозитории + поиск | Приватные репо, Issues/PR, Fork | Скажи агенту «помоги войти в GitHub» |
| 🐦 Twitter/X | Чтение отдельных твитов | Поиск, лента, публикация | Скажи агенту «помоги настроить Twitter» |
| 📺 Bilibili | Локально: субтитры + поиск | Работает и на сервере | Скажи агенту «помоги настроить прокси» |
| Поиск + чтение постов и комментариев (через rdt-cli) | Cookie | Требует авторизации (rdt login), см. rdt-cli | |
| 📕 XiaoHongShu | — | Чтение, поиск, публикация, комментарии, лайки | Скажи агенту «помоги настроить XiaoHongShu» |
| 🎵 Douyin | — | Парсинг видео, ссылки без водяного знака | Скажи агенту «помоги настроить Douyin» |
| Чтение публичных страниц через Jina Reader | Профили, страницы компаний, поиск вакансий | Скажи агенту «помоги настроить LinkedIn» | |
| 💬 WeChat (публичные аккаунты) | Поиск + чтение статей (полный Markdown) | — | Не требуется |
| Горячие темы, поиск, пользователи, комментарии | — | Не требуется | |
| 💻 V2EX | Популярные посты, разделы, детали постов, профили | — | Не требуется |
| 📈 Xueqiu | Котировки, поиск акций, горячие посты | — | Скажи агенту «помоги настроить Xueqiu» |
| 🎙️ Xiaoyuzhou (подкасты) | — | Транскрипция аудио (Whisper, бесплатный ключ) | Скажи агенту «помоги настроить Xiaoyuzhou» |
Не знаешь как настроить? Не нужно читать документацию. Просто скажи агенту «помоги настроить XXX» — он сам разберётся и проведёт по шагам.
🍪 Для платформ, требующих Cookie (Twitter, XiaoHongShu и др.), рекомендуется использовать Chrome-расширение Cookie-Editor: войди в браузере → экспортируй через Cookie-Editor → передай агенту.
🔒 Cookie хранятся только локально. Код полностью открыт. 💻 На локальном компьютере прокси не нужен. Прокси требуется только при развёртывании на сервере (~$1/мес).
Быстрый старт
⚠️ Пользователи OpenClaw: сначала убедитесь, что разрешение exec включено
Agent Reach требует, чтобы агент мог выполнять shell-команды (
pip install,mcporter,messagingпо умолчанию, агент не сможет выполнять команды. Перед установкой включите exec:openclaw config set tools.profile "coding"Или в
~/.openclaw/openclaw.jsonустановите"tools": { "profile": "coding" }. После этого перезапустите Gateway (openclaw gateway restart) и начните новый диалог. Другие платформы (Claude Code, Cursor, Windsurf и др.) этого не требуют.
Скопируй эту фразу и отправь своему AI-агенту (Claude Code, OpenClaw, Cursor и др.):
Помоги мне установить Agent Reach: https://raw.githubusercontent.com/Panniantong/agent-reach/main/docs/install.md
Всё. Агент сам сделает остальное.
🔄 Уже установлено? Обновление — тоже одна строка:
Помоги мне обновить Agent Reach: https://raw.githubusercontent.com/Panniantong/agent-reach/main/docs/update.md
🛡️ Беспокоишься о безопасности? Используй безопасный режим — системные пакеты не устанавливаются автоматически, только показывается, что нужно:
Помоги мне установить Agent Reach (безопасный режим): https://raw.githubusercontent.com/Panniantong/agent-reach/main/docs/install.md Используй параметр --safe
- Установка CLI-инструментов —
pip installустанавливает командуagent-reach - Установка системных зависимостей — автоматически определяет и устанавливает Node.js, gh CLI, mcporter, twitter-cli, rdt-cli и др.
- Настройка поисковика — подключает Exa через MCP (бесплатно, без API-ключа)
- Определение окружения — локальный компьютер или сервер, соответствующие рекомендации
- Регистрация SKILL.md — устанавливает руководство в директорию skills агента; когда агент встречает задачи вроде «поищи в Twitter» или «посмотри видео», он автоматически знает, какой инструмент вызвать
После установки agent-reach doctor покажет статус каждого канала.
Работает сразу после установки
Никакой настройки — просто скажи агенту:
- «Посмотри, что по этой ссылке» →
curl https://r.jina.ai/URLчитает любую страницу - «Что делает этот GitHub-репозиторий» →
gh repo view owner/repo - «О чём это видео» →
yt-dlp --dump-json URLизвлекает субтитры - «Покажи этот твит» →
twitter tweet URL - «Подпишись на этот RSS» → парсинг через
feedparser - «Найди LLM-фреймворки на GitHub» →
gh search repos "LLM framework"
Команды запоминать не нужно. После прочтения SKILL.md агент сам знает, что вызывать.
Философия проекта
Agent Reach — это скаффолдинг, не фреймворк.
Каждый раз, настраивая окружение для нового агента, приходится тратить время на поиск инструментов, установку зависимостей, конфигурацию: чем читать Twitter? Как обойти блокировку Reddit? Как извлечь субтитры YouTube? Каждый раз — одни и те же грабли.
Agent Reach делает одно простое дело: берёт на себя весь выбор инструментов и настройку.
После установки агент напрямую вызывает upstream-инструменты (twitter-cli, rdt-cli, xhs-cli, yt-dlp, mcporter, gh CLI и др.) — без промежуточного слоя Agent Reach.
🔌 Каждый канал — подключаемый модуль
За каждой платформой стоит отдельный upstream-инструмент. Не устраивает — замени.
channels/
├── web.py → Jina Reader ← можно заменить на Firecrawl, Crawl4AI…
├── twitter.py → twitter-cli ← можно заменить на официальный API…
├── youtube.py → yt-dlp ← можно заменить на YouTube API, Whisper…
├── github.py → gh CLI ← можно заменить на REST API, PyGithub…
├── bilibili.py → yt-dlp ← можно заменить на bilibili-api…
├── reddit.py → rdt-cli ← можно заменить на PRAW…
└── …
Лицензия
MIT — используй свободно.