Agent skill

X Twitter Scraper

by davepoon in davepoon/buildwithclaude

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…

MITAuto-check passedBackend & APIs

Install X Twitter Scraper

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

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install davepoon/buildwithclaude x-twitter-scraper --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/davepoon/buildwithclaude.git skills-src && mkdir -p .claude/skills && cp -r skills-src/plugins/all-skills/skills/x-twitter-scraper .claude/skills/x-twitter-scraper && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
x-twitter-scraper
GitHub stars
3.6k
Token cost
~2.2k tokens
SKILL.md length
732 words
Files
1
Skills in repo
246
Repo updated
First seen
Licence
MIT

At a glance

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…

  • Works in 8 steps: Search Tweets → Look Up a Tweet → Look Up a User Profile → …
  • Tasks that involve Social media posts
  • SKILL.md covers Quick Reference, Prerequisites, Setup and Core Workflows, plus 3 more sections
  • Reaches xquik.com and x.com; needs API_KEY

What it does

X Twitter Scraper is an agent skill from davepoon/buildwithclaude. 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.

Its SKILL.md is about 2.2k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Backend & APIs, covering Social media posts, MCP servers and Web scraping. It works with X (Twitter) and Model Context Protocol. The repository describes itself as: A single hub to find Claude Skills, Agents, Commands, Hooks, Plugins, and Marketplace collections to extend Claude Code, Claude Desktop, Agent SDK and OpenClaw. The licence is MIT.

When your agent uses it

  • Tasks that involve Social media posts
  • Tasks that involve MCP servers
  • Tasks that involve Web scraping

Example prompts

  • “/x-twitter-scraper”

Requirements

  • A credential in API_KEY

Workflow steps

8 steps, taken from the step headings in SKILL.md.

  1. Search Tweets
  2. Look Up a Tweet
  3. Look Up a User Profile
  4. Check Follow Relationship
  5. Bulk Data Extraction (19 Tools)
  6. Giveaway Draws
  7. Real-Time Monitoring
  8. Trending Topics

What it can do on your machine

Read from SKILL.md and the folder at commit 616deb5. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md (its code samples are javascript and json).

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • xquik.com
    • x.com

    Also links to:

    • docs.xquik.com

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names these keys or tokens, usually read from environment variables:

    • API_KEY

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

X Twitter Scraper loads about 2.2k tokens when it runs. Until then it costs about 71 tokens; SKILL.md has 732 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~71
When it runs · the whole SKILL.md, loaded when a task matches
~2.2k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from davepoon/buildwithclaude at commit 616deb5, republished under its MIT licence (© davepoon). 732 words, ~2,190 tokens.

Download SKILL.mdSave it as .claude/skills/x-twitter-scraper/SKILL.md (or your agent's skills folder).
name
x-twitter-scraper
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.
category
social-media

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

Quick Reference

Base URLhttps://xquik.com/api/v1
Authx-api-key: xq_... header
MCP endpointhttps://xquik.com/mcp (StreamableHTTP)
Rate limits10 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
  • 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 TypeTargetDescription
reply_extractorTweet IDUsers who replied
repost_extractorTweet IDUsers who retweeted
quote_extractorTweet IDUsers who quote-tweeted
thread_extractorTweet IDAll tweets in a thread
article_extractorTweet IDArticle content from a tweet
follower_explorerUsernameFollowers of an account
following_explorerUsernameAccounts followed by a user
verified_follower_explorerUsernameVerified followers
mention_extractorUsernameTweets mentioning an account
post_extractorUsernamePosts from an account
community_extractorCommunity IDCommunity members
community_moderator_explorerCommunity IDCommunity moderators
community_post_extractorCommunity IDCommunity posts
community_searchCommunity ID + querySearch within a community
list_member_extractorList IDList members
list_post_extractorList IDList posts
list_follower_explorerList IDList followers
space_explorerSpace IDSpace participants
people_searchSearch querySearch 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());
Show full SKILL.md (286 more words)Show less
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

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.

StatusMeaningAction
400Invalid requestFix parameters
401Bad API keyCheck key
402No subscription or quota exhaustedSubscribe or wait for reset
404Not foundResource doesn't exist
429Rate limitedRetry with backoff, respect Retry-After
500+Server errorRetry 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:

