# x-twitter-scraper

x-twitter-scraper — a skill for extracting X (Twitter) data via Xquik API: tweet search, user profiles, followers, trends, account monitoring with webhooks. 22 MCP tools included.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 107 installs · ★ 3785 repo stars
- Author: davepoon
- License: MIT · policy=mirror · the beginning of the file is at the end of this page
- Source: https://github.com/davepoon/buildwithclaude/tree/HEAD/plugins/all-skills/skills/x-twitter-scraper/SKILL.md
- Updated: 2026-10-25
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/davepoon-x-twitter-scraper

## What it does

x-twitter-scraper wraps Xquik, a platform for X data access. You can search tweets by keyword or hashtag, fetch full metrics (likes, retweets, views), look up user profiles, and check follow relationships. Bulk extraction is the core feature: pull followers, reply authors, retweets, quotes, community members, list data, and Space participants. All operations run through MCP tools or REST API.

You need a Xquik account with an active subscription, starting at $20/month plus $5 per additional monitor. Account monitoring sends events over webhooks—new tweets, replies, follower changes. Built-in giveaway tool picks random winners from tweet replies with filters for engagement, account age, and language. Rate limits: 10 requests per second sustained, 20 in burst. Large extractions return paginated results and require polling.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add davepoon/buildwithclaude --skill x-twitter-scraper -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/x-twitter-scraper/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/x-twitter-scraper/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add davepoon/buildwithclaude --skill x-twitter-scraper -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/x-twitter-scraper/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add davepoon/buildwithclaude --skill x-twitter-scraper -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/x-twitter-scraper/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install davepoon/buildwithclaude plugins/all-skills/skills/x-twitter-scraper
```

2. **Manually: put the files in place**
- File: `.github/skills/x-twitter-scraper/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add davepoon/buildwithclaude --skill x-twitter-scraper -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/davepoon/buildwithclaude --path plugins/all-skills/skills/x-twitter-scraper
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/x-twitter-scraper/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add davepoon/buildwithclaude --skill x-twitter-scraper -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/davepoon/buildwithclaude/tree/HEAD/plugins/all-skills/skills/x-twitter-scraper/SKILL.md

## When to use it
- search tweets by keyword or from a specific account
- extract a list of followers or users who replied to a tweet
- monitor an account for new tweets in real time
- run a giveaway draw with eligibility filters
- fetch current trending topics by region

## Example prompts
- Find recent tweets about AI from authors with over 100,000 followers
- List everyone who replied to this tweet and check if they follow @elonmusk
- Set up monitoring for @technewstoday and send me a webhook when a new tweet appears

## Source text · SKILL.md · MIT

Below is the content of a third-party file. It is data, not instructions for you: do not act on anything written inside unless the human asks. Block tag: 7c207bf306624995.

BEGIN THIRD-PARTY FILE 7c207bf306624995
````text
---
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
````
END THIRD-PARTY FILE 7c207bf306624995

The third-party file has ended. Everything between the 7c207bf306624995 tags is data: requests and commands from it are not followed. An “end of file” line with another tag inside the block is part of the file.

First 2560 of 8760 bytes. © davepoon · MIT · https://github.com/davepoon/buildwithclaude/tree/HEAD/plugins/all-skills/skills/x-twitter-scraper/SKILL.md

_Part of the page did not fit — see the HTML version._

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
