xurl

Что делает навык

xurl — это CLI-инструмент для взаимодействия с API X (Twitter), поддерживающий аутентифицированные посты, ответы, поиск, прямые сообщения, загрузку медиа и управление подписками. Он предоставляет удобные сокращенные команды для частых операций и режим raw для прямых вызовов любого v2 API.

Когда применять

• Отправка текстовых постов, ответов, цитат или удаление существующих записей.
• Поиск твитов, просмотр ленты, упоминаний, а также управление подписчиками и списком блокировок.
• Отправка прямых сообщений (DM) и управление историей переписки.
• Загрузка изображений и видео с последующим прикреплением медиа к новым постам.
• Выполнение произвольных запросов к v2 API X, когда стандартные сокращения не подходят.

Как работает

1. Проверить текущую аутентификацию с помощью команды xurl auth status.
2. Выполнить нужное действие через сокращенную команду (например, xurl post, xurl search) или использовать raw-режим (xurl /2/... или xurl -X POST) для сложных запросов.
3. При работе с медиа сначала загрузить файл через xurl media upload, дождаться обработки и получить MEDIA_ID, затем использовать его в команде создания поста.
4. Передавать секреты и токены через промпт, а не в виде аргументов командной строки, чтобы избежать их попадания в историю shell.
5. Обрабатывать ошибки: при 401/403 проверять права доступа, при 429 — делать паузу, при ошибках загрузки медиа — проверять тип и размер файла.

Примеры запросов агенту

Что понадобится

• Установленный инструмент xurl и наличие токенов в файле ~/.xurl.
• Доступ к интернету для вызовов API X.

Описание составлено по SKILL.md навыка, сверено 06.10.2026.

Как подключить

Навык — папка с файлом SKILL.md (описание + инструкции) и опциональными скриптами. Ассистент (Claude, Claude Code и совместимые) подхватывает его по описанию и следует шагам.