ToolPurpose
search-tweetsSearch tweets by keyword/hashtag
lookup-tweetGet tweet by ID with full metrics
get-user-infoUser profile lookup
check-followCheck follow relationship
get-trendsTrending topics by region
add-monitorStart monitoring an account
remove-monitorStop monitoring
list-monitorsList active monitors
get-eventsPoll for monitor events
get-eventGet single event details
add-webhookRegister webhook endpoint
remove-webhookDelete webhook
list-webhooksList webhooks
test-webhookSend test payload
run-drawRun giveaway draw
list-drawsList past draws
get-drawGet draw results with winners
estimate-extractionPreview extraction cost
run-extractionStart bulk extraction
list-extractionsList extraction jobs
get-extractionGet extraction results
get-accountCheck subscription and usage

© davepoon, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in plugins/all-skills/skills/x-twitter-scraper of davepoon/buildwithclaude.

Open the folder on GitHubat commit 616deb5

Compare with similar skills

X Twitter Scraper next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

X Twitter Scraper compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
X Twitter Scraper this skilldavepoon/buildwithclaude3.6k—~2.2kAutomated safety check: PassMIT
X Twitter Scrapergithub/awesome-copilot40k—~2.2kAutomated safety check: PassMIT
X Twitter Scraperdavila7/claude-code-templates32k—~1.8kAutomated safety check: PassMIT
X Twitter ScraperXquik-dev/x-twitter-scraper2101 repos~2.6kAutomated safety check: PassMIT
X Twitter Scrapersickn33/agentic-awesome-skills47k1 repos~2.1kAutomated safety check: PassMIT
X Twitter Scraperaiskillstore/marketplace430—~2.6kAutomated safety check: PassMIT

Similar skills

  • X Twitter Scraper

    github/awesome-copilot

    Official

    Build GitHub Copilot workflows with Xquik X API SDKs, REST endpoints, hosted Apify Actor runs, MCP tools, TweetClaw OpenClaw plugin installs, signed webhooks, tweet search, user lookup, follower…

    40k GitHub stars~2.2k tokensUpdated today
    Backend & APIsAuto-check passed
  • X Twitter Scraper

    davila7/claude-code-templates

    X API & Twitter scraper skill for AI coding agents. An agent skill from davila7/claude-code-templates.

    32k GitHub stars~1.8k tokensUpdated today
    Backend & APIsAuto-check passed
  • X Twitter Scraper

    Xquik-dev/x-twitter-scraper

    Use Xquik to fetch X (Twitter) data or act through a connected account: search, profiles, followers, replies, threads, timelines, media downloads, bulk exports, trends, monitors, signed webhooks…

    210 GitHub starsUsed in 1 repo~2.6k tokens
    Backend & APIsAuto-check passed
  • X Twitter Scraper

    sickn33/agentic-awesome-skills

    Use Xquik for X data workflows: tweet search, user lookup, follower export, media downloads, monitors, webhooks, REST API, MCP, SDK setup, and approval-gated account actions.

    47k GitHub starsUsed in 1 repo~2.1k tokens
    Backend & APIsAuto-check passed
  • X Twitter Scraper

    aiskillstore/marketplace

    A skill your agent uses when the user needs X (Twitter) data or confirmation-gated X actions through Xquik: tweet search, user lookup, follower extraction, media download, monitoring, webhooks, MCP…

    430 GitHub stars~2.6k tokensUpdated today
    Backend & APIsAuto-check passed
  • X Twitter Scraper

    LeoYeAI/openclaw-master-skills

    X API & Twitter automation skill. An agent skill from LeoYeAI/openclaw-master-skills.

    2.2k GitHub stars~7.1k tokensUpdated 2 mo ago
    Backend & APIsAuto-check passed

More from davepoon/buildwithclaude

