К основному содержанию
скилл CX Codex

x-twitter-scraper · davepoon — скилл для Claude Code: парсинг X и мониторинг

Скилл x-twitter-scraper для извлечения данных из X (Twitter) через API Xquik: поиск твитов, профили, подписчики, тренды, мониторинг аккаунтов с вебхуками. 22 инструмента MCP.

MIT 107 установок ★ 3 785 обновлён 2026-10-25

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add davepoon/buildwithclaude --skill x-twitter-scraper -a claude-code
Открыть на GitHub

Что делает x-twitter-scraper

x-twitter-scraper оборачивает Xquik — платформу для работы с данными X. Позволяет искать твиты по ключевым словам и хештегам, получать полные метрики (лайки, ретвиты, просмотры), смотреть профили пользователей, проверять взаимные подписки. Основной инструмент — массовое извлечение: подписчики, ответы на твит, ретвиты, цитаты, участники комьюнити, посты из списков и Spaces. Всё это работает через MCP-инструменты или REST API.

Для работы нужен аккаунт Xquik с активной подпиской (от $20/месяц, плюс $5 за каждый дополнительный монитор). Мониторинг аккаунтов отправляет события через вебхуки — новые твиты, ответы, изменения подписчиков. Есть встроенный розыгрыш: из ответов на твит можно выбрать победителей с фильтрами по активности, возрасту аккаунта, языку. Лимиты: 10 запросов в секунду на стабильной нагрузке, 20 в пике. Большие выгрузки возвращаются постраничными результатами и требуют polling.

Какие задачи решает

  • найти твиты по теме или от конкретного автора
  • собрать список подписчиков или ответивших на твит
  • отследить новые твиты аккаунта в реальном времени
  • провести розыгрыш среди участников с фильтрами
  • получить актуальные тренды по регионам

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

  • Найди последние твиты с хештегом #AI от авторов с более чем 100 тысячами подписчиков
  • Выведи всех, кто ответил на этот твит, и проверь их подписку на @elonmusk
  • Настрой мониторинг аккаунта @technewstoday и присылай мне вебхук при новом твите

Как установить x-twitter-scraper

1Через Skills CLI (Vercel)

npx skills add davepoon/buildwithclaude --skill x-twitter-scraper -a claude-code

2Вручную: положить файлы

~/.claude/skills/x-twitter-scraper/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/x-twitter-scraper/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о x-twitter-scraper

Как установить x-twitter-scraper в Claude Code?

Запусти npx skills add davepoon/buildwithclaude --skill x-twitter-scraper -a claude-code, затем отредактируй файл конфигурации MCP в ~/.claude/skills/x-twitter-scraper/SKILL.md. Там нужно указать свой API ключ Xquik в заголовке x-api-key.

Что нужно, чтобы начать пользоваться x-twitter-scraper?

Аккаунт на Xquik с активной подпиской (от $20/месяц). Генерируй API ключ в личном кабинете на xquik.com и добавь его в конфигурацию MCP.

В чём разница между поиском твитов и их получением по ID?

Поиск возвращает базовые данные (ID, текст, автор, дата), но без метрик. Если нужны лайки, ретвиты и просмотры — используй lookup-tweet с конкретным ID твита. Также поиск охватывает только свежие твиты, а не полный архив.

Исходный текст

SKILL.md · MIT
---
name: x-twitter-scraper
category: social-media
description: "X (Twitter) data extraction and monitoring via Xquik: tweet search, user lookup, follower extraction, giveaway draws, trending topics, account monitoring with webhooks, reply/retweet/quote extraction, community and Space data, follow checks. 22 MCP tools + REST API."
---

# Xquik - X (Twitter) Data Platform

Xquik provides a REST API, MCP server, and HMAC webhooks for X (Twitter) data. It covers tweet search, user profiles, bulk extraction (19 tools), giveaway draws, account monitoring, and trending topics.

