Частые вопросы

Бесплатный сервис, который читает публичные посты, треды и профили X и отдаёт их в Markdown, JSON, YAML, CSV или HTML. Он существует, чтобы агенты, боты и небольшие проекты могли читать X без ключа API.

Да. Без аккаунта, ключа, карты и триала. Всё держится на донатах, а расходы — это домен и один небольшой сервер.

Нет. Ключ генерировать негде, заголовок отправлять не надо. Лимиты применяются по IP-адресу и по эндпоинту.

На IP и на эндпоинт: 45 запросов в минуту на отдельные посты и профили, 15 в минуту на треды, таймлайны, ответы и списки подписчиков, 20 в минуту на медиа, 4 выгрузки истории и 6 bulk-запросов каждые пять минут и 10 поисков каждые пятнадцать минут. Текущее состояние приходит в заголовках x-ratelimit с каждым ответом. Нужно больше? Посмотрите тариф для компаний.

Нет и никогда не будет. Защищённые аккаунты вернут тот же 404, что и всем остальным, а личные сообщения недоступны вовсе. XCrap читает только публичные аккаунты: их посты, профили, ответы и списки подписчиков.

Нет. Если пост пропал из X, здесь его тоже нет. Пятидневный кэш может ненадолго ещё держать то, что удалили только что, и эта копия исчезает по истечении срока.

Используйте /v1/thread со ссылкой на любой пост в нём, включая первый. X сообщает только родителя поста, поэтому мы сшиваем таймлайн автора по conversation id и идём по треду вперёд.

Да. /v1/media перечисляет все вложенные файлы со ссылками на скачивание, во всех битрейтах, которые закодировал X. Файлы идут потоком напрямую и никогда не пишутся на наш диск.

JSON, Markdown, YAML, CSV и отдельная HTML-карточка. Добавьте ?format= к любому запросу или отправьте заголовок Accept.

Три способа. Добавить MCP-сервер в конфиг клиента, скачать файл скилла и вставить его в промпт или направить свой фреймворк на спецификацию OpenAPI.

Оценка того, во сколько токенов обойдётся ответ в Markdown; приходит с каждым таким ответом. Позволяет агенту решить, влезет ли тред в контекст, ещё до чтения тела.

Да: /v1/search принимает любой запрос, понятный поиску X, включая операторы (from:, "точная фраза", since: и другие), и возвращает самые новые или самые популярные посты либо только посты с фото или видео. У этого эндпоинта самый строгий лимит запросов.

В логах запросов лежат путь, метка времени, IP и заголовки — чтобы находить злоупотребления и разбирать сбои. Содержимое постов кэшируется пять дней и потом удаляется. Мы труба, а не архив.

Чтение публичных веб-страниц не является несанкционированным доступом — это подтвердили суды США в деле hiQ v. LinkedIn. Условия использования X это всё же нарушает, но это договорный вопрос между нами и X, а не уголовный. За то, что вы делаете с полученными данными, отвечаете вы.

Напишите на [email protected] с адреса, который можно связать с аккаунтом, и хэндл попадёт в блок-лист, который проверяется до выполнения любого запроса. Без споров и без формы.

Пользуйтесь им, если можете. Он стоит $200 в месяц на начальном тарифе и $42,000 на верхнем, а бесплатный тариф вообще не читает посты. XCrap существует для всех, кто ниже этой черты.

За каждым эндпоинтом стоят четыре источника, и ломаются они независимо. Когда отваливается наш собственный клиент, запросы проваливаются к следующему и продолжают отвечать, пока мы чиним.

Нет. XCrap — закрытый исходный код, и никакой сборки для самостоятельного запуска не существует. Если вам нужна гарантированная мощность для чего-то важного, тариф для компаний даёт выделенные мощности и повышенные лимиты: пишите на [email protected]. Бесплатный API остаётся бесплатным, пока пожертвования покрывают сервер.

Да. У бесплатного API нет ни лицензионного ключа, ни тарифов. Держитесь в пределах лимитов и помните: за соблюдение условий X и законов о защите данных там, где вы работаете, отвечаете вы. Если вашему продукту нужно больше мощности, тариф для компаний создан для этого.

Донатьте, если можете: серверы — единственный реальный расход. Сообщайте о поломках. Расскажите другим, кто делает агентов, что это существует.

Aura++ добавил XCrap в свой каталог, и его значок — ниже. Если вы ведёте каталог и хотите добавить проект, напишите на [email protected], и ваш значок встанет рядом с тем.