Руководство по развертыванию Agent Reach: заставьте Claude Code / OpenClaw понимать Twitter / Xiaohongshu / Bilibili

Одной фразой: Ваш AI Agent отлично пишет код, но как только нужно «выйти в интернет и поискать что‑нибудь», сразу теряется? Agent Reach — лекарство в одну команду: одним махом ставит 14+ платформ — Twitter, Reddit, YouTube, Bilibili, Xiaohongshu, Douyin, WeChat Official Accounts… — а Agent сам понимает, какой инструмент вызывать.

Обзор проекта

Agent Reach — это «инсталлятор интернет-возможностей» для AI Agent, GitHub: Panniantong/Agent-Reach, лицензия MIT, Python-пакет.

Главная идея у него очень необычная: это не фреймворк, а леса (scaffolding).

Что это значит? Ваш AI Agent (Claude Code / OpenClaw / Cursor / Windsurf…) после установки Agent Reach не проходит через обёртку Agent Reach, а напрямую вызывает «входящие» инструменты — twitter-cli / rdt-cli / yt-dlp / xhs-cli / douyin-mcp-server / Jina Reader / gh CLI — те, которые автор проекта уже тщательно подобрал, обкатал на «граблях» и настроил дефолтными параметрами. Agent Reach отвечает только за:

1. Инсталляцию — одной строкой pip install agent-reach + agent-reach install ставит все эти апстрим‑инструменты
2. Диагностику — agent-reach doctor одной командой показывает, какие платформы работают, какие нет и как это чинить
3. Конфигурацию — управление Cookie-аутентификацией, API Key, MCP‑сервисами и т. п. «один раз и всё»
4. Внедрение SKILL — регистрирует для Agent SKILL.md, чтобы, когда ему попадётся задача вроде «найди в Twitter» или «посмотри видео», он автоматически подключал нужный инструмент

Поддержка 14+ платформ:

Одной фразой: не нужно помнить команды, не нужно возиться с парсерами — скажите Agent, и он пойдёт в интернет.

Сложность / время / польза

• Сложность: ⭐ (для новичков, реально одна команда)
• Время: 5–15 минут (на локальном ПК); 30 минут (сервер, включая настройку Cookie)
• Польза:
  • Claude Code / OpenClaw напрямую читает Twitter, листает Xiaohongshu и читает субтитры YouTube
  • Понимание различий в дизайне между «scaffolding vs framework» в экосистеме AI Agent‑инструментов
  • Умение использовать Cookie‑Editor для единого управления Cookie разных платформ, чтобы избежать проблем с QR‑входом
  • Понимание, что agent-reach doctor — это хорошая практика для инструментальной цепочки Agent

Кто читатель

• Разработчики, которые работают с Claude Code / OpenClaw / Cursor
• Хотят, чтобы Agent действительно мог искать информацию в интернете, а не просто «делал вид»
• Не хотят для Twitter / Reddit / Xiaohongshu отдельно ковырять парсеры под каждую платформу или платить за платные API
• Уже имеют цепочку инструментов для AI Agent и хотят добавить ещё один слой «интернет-возможностей»
• Когда Agent запускает длинные задачи и хочется найти способ подключения вычислений не слишком болезненный по цене (об этом дальше)

Основные зависимости и окружение

Минимальные требования:

Рекомендуется / опционально:

Полное дерево структуры проекта

Agent-Reach/
├── pyproject.toml                # Определение Python-пакета
├── agent_reach/
│   ├── __init__.py               # Номер версии
│   ├── cli.py                    # Вход CLI (argparse)
│   ├── core.py                   # Маршруты read/search
│   ├── config.py                 # Управление YAML-конфигом
│   ├── doctor.py                 # Диагностический движок
│   ├── cookie_extract.py         # Инструмент для извлечения Cookie
│   ├── channels/                 # Файл на каждую платформу
│   │   ├── base.py               # Абстрактный класс BaseChannel
│   │   ├── web.py                # Jina Reader
│   │   ├── twitter.py            # twitter-cli
│   │   ├── youtube.py            # yt-dlp
│   │   ├── github.py             # gh CLI
│   │   ├── bilibili.py           # yt-dlp + bili-cli
│   │   ├── reddit.py             # rdt-cli
│   │   ├── xiaohongshu.py        # xhs-cli
│   │   ├── douyin.py             # douyin-mcp-server
│   │   ├── linkedin.py           # linkedin-mcp
│   │   ├── wechat.py             # Exa + Camoufox
│   │   ├── rss.py                # feedparser
│   │   ├── exa_search.py         # Exa через mcporter
│   │   ├── weibo.py
│   │   ├── v2ex.py
│   │   ├── xueqiu.py
│   │   └── xiaoyuzhou.py
│   ├── integrations/
│   │   └── mcp_server.py         # Подключение MCP-сервера
│   ├── skill/                    # SKILL.md для Agent
│   ├── guides/                   # Документация (cn/eng/jp/kr)
│   ├── scripts/                  # Скрипты установки
│   └── utils/
├── config/
│   └── mcporter.json             # Конфигурация MCP-инструментов
├── tests/                        # pytest тесты
└── docs/                         # README многоязычный вариант

Как пользователь, вам достаточно тронуть только три команды: pip install / agent-reach install / agent-reach doctor. channels/ — это расширения для разработчиков.

Пошаговая инструкция

Шаг 1: Базовая установка (основной путь)

# Рекомендуется ставить изолированно через pipx
pipx install agent-reach

# Или через pip (важно: не ставьте в системный Python)
python3 -m venv ~/.agent-reach-venv
source ~/.agent-reach-venv/bin/activate
pip install agent-reach

После установки должна появиться команда:

agent-reach --version
# agent-reach 1.4.0

Шаг 2: Установка всех апстрим‑инструментов одной командой

# Режим по умолчанию: автоопределение окружения, установка всех зависимостей
agent-reach install --env=auto

Он последовательно:

1. Ставит системные зависимости (Node.js / gh CLI / mcporter / twitter-cli / rdt-cli и т. п.)
2. Настраивает поисковый движок (подключает Exa через MCP, без Key)
3. Определяет: локальная машина или сервер — и даёт разные рекомендации
4. Регистрирует SKILL.md в директории skills/ агента

openclaw config set tools.profile "coding"
openclaw gateway restart

Шаг 3: Проверка статуса каналов

agent-reach doctor

Вы должны увидеть что-то вроде:

✅ web              Jina Reader OK
✅ youtube          yt-dlp 2025.10.x installed
✅ rss              feedparser 6.0.x
✅ exa_search       Exa MCP connected
✅ github           gh CLI 2.x authenticated
⚠️  twitter         twitter-cli not logged in  → run: twitter login
⚠️  reddit          rdt-cli not logged in       → run: rdt login
✅ bilibili         yt-dlp OK
⚠️  xiaohongshu     xhs-cli not logged in      → see step 4
✅ douyin           douyin-mcp-server OK
✅ wechat           Exa search OK
✅ v2ex             API OK

✅ — всё готово «из коробки», ⚠️ — нужна дополнительная настройка (обычно это Cookie‑аутентификация).

Шаг 4: Настройте аутентификацию для платформ, которым нужны Cookie (особенно важно)

Twitter / Xiaohongshu / Reddit — это три типа, которым нужен логин‑состояние. Используйте Cookie‑аутентификацию, а не QR‑сканирование.

Сначала поставьте Cookie‑Editor: в магазине приложений Chrome/Edge найдите "Cookie-Editor" и установите.

Единый процесс:

1. В браузере вручную войдите в x.com / xiaohongshu.com / reddit.com
2. Нажмите на иконку плагина Cookie-Editor → "Export" → выберите формат "Netscape"
3. Скопированную строку Cookie отправьте Agent и скажите: "Помоги настроить Twitter"
4. Agent запустит cookie_extract.py и сохранит Cookie в ~/.agent-reach/config.yaml
5. Права файла 600, читать сможете только вы

# Можно и напрямую из командной строки, без Agent
agent-reach config set twitter.cookie "$(pbpaste)"  # macOS
agent-reach config set xhs.cookie "$(xclip -o)"     # Linux

Шаг 5: Проверка Cookie‑платформ

agent-reach doctor

Снова запустите диагностику: платформы, где раньше было ⚠️, должны стать ✅.

Шаг 6: Пусть Agent попробует один раз

Скажите вашему Agent (Claude Code / OpenClaw / Cursor):

Посмотри, что говорится в этом твите: https://x.com/vercel/status/1234567890

После чтения SKILL.md Agent автоматически вызовет команду twitter tweet URL и через несколько секунд вернёт текст твита.

Попробуйте разные комбинации:

Посмотри, о чём сейчас спорят на r/LocalLLaMA в Reddit
Прочитай этот YouTube-видео: https://youtube.com/watch?v=xxx
Посмотри, какие топовые посты по "кемпинговому снаряжению" есть на Xiaohongshu
Зачем нужен этот GitHub-репозиторий: https://github.com/xxx/yyy