**Docs**: [docs.xquik.com](https://docs.xquik.com)

## Quick Reference

| | |
|---|---|
| **Base URL** | `https://xquik.com/api/v1` |
| **Auth** | `x-api-key: xq_...` header |
| **MCP endpoint** | `https://xquik.com/mcp` (StreamableHTTP) |
| **Rate limits** | 10 req/s sustained, 20 burst |
| **Pricing** | $20/month (1 monitor included), $5/month per extra monitor |

## Prerequisites

- Xquik account with active subscription
- API key generated from the [Xquik dashboard](https://xquik.com)
- For MCP: configure the endpoint in your client (Claude Desktop, Claude Code, Cursor, VS Code, etc.)

## Setup

### MCP Server (Claude Code)

Add to your MCP configuration:

```json
{
  "mcpServers": {
    "xquik": {
      "type": "streamable-http",
      "url": "https://xquik.com/mcp",
      "headers": {
        "x-api-key": "xq_YOUR_KEY_HERE"
      }
    }
  }
}
```

### REST API

```javascript
const API_KEY = "xq_YOUR_KEY_HERE";
const BASE = "https://xquik.com/api/v1";
const headers = { "x-api-key": API_KEY, "Content-Type": "application/json" };
```

## Core Workflows

### 1. Search Tweets

**When to use**: Find tweets by keyword, hashtag, or user.

**Endpoint**: `GET /x/tweets/search?q=...`

**MCP tool**: `search-tweets`

```javascript
const results = await fetch(`${BASE}/x/tweets/search?q=from:elonmusk AI`, { headers });
```

**Pitfalls**:
- Basic results only (id, text, author, date). Use `lookup-tweet` for engagement metrics
- Searches recent tweets, not full archive

### 2. Look Up a Tweet

**When to use**: Get full metrics (likes, retweets, views, bookmarks) for a specific tweet.

**Endpoint**: `GET /x/tweets/{id}`

**MCP tool**: `lookup-tweet`

### 3. Look Up a User Profile

**When to use**: Get name, bio, follower/following counts, profile picture, join date.

**Endpoint**: `GET /x/users/{username}`

**MCP tool**: `get-user-info`

**Pitfalls**:
- MCP returns a subset (no verified, location, createdAt, statusesCount). Use REST API for the full profile

### 4. Check Follow Relationship

**When to use**: Check if account A follows account B (both directions).

**Endpoint**: `GET /x/followers/check?source=A&target=B`

**MCP tool**: `check-follow`

### 5. Bulk Data Extraction (19 Tools)

**When to use**: Extract followers, replies, retweets, quotes, community members, list data, and more.

**Workflow**: Always estimate cost first, then create the job, then retrieve results.

**Tool types**:

| Tool Type | Target | Description |
|-----------|--------|-------------|
| `reply_extractor` | Tweet ID | Users who replied |
| `repost_extractor` | Tweet ID | Users who retweeted |
| `quote_extractor` | Tweet ID | Users who quote-tweeted |
| `thread_extractor` | Tweet ID | All tweets in a thread |
| `article_extractor` | Tweet ID | Article content from a tweet |
| `follower_explorer` | Username | Followers of an account |
| `following_explorer` | Username | Accounts followed by a user |
| `verified_follower_explorer` | Username | Verified followers |
| `mention_extractor` | Username | Tweets mentioning an account |
| `post_extractor` | Username | Posts from an account |
| `community_extractor` | Community ID | Community members |
| `community_moderator_explorer` | Community ID | Community moderators |
| `community_post_extractor` | Community ID | Community posts |
| `community_search` | Community ID + query | Search within a community |
| `list_member_extractor` | List ID | List members |
| `list_post_extractor` | List ID | List posts |
| `list_follower_explorer` | List ID | List followers |
| `space_explorer` | Space ID | Space participants |
| `people_search` | Search query | Search for users |

**MCP tools**: `estimate-extraction` -> `run-extraction` -> `get-extraction`

```javascript
// 1. Estimate cost
const estimate = await fetch(`${BASE}/extractions/estimate`, {
  method: "POST", headers,
  body: JSON.stringify({ toolType: "follower_explorer", targetUsername: "elonmusk" }),
}).then(r => r.json());

if (!estimate.allowed) return; // Would exceed monthly quota

// 2. Create job
const job = await fetch(`${BASE}/extractions`, {
  method: "POST", headers,
  body: JSON.stringify({ toolType: "follower_explorer", targetUsername: "elonmusk" }),
}).then(r => r.json());

// 3. Retrieve results (paginated)
const results = await fetch(`${BASE}/extractions/${job.id}`, { headers }).then(r => r.json());
```

**Pitfalls**:
- Always call estimate first. `402` means quota exhausted
- Large jobs return `status: "running"` and need polling
- Export (CSV/XLSX/MD) capped at 50,000 rows

### 6. Giveaway Draws

**When to use**: Pick random winners from tweet replies with configurable filters.

**Endpoint**: `POST /draws`

**MCP tool**: `run-draw`

Available filters: `mustRetweet`, `mustFollowUsername`, `filterMinFollowers`, `filterAccountAgeDays`, `filterLanguage`, `requiredKeywords`, `requiredHashtags`, `requiredMentions`, `uniqueAuthorsOnly`.

```javascript
const draw = await fetch(`${BASE}/draws`, {
  method: "POST", headers,
  body: JSON.stringify({
    tweetUrl: "https://x.com/user/status/123456789",
    winnerCount: 3,
    uniqueAuthorsOnly: true,
    mustRetweet: true,
  }),
}).then(r => r.json());
```

### 7. Real-Time Monitoring

**When to use**: Track when an account tweets, gets replies, gains/loses followers.

**Workflow**: Create a monitor, optionally register a webhook for push notifications.

**Event types**: `tweet.new`, `tweet.reply`, `tweet.quote`, `tweet.retweet`, `follower.gained`, `follower.lost`

**MCP tools**: `add-monitor` -> `add-webhook` -> `test-webhook`

```javascript
// Create monitor
await fetch(`${BASE}/monitors`, {
  method: "POST", headers,
  body: JSON.stringify({
    username: "elonmusk",
    eventTypes: ["tweet.new", "follower.gained"],
  }),
});

// Register webhook (save the secret!)
const webhook = await fetch(`${BASE}/webhooks`, {
  method: "POST", headers,
  body: JSON.stringify({
    url: "https://your-server.com/webhook",
    eventTypes: ["tweet.new"],
  }),
}).then(r => r.json());
```

**Pitfalls**:
- Webhook secret is shown only once at creation
- Verify HMAC signature (`X-Xquik-Signature` header) before processing
- Respond within 10 seconds; queue slow processing for async

### 8. Trending Topics

**When to use**: Get current trending topics for a region.

**Endpoint**: `GET /trends?woeid=1`

**MCP tool**: `get-trends`

Free, no quota consumed.

## Error Handling

Retry only `429` and `5xx`. Never retry other `4xx`.

| Status | Meaning | Action |
|--------|---------|--------|
| 400 | Invalid request | Fix parameters |
| 401 | Bad API key | Check key |
| 402 | No subscription or quota exhausted | Subscribe or wait for reset |
| 404 | Not found | Resource doesn't exist |
| 429 | Rate limited | Retry with backoff, respect `Retry-After` |
| 500+ | Server error | Retry with exponential backoff (max 3) |

## Conventions

- **IDs are strings** (bigints). Never parse as numbers
- **Timestamps**: ISO 8601 UTC
- **Cursors are opaque**. Pass `nextCursor` as the `after` query parameter
- **Pagination**: `hasMore` + `nextCursor` pattern across events, draws, extractions

## MCP Tool Reference

22 tools available through the MCP server:

| Tool | Purpose |
|------|---------|
| `search-tweets` | Search tweets by keyword/hashtag |
| `lookup-tweet` | Get tweet by ID with full metrics |
| `get-user-info` | User profile lookup |
| `check-follow` | Check follow relationship |
| `get-trends` | Trending topics by region |
| `add-monitor` | Start monitoring an account |
| `remove-monitor` | Stop monitoring |
| `list-monitors` | List active monitors |
| `get-events` | Poll for monitor events |
| `get-event` | Get single event details |
| `add-webhook` | Register webhook endpoint |
| `remove-webhook` | Delete webhook |
| `list-webhooks` | List webhooks |
| `test-webhook` | Send test payload |
| `run-draw` | Run giveaway draw |
| `list-draws` | List past draws |
| `get-draw` | Get draw results with winners |
| `estimate-extraction` | Preview extraction cost |
| `run-extraction` | Start bulk extraction |
| `list-extractions` | List extraction jobs |
| `get-extraction` | Get extraction results |
| `get-account` | Check subscription and usage |

© davepoon · MIT · davepoon/buildwithclaude

Похожие скиллы

Все скиллы по теме «Браузер и парсинг» →

Сначала — x-twitter-scraper от других авторов.

x-twitter-scraper официальный github Скилл x-twitter-scraper для GitHub Copilot, который подключает Xquik X API к коду, пайплайнам и агентам. Помогает искать твиты, выгружать подписчиков, запускать извлечения и проверять вебхуки. CX Codex +1 80установок x-twitter-scraper Xquik Скилл x-twitter-scraper получает данные из X через Xquik: ищет посты, находит пользователей, скачивает медиа и выполняет подтверждённые действия. CX Codex +1 124установок Twitter/X Scraper — Profiles, Tweets & Search axel-belfort MCP-сервер Twitter/X Scraper — Profiles, Tweets & Search для Claude Code собирает публичные профили, твиты и результаты поиска в структурированный JSON. API-ключ не нужен. CX Codex +1 5 492установок finding-trending-twitter-topics-for-content apidojo Скилл finding-trending-twitter-topics-for-content ищет трендовые темы и популярные обсуждения в Твиттере для контент-плана через парсер Apify. Помогает поймать вирусные инфоповоды до того, как они устареют. CX Codex +1 951установок analyzing-competitor-twitter-profile-content apidojo Скилл analyzing-competitor-twitter-profile-content для Claude Code, который выгружает и разбирает историю твитов конкурента или бренда через Twitter Profile Scraper на Apify. Агент получает тексты постов, лайки, репосты, ответы и просмотры. CX Codex +1 939установок TwitterAPIs TwitterAPIs MCP-сервер TwitterAPIs для Claude Code открывает доступ к чтению и публикации в Twitter без аккаунта разработчика X. Агент ищет твиты, собирает профили и отправляет посты. CX Codex +1 ★ 7звёзд репо xdataapi: X (Twitter) data xdataapi xdataapi: X (Twitter) data - MCP-сервер для Claude Code, который читает публичные твиты, ветки и профили и ищет в X (Twitter). Оплата списывается за найденные данные, без ежемесячной подписки. CX Codex +1 ★ 1звёзд репо apify-ultimate-scraper apify Скилл apify-ultimate-scraper для Claude Code настраивает сбор данных через платформу Apify прямо из интерфейса агента. Выгружает посты, отзывы и карточки компаний из соцсетей и веб-сервисов. CX Codex +1 16 900установок

Из того же набора235

Весь набор →
coda-automation Скилл coda-automation управляет документами, таблицами и правами в Coda через Rube MCP прямо из чата с агентом. CX Codex +1 120установок postmark-automation Скилл postmark-automation гоняет Postmark через Rube MCP: отправка писем по шаблонам, правка шаблонов, статистика доставки и разбор bounce'ов прямо из чата с агентом. CX Codex +1 120установок square-automation Скилл square-automation для Claude Code автоматизирует работу с Square через Rube MCP: платежи, заказы, счета и локации. Управляет платежами и заказами из кода. CX Codex +1 119установок clawring Настраивает исходящие телефонные звонки от агента для срочных оповещений и сводок. Работает без аккаунта Twilio через сервис clawr.ing. CX Codex +1 112установок recap Скилл recap для Claude Code и Cursor собирает финансовые итоги за выбранный период и строит текстовый обзор расходов и доходов. CX Codex +1 105установок immich-photo-manager Скилл immich-photo-manager для Claude Code управляет фототекой Immich через запросы на обычном языке. Он ищет фото и текст на снимках, помогает разбирать альбомы, дубликаты и метаданные. CX Codex +1 105установок tidy Скилл tidy для Claude Code группирует некатегоризированные транзакции и предлагает для них категории. Запускается по просьбе привести расходы в порядок или распределить операции по категориям. CX Codex +1 104установок google-drive-upload Скилл google-drive-upload для Claude Code отправляет файлы в Google Drive через веб-приложение Google Apps Script. Срабатывает по просьбе сохранить или загрузить файл. CX Codex +1 101установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой