Клиент для Node

01

Две строки до поста

Ключ передавать не нужно, настраивать клиент — тоже. Создали и вызвали.

Копировать

import { Xcrap } from '@xcrapcc/sdk';

const xcrap = new Xcrap();

const tweet = await xcrap.tweet('https://x.com/jack/status/20');
console.log(tweet.text);               // just setting up my twttr
console.log(tweet.metrics.likes);      // 308067

02

Markdown вместе с ценой в токенах

Каждый метод чтения принимает флаг markdown. Ответ приходит строкой, готовой для промпта, а клиент запоминает, во сколько токенов эта строка, скорее всего, обойдётся, — чтобы сверить бюджет до того, как его потратить.

Копировать

// Markdown, ready to drop into a prompt.
const md = await xcrap.tweet('https://x.com/jack/status/20', { markdown: true });

// How many tokens that will cost, before you spend them.
console.log(xcrap.lastMeta.markdownTokens);

03

Треды и ленты

Тред возвращается развёрнутым и по порядку, начиная с первого поста, а не с последнего. Лента листается по курсорам, так что хранить их не нужно.

Копировать

const thread = await xcrap.thread(
  'https://x.com/naval/status/1002103360646823936',
);

console.log(thread.count);                      // 31
for (const post of thread.tweets) console.log(post.text);

04

Поиск с операторами X

Передайте запрос так, как ввели бы его в X, вместе с операторами. Вернётся страница с курсором следующей. У поиска самый жёсткий лимит среди всех методов, поэтому один точный запрос лучше пяти общих.

Копировать

const page = await xcrap.search('from:nasa mars', {
  feed: 'latest',          // or 'top', 'photos', 'videos'
  since: '2026-01-01',
});

for (const post of page.tweets) console.log(post.author.screen_name, post.text);

// The next page, when there is one.
if (page.next_cursor) await xcrap.search('from:nasa mars', { cursor: page.next_cursor });

05

Ошибки — это типы, а не коды

Каждый сбой — класс, который ловится по имени. 404 — удалённый или закрытый пост, 429 несёт число секунд до сброса окна, а сетевой сбой отличим от отказа.

Копировать

import { Xcrap, XcrapNotFound, XcrapRateLimited } from '@xcrapcc/sdk';

try {
  await xcrap.tweet('https://x.com/jack/status/1');
} catch (error) {
  if (error instanceof XcrapNotFound) return null;
  if (error instanceof XcrapRateLimited) {
    // The client already knows when the window resets.
    await sleep(error.retryAfter * 1000);
  }
  throw error;
}

tweet(url, opts?)

Один пост целиком: текст, автор, метрики, медиа, опрос и цитируемый пост.

thread(url, opts?)

Весь тред от любого поста в нём, развёрнутый в порядке публикации.

search(query, opts?)

Посты по запросу — новые, популярные, с фото или видео — в необязательном диапазоне дат.

replies(url, opts?)

Страница прямых ответов на пост: сначала самые популярные или самые новые.

user(handle, opts?)

Профиль: описание, счётчики, дата регистрации, верификация, город и сайт.

userTweets(handle, opts?)

Одна страница постов аккаунта и курсор на следующую.

userHistory(handle, opts?)

До тысячи постов аккаунта за один вызов, от новых к старым, в необязательном диапазоне дат.

followers(handle, opts?)

Страница аккаунтов, которые подписаны на аккаунт.

following(handle, opts?)

Страница аккаунтов, на которые подписан аккаунт.

trends(opts?)

Что в трендах, с числом постов там, где X его отдаёт.

media(url, opts?)

Все вложения во всех битрейтах, которые закодировал X, прямыми ссылками.

downloadMedia(url, opts?)

Отдаёт один из этих файлов байтами, а не ссылкой.

bulk(urls, opts?)

До пятидесяти постов за один запрос. Битая ссылка роняет только свою запись.

Все параметры — в справочнике API Есть ещё клиент для Python.