CLI-инструмент для аутентифицированного доступа к API X (Twitter) — публикуйте посты, отвечайте на них, выполняйте поиск, управляйте подписчиками, отправляйте личные сообщения, загружайте медиафайлы и обращайтесь к любому конечному узлу v2.
npx clawhub@latest install xurlТребования
xurl — это CLI-инструмент для взаимодействия с X (Twitter) API v2. Он предоставляет удобные команды-ярлыки для людей и агентов, охватывающие наиболее распространённые действия — публикацию постов, ответы, поиск, лайки, подписки, отправку личных сообщений и загрузку медиафайлов, — а также доступ в стиле curl к любому эндпоинту X API v2. Все команды возвращают структурированный JSON в stdout, что позволяет легко передавать результаты в другие инструменты или рабочие процессы агентов.
npx clawhub@latest install xurlНажмите кнопку Установить вверху страницы для настройки в один клик
~/.xurl небезопасно или невозможно.Готовые однострочные команды охватывают публикацию, ответы, цитирование, удаление, поиск, лайки, репосты, добавление в закладки, подписку, блокировку, отключение звука, отправку личных сообщений и загрузку медиафайлов. Нет необходимости вручную формировать необработанные API-запросы для повседневных задач.
Помимо быстрых команд, xurl работает как универсальный клиент X API. Используйте xurl /2/some/endpoint с флагами -X, -d и -H для обращения к любому эндпоинту v2 — так же, как curl, но с автоматической обработкой аутентификации.
Регистрируйте несколько X-приложений и аутентифицируйте несколько аккаунтов OAuth 2.0 на каждое приложение. Переключайтесь между ними с помощью xurl auth default или переопределяйте для конкретного запроса с помощью флагов --app и --username.
Загружайте изображения или видео с помощью xurl media upload, затем прикрепляйте возвращённый media_id напрямую к публикации или ответу. Статус обработки видео можно отслеживать с помощью xurl media status --wait.
Известные потоковые эндпоинты (например, /2/tweets/search/stream, /2/tweets/sample/stream) определяются автоматически и обрабатываются корректно. Любой эндпоинт можно принудительно перевести в потоковый режим с помощью флага -s.
Учётные данные хранятся локально в ~/.xurl и никогда не передаются в явном виде. Инструмент применяет строгую политику запрета встроенных секретов, что делает его использование более безопасным внутри рабочих процессов ИИ-агентов или LLM, где существует риск утечки через подсказки или контекст.
Агент может искать публикации по теме с помощью xurl search, читать контекст с помощью xurl read, а затем отвечать на наиболее релевантные результаты или ставить им лайки — всё это в рамках единого цепочечного рабочего процесса со структурированным JSON на каждом этапе.
Загрузите подготовленное изображение с помощью xurl media upload, захватите media_id из JSON-ответа и немедленно прикрепите его к новой публикации — это позволяет создавать полностью автоматизированные конвейеры публикации насыщенного медиаконтента.
Периодически проверяйте упоминания, домашнюю ленту, новых подписчиков и личные сообщения с помощью xurl mentions, xurl timeline, xurl followers и xurl dms для создания панелей мониторинга или уведомляющих ботов.
Зарегистрируйте отдельные приложения для dev и prod, выполните независимую аутентификацию для каждого из них и переключайтесь между ними с помощью xurl auth default или флага --app для отдельных запросов — не смешивая учётные данные.
~/.xurl. Поддерживает OAuth 2.0 (рекомендуется), OAuth 1.0a и аутентификацию только через приложение. Получите учётные данные на developer.x.com.npx clawhub@latest install xurlТребования
Войдите, чтобы написать отзыв
Отзывов пока нет. Будьте первым, кто поделится своим опытом!