Примечание автора: начинаем с одной фразы, сказанной агенту, и шаг за шагом ставим Agent-Reach, чтобы Claude Code, Codex и другие агенты могли читать заметки Xiaohongshu, посты в X и субтитры Bilibili. В конце — таблица каналов, сопоставление команд, устранение неполадок и оценка затрат.
Попросите агента провести анализ конкурентов — и он быстро упрётся в стену. Вы говорите ему: «посмотри, как на Xiaohongshu отзываются об этих наушниках» — а встроенный веб-поиск возвращает лишь пару перепечаток, сами заметки Xiaohongshu найти невозможно. Вы просите: «суммируй, что за эту неделю публиковал такой-то аккаунт в X» — а он не может пробиться сквозь стену авторизации к таймлайну.
С видео всё ещё хуже. В 40-минутном техническом докладе на Bilibili вся ценная информация — в устной речи. Обычный поиск не достаёт субтитры Bilibili, и агенту остаётся гадать по заголовку и описанию. Китайские платформы вроде Xueqiu и V2EX в обычном поиске представлены слабо, а страницы, которые он возвращает, напичканы навигацией и рекламой.
Именно эту проблему решает открытый проект Agent-Reach. У него уже больше 100 тысяч звёзд на GitHub, а его позиционирование — «дать AI-агенту дотянуться до того интернета, куда он сам попасть не может». Это не очередной инструмент, где нужно грызть командную строку: главная линия этого руководства — установка одной фразой, сказанной агенту, а дальше добавление каналов, смена аккаунта и обновление тоже делаются простыми словами.
Главная ценность: дочитав статью, вы научите своего агента читать контент с X, Reddit, Bilibili, Xiaohongshu и других платформ, а также будете чётко понимать, как проверять каждый шаг, что делать при ошибках и во сколько примерно обойдётся одно исследование.
Ключевые моменты руководства по Agent-Reach
Прежде чем браться за дело, давайте разложим по полочкам ключевые факты об Agent-Reach в одной таблице. Информация ниже основана на проверке репозитория проекта 26 октября 2026 года.
| Пункт | Описание | Что это даёт вам |
|---|---|---|
| Популярность проекта | Более 100 тысяч звёзд, однажды занял первое место в дневном рейтинге Trendshift GitHub Trending | Активное сообщество, на вопросы реагируют |
| Лицензия и окружение | Открытый исходный код под MIT, написан на Python 3.10+ | Можно пользоваться бесплатно и самостоятельно изучить код |
| Расходы на платформе | Сам по себе бесплатен, никаких плат за API платформы | Реальные затраты — только токены модели вашего агента |
| Принцип работы | Только чтение: ищет и читает, но не публикует посты, не комментирует, не ставит лайки и не пишет в личные сообщения | Не будет «говорить» за вас на платформах |
| Формат вывода | Начиная с версии 1.6 каждая команда выводит один JSON-объект | Агенту достаточно прочитать ok / result / error.hint, чтобы понять, успешно ли всё прошло |
Четыре типа «недосягаемого», которые решает Agent-Reach
У таких CLI-агентов, как Claude Code, Codex, Hermes Agent и OpenClaw, есть встроенный поиск и чтение веб-страниц, но существует четыре типа контента, до которых они по своей природе не дотягиваются. Первый тип — функции, доступные только после входа в аккаунт: например, поиск заметок в Xiaohongshu, проверка активности аккаунта в X, чтение деталей вакансии. Второй тип — содержимое видео: субтитры Bilibili и YouTube, а также расшифровка речи из видео на YouTube и подкастов Xiaoyuzhou.
Третий тип — китайские платформы: Bilibili, Xiaohongshu, V2EX и Xueqiu очень плохо покрыты обычным поиском. Четвёртый тип — чистые структурированные данные: котировки Xueqiu, посты и ответы на V2EX, репозитории и issues на GitHub. Agent-Reach возвращает уже приведённый в порядок контент, а не целую страницу HTML, и это напрямую сокращает количество токенов, которые тратит агент.
Как устроен Agent-Reach: основной инструмент плюс запасной
В Agent-Reach каждое действие на каждой платформе оформлено как «список инструментов, которые пробуются по очереди». Например, для чтения видео с Bilibili сначала используется bili-cli, а при неудаче автоматически подключается публичный API Bilibili; для чтения веб-страниц сначала Jina Reader, затем Exa. Редизайн платформ и выход инструментов из строя — обычное дело, и мейнтейнерам достаточно поправить этот список, а для вас и вашего агента способ использования ничуть не меняется.
Какие каналы поддерживает Agent-Reach
В текущей версии каналы делятся на три уровня: каналы по умолчанию работают сразу после установки; опциональные включаются одной фразой — достаточно сказать Agent: «Добавь XX», — и нужное ПО установится автоматически; экспериментальные каналы работают, но платформы там строже борются с парсингом, поэтому они могут перестать работать в любой момент. Эту таблицу советую сохранить: она отвечает на два самых частых вопроса — «что умеет» и «что нужно».
| Канал | Уровень | Что умеет | Что нужно |
|---|---|---|---|
| bilibili | По умолчанию | Поиск, информация о видео, популярное, субтитры | Для субтитров нужен вход по QR-коду |
| v2ex | По умолчанию | Популярное, узлы, посты и ответы, пользователи | Вход не требуется |
| github | По умолчанию | Поиск репозиториев, чтение репозиториев и README, чтение issue и PR (включая комментарии) | Вход не требуется |
| youtube | По умолчанию | Информация о видео, поиск, субтитры, распознавание речи в текст | Для распознавания речи нужен ключ Groq или OpenAI |
| web | По умолчанию | Веб-поиск, чтение веб-страниц (запасной канал) | Вход не требуется |
| xiaohongshu | Опциональный | Поиск заметок, чтение текста, просмотр комментариев | Нужен вход |
| xueqiu | Опциональный | Котировки в реальном времени, поиск акций, горячие посты, горячие акции | Котировки без входа, для горячих постов и акций нужен вход |
| boss | Опциональный | Поиск вакансий и JD | Нужен вход |
| xiaoyuzhou | Опциональный | Расшифровка подкастов в текст | Нужен ключ Groq |
| Опциональный | Поиск вакансий, чтение деталей вакансии | Публичные вакансии без входа, для поиска внутри сайта нужен вход | |
| Опциональный | Поиск постов, чтение текста, просмотр комментариев, просмотр разделов | Нужен вход | |
| twitter (X) | Экспериментальный | Поиск твитов, профили пользователей, твиты пользователей, чтение тредов | Нужен вход |
| Экспериментальный | Поиск, данные страницы | Нужен вход | |
| Экспериментальный | Поиск пользователей, данные профиля, посты пользователя | Нужен вход |
Стоит отметить: каналы по умолчанию можно убрать, если они не нужны, — после удаления они не будут автоматически добавляться обратно при обновлениях. Упомянутый в заголовке X сейчас относится к экспериментальным каналам: он подходит для редких запросов, но не как стабильный источник данных на каждый день.
Быстрый старт с Agent-Reach: одна фраза агенту
Весь процесс установки не требует открывать терминал. У каждого шага ниже есть критерий проверки: убедитесь, что он выполнен, и переходите к следующему. Если что-то пойдёт не так, смотрите таблицу ошибок ниже.
Шаг 1: В настройках агента включите «Разрешить выполнение команд»
Agent-Reach нужно, чтобы агент мог выполнять команды терминала. Найдите в графическом интерфейсе настроек вашего агента переключатель вроде «Разрешить выполнение команд» и включите его — у разных агентов этот пункт может называться чуть иначе. Даже если на компьютере нет uv, не страшно: агент сначала сам установит uv. Для этого достаточно одной команды, а пароль администратора не понадобится.
- Критерий проверки: скажите агенту «Покажи текущий каталог». Он должен действительно выполнить команду и вернуть путь, а не ответить «Я не могу выполнять команды».
Шаг 2: Отправьте команду установки агенту
Это официально рекомендованный и самый простой способ. Просто скопируйте фразу ниже и отправьте её агенту:
帮我安装 Agent Reach：https://raw.githubusercontent.com/Panniantong/Agent-Reach/main/docs/install.md
Прочитав инструкцию по установке, агент сам сделает две вещи: сначала выполнит uv tool install https://github.com/Panniantong/Agent-Reach/releases/latest/download/agent-reach.zip, а затем — agent-reach setup. Все файлы складываются в одну папку ~/.agent-reach/, так что потом будет удобно обновлять, обслуживать и удалять.
- Критерий приёмки: агент сообщает об успешной установке, и после выполнения
agent-reach channelsв возвращаемом JSON полеokравно true, а вresultперечислен список каналов.
Шаг 3: Попросите агента проверить статус каналов
Скажите агенту «посмотри статус Agent Reach». Он расскажет, какие каналы сейчас работают, а какие сломались — хотя в прошлый раз были в порядке. Это что-то вроде техосмотра; если потом возникнут странные проблемы, тоже советую начинать именно с него.
- Критерий приёмки: пять каналов по умолчанию — bilibili, v2ex, github, youtube, web — показывают «доступен»; для функций, которым нужны дополнительные условия, например субтитров Bilibili или перевода YouTube в текст, сообщение «требуется вход» или «требуется ключ» — это нормально.
Шаг 4: Добавляем опциональные каналы и завершаем вход
Возьмём для примера Xiaohongshu: скажите агенту «добавь мне Xiaohongshu», и он сам установит всё необходимое. Платформы, где требуется вход, обрабатывает встроенный в Agent-Reach специальный браузер — он работает в фоне, без всплывающих окон, и доступен только на этом компьютере. Он никогда не входит в аккаунт за вас и не запрашивает пароль.
Некоторые платформы переиспользуют уже имеющийся на вашем компьютере статус входа — копируется вход только для этого одного сайта, исходный браузер не меняется, и база паролей не читается. Здесь обязательно прочитайте предупреждение о рисках в следующем разделе. Если переиспользуется вход в основной аккаунт, скажите агенту «смени аккаунт» и переключитесь на дополнительный.
- Критерий приёмки: ещё раз скажите «посмотри статус Agent Reach» — xiaohongshu должен отображаться как доступный; затем попросите агента найти ключевое слово — в результатах должны быть заголовки заметок и фрагменты текста.
Шаг 5: Запускаем первое кросс-платформенное исследование
Достаточно описать цель на естественном языке, например: «С помощью Agent Reach выясни, что люди думают о конкретной механической клавиатуре — посмотри заметки в Xiaohongshu, субтитры обзоров на Bilibili и обсуждения на Reddit, а в конце сделай сводку по каждой платформе». Агент сам разобьёт задачу на несколько команд agent-reach <канал> <действие> [параметры] и выполнит их.
- Критерий приёмки: сводка агента разбита по платформам, и каждое мнение можно соотнести с конкретной заметкой, видео или постом; если какой-то канал не сработал, он передаст подсказку из
error.hint, а не пропустит её молча.
🚀 Совет для быстрого старта: Agent-Reach отвечает только за добычу контента — понимание и суммирование ложится на большую языковую модель, стоящую за агентом. Если ваш агент поддерживает собственный интерфейс модели, можно через APIYI apiyi.com подключить Claude, GPT, Gemini и другие модели по одному API-ключу. Новым пользователям доступен бесплатный тестовый лимит — удобно сначала недорого прогнать первое исследование.
Как подключить к Agent интерфейс моделей APIYI
Если ваш Agent поддерживает OpenAI-совместимый интерфейс, схема настройки будет такой. Точные названия полей смотрите в интерфейсе настроек вашего Agent:
- Адрес интерфейса (base_url):
https://api.apiyi.com/v1 - API Key: ключ, созданный в консоли APIYI
-
Имя модели: для повседневных исследований рекомендуем
claude-sonnet-5-5, для массовых лёгких задач можно выбратьclaude-haiku-5-5 -
Критерий проверки: отправьте в Agent фразу «Привет, скажи, какая ты модель». Он должен нормально вернуть ответ, а в консоли APIYI должна появиться соответствующая запись о вызове.
Таблица частых команд Agent-Reach
В повседневной работе достаточно говорить Agent фразу из левого столбца. Команды справа нужны, чтобы понимать, что Agent делает за кулисами, или чтобы разбираться с проблемами в собственном терминале.
| Что сказать Agent | Команда, которую Agent выполняет | Назначение |
|---|---|---|
| «Какие есть каналы и что каждый умеет» | agent-reach channels |
Посмотреть каналы и их возможности |
| «Поищи на Bilibili большие языковые модели» | agent-reach bilibili search "大模型" |
Единый формат: канал + действие + параметры |
| «Прочитай эту ссылку» | agent-reach read <链接> |
Автоматически выбрать канал по ссылке |
| «Обнови Agent Reach» | agent-reach update |
Обновить программу, инструменты всех каналов и skill за один раз |
| «После установки пишет, что команда не найдена» | uv tool update-shell, затем открыть новый shell |
Исправить путь к команде |
| (сделать самому в терминале) | agent-reach configure groq-key |
Указать ключ, нужный для распознавания речи |
| «Удали Agent Reach» | Сначала перечислить, что будет удалено, потом удалить после подтверждения | Безопасное удаление |
Кроме того, фразы «Убери Xiaohongshu», «У Xiaohongshu истёк срок входа», «Выйди из аккаунта», «Сделай так, чтобы другой AI тоже мог пользоваться» тоже можно говорить Agent напрямую — запоминать команды не нужно.
Предупреждение о рисках Agent-Reach (прочитать перед использованием)
⚠️ Пожалуйста, внимательно прочитайте этот раздел перед использованием Agent-Reach
- Это инструмент с открытым исходным кодом, созданный сообществом, а не официально авторизованный API какой-либо платформы. Мы просто рекомендуем этот проект и не даём никаких гарантий относительно его стабильности, безопасности и соответствия требованиям.
- Аккаунт может быть ограничен или заблокирован. Такие платформы, как X, Xiaohongshu и Reddit, могут расценить автоматизированный доступ как подозрительную активность. В официальном README также прямо рекомендуется использовать дополнительный аккаунт — не запускайте агента с важного аккаунта.
- Повторное использование локальной авторизации может подключить основной аккаунт. Некоторые каналы используют уже существующее состояние входа на компьютере, а вы обычно входите в основной аккаунт. После включения канала сначала проверьте, какой аккаунт используется, и при необходимости скажите агенту «смени аккаунт», чтобы переключиться на дополнительный.
- Ответственность лежит на вас. Все последствия — блокировка аккаунта, ограничение доступа, вопросы соответствия при сборе и использовании данных — читатель оценивает и несёт самостоятельно; они не связаны с платформой APIYI и автором этой статьи.
- Проверяйте источник установки. Пакет с именем agent-reach на PyPI — это не данный проект, устанавливать можно только из репозитория на GitHub; у проекта нет никаких официальных токенов, монет, инвестиционных продуктов или подключений к кошелькам, и все криптопроекты, использующие это название, к данному репозиторию отношения не имеют.
Таблица неполадок Agent-Reach
Ниже — пять самых частых ситуаций, с которыми сталкиваются на старте. Каждую можно разобрать по шагам. Перед тем как начинать, попросите агента один раз выполнить «посмотреть статус Agent Reach» и показать вам исходный текст error.hint.
| Симптом | Причина | Решение |
|---|---|---|
После установки пишет, что команда agent-reach не найдена |
Каталог инструментов uv ещё не добавлен в PATH | Попросите агента выполнить uv tool update-shell, затем откройте новый shell (или перезапустите агента) и попробуйте снова |
| Агент отвечает «Я не могу выполнять команды» | Не включено разрешение на выполнение команд | Вернитесь к шагу 1 и включите в настройках агента пункт «Разрешить выполнение команд» |
| После обновления с версии 1.5 сыпятся ошибки | Версии 1.5 и более ранние ставились через pipx/pip | Попросите агента выполнить uv tool install --force с адресом установки из GitHub, а затем запустить agent-reach setup — ключи и настройки сохранятся |
| Xiaohongshu внезапно перестал находить контент и требует войти | Срок действия сессии входа истёк | Скажите агенту «сессия входа в Xiaohongshu истекла» и войдите заново по подсказкам (лучше с дополнительного аккаунта) |
| Канал X работает нестабильно | twitter — экспериментальный канал, платформа активнее борется со скрейпингом | Сначала проверьте статус, чтобы понять, не отвалился ли канал. Если отвалился — дождитесь обновления проекта и выполните agent-reach update, а также можно сообщить о проблеме в GitHub Issues |
Стоимость и выбор моделей для Agent-Reach
Сам Agent-Reach бесплатен, платы за API платформы тоже нет. Реальные деньги уходят на токены, которые расходует агент, вызывающий большую языковую модель. Ниже — цены трёх моделей, найденные 26.10.2026 в справочном центре APIYI apiyi.com. Единица измерения — доллары за миллион токенов, актуальные модели и цены смотрите в списке моделей на платформе.
| Модель | Ввод | Вывод | Чтение из кэша | Подходящие задачи Agent-Reach | Доступная платформа |
|---|---|---|---|---|---|
| claude-opus-5-5 | $4 | $20 | $0.2 | Длинные исследовательские отчёты, перекрёстная проверка данных из нескольких источников | APIYI apiyi.com |
| claude-sonnet-5-5 | $2 | $10 | $0.1 | Основной выбор для повседневных кросс-платформенных исследований | APIYI |
| claude-haiku-5-5 | $0.1 | $0.5 | $0.01 | Пакетные саммари, простой поиск, проверка статусов | APIYI |
Прикинем на глаз (это оценка, не замеры): одно исследование по 4 платформам — агент читает 5 длинных постов плюс 20 результатов поиска, на входе примерно 30–60 тыс. токенов, на выходе 3–6 тыс. Если считать по claude-sonnet-5-5, разовый прогон обойдётся примерно в $0.1; на claude-haiku-5-5 — меньше цента; на claude-opus-5-5 — где-то от $0.2 до $0.35.
Рекомендация простая: сначала прогоните весь процесс на sonnet, потом по качеству результата решайте, стоит ли переходить на opus, а повторяющиеся пакетные задачи отдавайте haiku. Agent-Reach возвращает уже структурированный, приведённый в порядок контент — это само по себе экономит токены по сравнению с чтением исходных веб-страниц агентом. А при регулярном использовании имеет смысл следить за экономией на чтении из кэша.
Частые вопросы (FAQ)
Вопрос 1: Agent-Reach действительно полностью бесплатен?
Сам Agent-Reach бесплатен и распространяется по лицензии MIT, а платформы не берут плату за API. Платить придётся только за токены, которые Agent тратит на вызовы большой языковой модели. По оценке выше, одно исследование по четырём платформам на модели уровня Sonnet обойдётся примерно в 0,1 доллара. Если хотите сначала попробовать, можно получить бесплатный тестовый лимит для новых пользователей через APIYI (apiyi.com) и запустить первую задачу.
Вопрос 2: Может ли Agent публиковать посты, ставить лайки или писать в личные сообщения от моего имени?
Нет. Agent-Reach — инструмент только для чтения: он ищет и читает, но не публикует посты, не комментирует, не ставит лайки и не пишет в личные сообщения. Но «только для чтения» не означает «нулевой риск»: платформа всё равно может расценить частые обращения как подозрительную активность. Поэтому по-прежнему советую использовать дополнительный (запасной) аккаунт — подробности в разделе о рисках.
Вопрос 3: Как включить расшифровку речи в текст для YouTube и Xiaoyuzhou? Нужно ли отправлять ключ Agent?
Для расшифровки YouTube нужен ключ Groq или OpenAI, для Xiaoyuzhou — ключ Groq. **Не отправляйте ключ прямо в чате** — официально требуется выполнить в своём терминале команду `agent-reach configure groq-key` и ввести его там. Как проверить: попросите Agent расшифровать видео на YouTube — в возвращённом JSON поле `ok` должно быть true и должен присутствовать текст.
Вопрос 4: С какой моделью Agent-Reach работает лучше всего?
Для повседневных исследований советую начать с claude-sonnet-5-5: она хорошо балансирует между пониманием контента из разных источников и контролем затрат. Когда нужен глубокий анализ, переключайтесь на claude-opus-5-5. Через APIYI (apiyi.com) с одним ключом можно переключаться между этими моделями, меняя только название модели, без изменения адреса интерфейса — удобно сравнивать результаты на одной и той же исследовательской задаче.
Вопрос 5: Я уже установил Agent-Reach в Claude Code — как дать им пользоваться другому Agent?
Просто скажите уже настроенному Agent: «пусть другой AI тоже сможет этим пользоваться» — он сам займётся общей конфигурацией. Поскольку все файлы лежат в одной папке `~/.agent-reach/`, другому Agent достаточно иметь такие же права на выполнение команд. Как проверить: скажите новому Agent «посмотри статус Agent Reach» — он должен вернуть тот же список каналов, что и исходный Agent.
Ключевые моменты руководства по Agent-Reach
- Суть в двух словах: Agent-Reach позволяет агенту читать контент за логин-стеной, внутри видео и на китайских платформах.
- Как установить: отправьте агенту ссылку на официальный install.md — он сам поставит uv и agent-reach.
- Три уровня каналов: 5 включены из коробки по умолчанию, ещё 6 можно открыть одной фразой, а 3 экспериментальных могут в любой момент перестать работать.
- Только чтение: никаких постов, лайков и личных сообщений — вывод всегда в виде JSON с полем
ok. - Безопасность аккаунта: это инструмент сообщества, а не официальный API, так что возможны лимиты и блокировки — обязательно используйте запасной аккаунт.
- Контроль затрат: плата за API платформ — 0, основные расходы — это токены модели, которые можно оплачивать по факту через APIYI apiyi.com.
Итог
Главное из руководства по Agent-Reach:
- Решает реальную проблему: заметки из Xiaohongshu, динамику аккаунтов в X, субтитры с Bilibili, которые не находит обычный поиск, теперь агент может читать напрямую.
- Нулевой порог входа: достаточно одной фразы агенту для установки, а дальше добавлять каналы, менять аккаунты и обновляться можно простыми словами.
- Риски нужно осознавать: это открытый инструмент сообщества, используйте запасной аккаунт, внимательно смотрите, какие аккаунты переиспользуются, и принимайте последствия на себя.
Совет: сначала прогоните исследование по Bilibili или GitHub на каналах по умолчанию, убедитесь, что каждый шаг проверки проходит, и только потом добавляйте каналы, требующие входа, — Xiaohongshu, Reddit и другие.
Нужны модели — можно через APIYI apiyi.com.
📚 Справочные материалы
- Репозиторий Agent-Reach на GitHub: исходный код проекта, README и описание каналов
- Ссылка:
github.com/Panniantong/Agent-Reach -
Пояснение: единственный надёжный источник установки; список каналов и инструкции по безопасности сверяйте с ним.
-
Официальная инструкция по установке Agent-Reach: документация по установке, которую читает агент
- Ссылка:
raw.githubusercontent.com/Panniantong/Agent-Reach/main/docs/install.md -
Пояснение: именно этот адрес отправляется агенту на шаге 2 статьи.
-
GitHub Issues проекта Agent-Reach: канал обратной связи по проблемам
- Ссылка:
github.com/Panniantong/Agent-Reach/issues - Пояснение: если экспериментальный канал перестал работать или возникла ошибка установки, здесь можно поискать решение или сообщить о проблеме.
Автор: техническая команда APIYI
По техническим вопросам: свяжитесь с нами на главной странице сайта APIYI; больше материалов — в центре документации docs.apiyi.com.