Вы заметите одну деталь: вам не нужно говорить Agent, какую команду запускать. SKILL.md уже содержит сопоставления — «читать твит = twitter CLI», «смотреть видео = yt-dlp» и т. п. Это главное отличие Agent Reach от обычного набора инструментов: после установки Agent осознанно выбирает инструмент, а не «тыкает наугад».

Шаг 7 (опционально): Семантический поиск по всему интернету

По умолчанию Exa уже подключён, не нужен API Key. Спросите Agent:

Найди, пожалуйста, самые релевантные 5 материалов о том, как сравнивают LLM Agent framework в 2026 году

Он вызовет Exa MCP‑инструменты, получит результаты и затем вызовет Jina Reader, чтобы забрать полный текст и собрать отчёт.

Шаг 8 (опционально): Доступ к приватным репозиториям GitHub

# Один раз авторизоваться
gh auth login

После OAuth Agent сможет читать ваши приватные репозитории, создавать/отвечать на Issue, PR, делать review.

Шаг 9 (опционально): Усиление для Bilibili / Douyin

Bilibili на локальной машине — работает «из коробки». На зарубежном сервере нужен прокси (~$1/мес, рекомендуются резидентские прокси типа FluxNode):

# Допустим ваш прокси: http://127.0.0.1:7890
agent-reach config set bilibili.proxy "http://127.0.0.1:7890"
agent-reach doctor  # Перезапустите диагностику

Douyin вообще не требует логина — просто отправьте Agent ссылку на шаринг:

Разбери этот Douyin-видео: https://v.douyin.com/xxxxx

Agent вызовет mcporter call 'douyin.parse_douyin_video_info(...)' и вернёт вам информацию о видео + ссылки для скачивания без водяного знака.

Шаг 10 (опционально): Безопасный режим / удаление

Безопасный режим (для production‑серверов или машин с несколькими пользователями):

# Не будет автоматически ставить системные пакеты, только перечислит что сделает
agent-reach install --env=auto --safe

# Или сначала показать, что будет происходить, но не выполнять реально
agent-reach install --env=auto --dry-run

Полное удаление:

agent-reach uninstall             # Удалит конфиг + файлы skill
agent-reach uninstall --keep-config  # Сохранит token, пригодится при повторной установке
pip uninstall agent-reach         # Удалит Python-пакет

Частые проблемы и их решение

Q1: При установке OpenClaw появляется «permission denied» / Agent не двигается

Причина: у OpenClaw по умолчанию tools.profile = messaging, поэтому Agent не может выполнять shell-команды. Исправление:

openclaw config set tools.profile "coding"
openclaw gateway restart
# Откройте новый сеанс и снова отправьте: "Помоги установить Agent Reach"

Или поменяйте ~/.openclaw/openclaw.json:

{
  "tools": { "profile": "coding" }
}

Q2: QR‑логин в Xiaohongshu крутится вечно

Не используйте QR. Прямо так:

1. Установите Cookie‑Editor из магазина приложений Chrome
2. Зайдите в Xiaohongshu Web в браузере
3. Cookie‑Editor → Export → Netscape
4. Отправьте строку Agent и скажите: «Помоги настроить Xiaohongshu»
5. Через 30 секунд всё готово

Q3: Reddit возвращает 403 при каждом запросе

Reddit с 2024 года принудительно требует аутентификацию. Исправление:

# Установите rdt-cli (на этапе agent-reach install должно уже быть)
pipx install rdt-cli

# Однократный вход (он сам возьмёт Cookie из вашего Chrome)
rdt login

# Проверка
rdt search "LocalLLaMA" --limit 5

Аналогично Twitter / Xiaohongshu: rdt login работает через автоматическое извлечение Cookie из браузера, а не через QR.

Q4: Bilibili на зарубежном сервере не подключается

Зарубежные IP блокируются на Bilibili — нужен резидентский прокси. Варианты:

# Вариант 1: настройка через командную строку (рекомендуется FluxNode и подобные недорогие прокси)
agent-reach config set bilibili.proxy "http://user:pass@proxy:port"

# Вариант 2: переменные окружения
export HTTP_PROXY="http://user:pass@proxy:port"
export HTTPS_PROXY="http://user:pass@proxy:port"

Недорогой резидентский прокси стоит примерно ~$1/мес — не нужно собирать всё самому.

Q5: agent-reach doctor пишет «channel not found» / конфликт файлов каналов

Обычно это значит, что часть апстрим‑инструментов не установилась или установилась не туда (например, в системный Python вместо pipx). Самое чистое решение — начать заново полностью:

agent-reach uninstall
pipx uninstall agent-reach
# очистка возможных остатков ~/.agent-reach/
rm -rf ~/.agent-reach/

pipx install agent-reach
agent-reach install --env=auto
agent-reach doctor

Q6: Поменяли браузер / истёк срок действия Cookie

Cookie истекают через несколько месяцев — просто повторите процесс «вход в браузере → Cookie‑Editor экспорт → отправка Agent». Agent автоматически перезапишет старые Cookie в ~/.agent-reach/config.yaml.

Q7 (Бонус): У Agent длинные задачи — и счёт за токены разносит. Как считать?

Расскажу про один из тех «граблей», на которые я сам наступил, когда подключал Agent для работы.

Agent Reach решает проблему «как Agent выходит в интернет», но при вызове инструментов сам Agent по сути всё равно потребляет LLM‑токены. Типичная задача «изучить конкурентов и составить сводку» обычно включает 5–10 циклов инструментов (поиск, получение страниц, чтение твитов, снова поиск, снова чтение), а за один цикл набегают десятки/сотни тысяч токенов. Если в день прогонять 20+ таких задач, то счет очень быстро взлетает.

По моему опыту развертывания есть три способа подключения:

1. Подключить официальное API Anthropic — самый полный опыт, но Claude Opus, который гоняет Agent‑задачи, в день даёт разумные четырёхзначные суммы в юанях
2. Подключить агрегаторы вроде OpenRouter — немного дешевле официальных, но всё равно дорого
3. Подключить Defapi — сейчас мой вариант. Половина цены официальных, при этом протокольно полностью совместимо: со стороны Agent Reach конфигурация остаётся прежней — ничего менять в SKILL / prompt / коде вызова инструментов не нужно

Пример конкретной конфигурации (если ваш Agent использует Claude / Anthropic протокол):

# ~/.openclaw/openclaw.json или env-настройка для Claude Code
ANTHROPIC_BASE_URL=https://api.defapi.org
ANTHROPIC_API_KEY=sk-xxxxxx    # получить в админке defapi.org

Все модели Defapi в основном совместимы с тремя популярными наборами протоколов — v1/chat/completions (OpenAI) / v1/messages (Anthropic) / v1beta/models (Gemini). Сменить модель — просто сменить название. При задачах «инструмент‑интенсивный режим» (агент читает твиты, анализирует Xiaohongshu, делает сводку субтитров к видео) ежемесячный счёт реально падает с четырёхзначных значений до трёхзначных.

Дополнительное чтение / направления для углубления

• Пользовательские channel: добавьте файл в agent_reach/channels/, унаследуйте BaseChannel и реализуйте четыре метода: can_handle(url) / read(url) / search(query) / check(). Затем достаточно сделать pip install -e .. Порог низкий: «одна платформа — один файл»
• Замена апстрим‑инструментов: channels/web.py по умолчанию использует Jina Reader. Если кажется, что не подходит — можно заменить на Firecrawl / Crawl4AI / свой парсер: поменяйте import — и готово
• Механизм SKILL.md: после установки Agent Reach SKILL.md автоматически регистрируется в ~/.claude/skills/ / ~/.openclaw/skills/. Вы можете написать свой SKILL.md и научить Agent в конкретных сценариях приоритизировать нужный channel
• Любой MCP через mcporter: не только Exa — любой сервер, совместимый с MCP, можно подключить через config/mcporter.json. Меняйте алиас и соответствующую команду запуска
• Общий доступ между несколькими Agent: конфигурация Agent Reach ~/.agent-reach/config.yaml хранится на уровне файлов — несколько Agent (Claude Code + OpenClaw + Cursor) на одной машине могут делиться одной и той же конфигурацией
• Связка с Defapi: Agent Reach забирает данные, Defapi запускает рассуждения. Это «слой получения информации» и «слой стоимости вычислений». Оба протокольно‑драйвенные — вместе это даёт workflow длинных задач с низкой стоимостью

GitHub-репозиторий: Panniantong/Agent-Reach. Многоязычная документация лежит в docs/README_en.md / docs/README_ja.md / docs/README_ko.md, а дизайн‑идея — в конце README в разделе «设计理念» («Дизайн‑идея»). Хотите добавить channel — просто сделайте PR. Автор Neo Reid поддерживает проект очень активно.