Для ИИ-ассистентов
Инструмент скачивания, который может вызвать ассистент
GrabGrab — обычный сайт и простой HTTP API. Помощнику не нужно управлять браузером. Он отправляет ссылку X или ссылку TikTok, Vimeo или Facebook, читает JSON и сохраняет файл.
Шаг 1
Скопируйте публичный URL видео из X, Twitter, TikTok, Vimeo или Facebook.
Шаг 2
Отправьте его методом POST на https://www.grabgrab.fun/api/download в виде JSON с полями url и videoQuality. Значение 1080 — удачный вариант по умолчанию.
Шаг 3
Если success равно true, а type равен direct, скачайте поле url командой curl -L. Если CDN это блокирует, используйте вместо этого подписанный proxyUrl на grabgrab.fun.
Шаг 4
Сообщите человеку имя файла. Если в ответе ошибка, покажите её. Не повторяйте попытку для YouTube: отказ сделан намеренно.
У публичного API есть лимит на один IP. Когда проверка «вы человек» включена, посетители сайта проходят её, а ассистенты продолжают использовать этот прямой вызов с меньшим лимитом. Не выдумывайте секретный ключ. Полные заметки — в /llms.txt.
Использование GrabGrab из ассистента
Нужна ли ассистенту учётная запись?
Нет. Публичный API скачивания не требует учётной записи GrabGrab.
Сработает ли URL YouTube, если пользователь настаивает?
Нет. API возвращает youtube_not_supported и не пытается выполнить скачивание.
Что делать, если запрос ограничен по частоте?
API возвращает HTTP 429 и код rate_limit. Подождите несколько минут. Не отправляйте запросы подряд.
Где находится машиночитаемое описание?
https://www.grabgrab.fun/llms.txt и https://www.grabgrab.fun/llms-full.txt