All 246 skills in this repo
  • iOS Hig Design Guide

    davepoon/buildwithclaude

    Build, update, and apply iOS design specifications using Apple Human Interface Guidelines (HIG) source data.

    3.6k GitHub stars~735 tokensUpdated today
    Auto-check passed
  • Video Downloader

    davepoon/buildwithclaude

    Download YouTube videos with customizable quality and format options.

    3.6k GitHub starsUsed in 1 repo~871 tokens
    Auto-check passed
  • Qwen Vision

    davepoon/buildwithclaude

    A skill your agent uses when the user asks to "analyze video", "watch this video", "what happens in this video", "describe this clip", "review this footage", "classify these videos", "compare…

    3.6k GitHub stars~1.2k tokensUpdated today
    Auto-check passed
  • Atlas Cloud Media

    davepoon/buildwithclaude

    Discover Atlas Cloud image and video models, inspect their live schemas, and submit one confirmed media generation request with bounded GET polling.

    3.6k GitHub stars~852 tokensUpdated today
    Auto-check passed
  • Browser Extension Launch

    davepoon/buildwithclaude

    面向没有编程经验的用户,把想法做成可试用的浏览器插件,并完成检查、商店材料、审核提交和上线验证;也用于继续已有插件、排错和发布新版。用户说“帮我做个插件”“把插件上架”“继续我的插件”时使用。普通网站开发、仅查询插件知识不触发。

    3.6k GitHub stars~1.5k tokensUpdated today
    Auto-check passed
  • Slack Gif Creator

    davepoon/buildwithclaude

    Toolkit for creating animated GIFs optimized for Slack, with validators for size constraints and composable animation primitives.

    3.6k GitHub starsUsed in 12 repos~4.3k tokens
    Auto-check passed

Categories

Questions about X Twitter Scraper

What does X Twitter Scraper do?

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…. X Twitter Scraper is an agent skill from davepoon/buildwithclaude. 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.

When should I use X Twitter Scraper?

X Twitter Scraper fits situations like: tasks that involve Social media posts; tasks that involve MCP servers; tasks that involve Web scraping.

How do I install X Twitter Scraper in Claude Code?

Run `npx skills add davepoon/buildwithclaude --skill x-twitter-scraper -a claude-code`. Or copy the skill folder (plugins/all-skills/skills/x-twitter-scraper in davepoon/buildwithclaude) into .claude/skills/x-twitter-scraper in your project. Claude Code loads it when a task matches its description.

How do I install X Twitter Scraper in Codex?

Run `npx skills add davepoon/buildwithclaude --skill x-twitter-scraper -a codex`. Or copy the skill folder (plugins/all-skills/skills/x-twitter-scraper in davepoon/buildwithclaude) into .agents/skills/x-twitter-scraper in your project. Codex loads it when a task matches its description.

Can I use X Twitter Scraper in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add davepoon/buildwithclaude --skill x-twitter-scraper -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/x-twitter-scraper, .gemini/skills/x-twitter-scraper, .github/skills/x-twitter-scraper and .opencode/skills/x-twitter-scraper in your project.

What does X Twitter Scraper need to run?

Going by SKILL.md and its folder, X Twitter Scraper needs credentials named API_KEY. Our summary lists: A credential in API_KEY.

Does X Twitter Scraper access the network?

SKILL.md names 3 domains. In commands or code: xquik.com and x.com; the agent is likely to contact these when it follows the instructions. As links in the text: docs.xquik.com. This is read from the text; nothing was executed.

Is X Twitter Scraper safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does X Twitter Scraper use?

X Twitter Scraper is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does X Twitter Scraper use?

About 2.2k tokens (SKILL.md is roughly 8.8k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to X Twitter Scraper?

Skills that share tags, products or a category with X Twitter Scraper: X Twitter Scraper (github/awesome-copilot, 40k stars), X Twitter Scraper (davila7/claude-code-templates, 32k stars), X Twitter Scraper (Xquik-dev/x-twitter-scraper, 210 stars) and X Twitter Scraper (sickn33/agentic-awesome-skills, 47k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains X Twitter Scraper?

davepoon (a GitHub user) maintains it in davepoon/buildwithclaude, which has 3,605 GitHub stars. The repository holds 246 skills in this directory. The repository was last updated on October 9, 2026.

Source: davepoon/buildwithclaude on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.