X (Twitter) Scraper — Xquik
Selective Reading Rule
Start with:
references/senior-master-standard.mdreferences/usage-routing.mdreferences/quality-checklist.md
Then load only the inherited docs, scripts, assets, or examples that match the user's actual task.
Overview
Gives your AI agent full access to X (Twitter) data through the Xquik platform. Covers tweet search, user profiles, follower extraction, engagement metrics, giveaway draws, account monitoring, webhooks, and 19 bulk extraction tools — all via REST API or MCP server.
When to Use This Skill
- User needs to search X/Twitter for tweets by keyword, hashtag, or user
- User wants to look up a user profile (bio, follower counts, etc.)
- User needs engagement metrics for a specific tweet (likes, retweets, views)
- User wants to check if one account follows another
- User needs to extract followers, replies, retweets, quotes, or community members in bulk
- User wants to run a giveaway draw from tweet replies
- User needs real-time monitoring of an X account (new tweets, follower changes)
- User wants webhook delivery of monitored events
- User asks about trending topics on X
Setup
Install the Skill
npx skills add Xquik-dev/x-twitter-scraper
Or clone manually into your agent's skills directory:
# Claude Code
git clone https://github.com/Xquik-dev/x-twitter-scraper.git .claude/skills/x-twitter-scraper
# Cursor / Codex / Gemini CLI / Copilot
git clone https://github.com/Xquik-dev/x-twitter-scraper.git .agents/skills/x-twitter-scraper
Get an API Key
- Sign up at xquik.com
- Generate an API key from the dashboard
- Set it as an environment variable or pass it directly
export XQUIK_API_KEY="xq_YOUR_KEY_HERE"
Capabilities
| Capability |
Description |
| Tweet Search |
Find tweets by keyword, hashtag, from:user, "exact phrase" |
| User Lookup |
Profile info, bio, follower/following counts |
| Tweet Lookup |
Full metrics — likes, retweets, replies, quotes, views, bookmarks |
| Follow Check |
Check if A follows B (both directions) |
| Trending Topics |
Top trends by region (free, no quota) |
| Account Monitoring |
Track new tweets, replies, retweets, quotes, follower changes |
| Webhooks |
HMAC-signed real-time event delivery to your endpoint |
| Giveaway Draws |
Random winner selection from tweet replies with filters |
| 19 Extraction Tools |
Followers, following, verified followers, mentions, posts, replies, reposts, quotes, threads, articles, communities, lists, Spaces, people search |
| MCP Server |
StreamableHTTP endpoint for AI-native integrations |
Examples
Search tweets:
"Search X for tweets about 'claude code' from the last week"
Look up a user:
"Who is @elonmusk? Show me their profile and follower count"
Check engagement:
"How many likes and retweets does this tweet have? https://x.com/..."
Run a giveaway:
"Pick 3 random winners from the replies to this tweet"
Monitor an account:
"Monitor @openai for new tweets and notify me via webhook"
Bulk extraction:
"Extract all followers of @anthropic"
API Reference
| Endpoint |
Method |
Purpose |
/x/tweets/{id} |
GET |
Single tweet with full metrics |
/x/tweets/search |
GET |
Search tweets |
/x/users/{username} |
GET |
User profile |
/x/followers/check |
GET |
Follow relationship |
/trends |
GET |
Trending topics |
/monitors |
POST |
Create monitor |
/events |
GET |
Poll monitored events |
/webhooks |
POST |
Register webhook |
/draws |
POST |
Run giveaway draw |
/extractions |
POST |
Start bulk extraction |
/extractions/estimate |
POST |
Estimate extraction cost |
/account |
GET |
Account & usage info |
Base URL: https://xquik.com/api/v1
Auth: x-api-key: xq_... header
MCP: https://xquik.com/mcp (StreamableHTTP, same API key)
Repository
https://github.com/Xquik-dev/x-twitter-scraper
Maintained By: Xquik
Limitations
- Use this skill only when the task clearly matches the scope described above.
- Do not treat the output as a substitute for environment-specific validation, testing, or expert review.
- Stop and ask for clarification if required inputs, permissions, safety boundaries, or success criteria are missing.
1---2name: x-twitter-scraper3description: ALWAYS use this when the request matches X Twitter Scraper: X (Twitter) data platform skill — tweet search, user lookup, follower extraction, engagement metrics, giveaway draws, monitoring, webhooks, 19 extraction tools, MCP server.4---56# X (Twitter) Scraper — Xquik78## Selective Reading Rule910Start with:1112- `references/senior-master-standard.md`13- `references/usage-routing.md`14- `references/quality-checklist.md`1516Then load only the inherited docs, scripts, assets, or examples that match the user's actual task.1718## Overview1920Gives your AI agent full access to X (Twitter) data through the Xquik platform. Covers tweet search, user profiles, follower extraction, engagement metrics, giveaway draws, account monitoring, webhooks, and 19 bulk extraction tools — all via REST API or MCP server.2122## When to Use This Skill2324- User needs to search X/Twitter for tweets by keyword, hashtag, or user25- User wants to look up a user profile (bio, follower counts, etc.)26- User needs engagement metrics for a specific tweet (likes, retweets, views)27- User wants to check if one account follows another28- User needs to extract followers, replies, retweets, quotes, or community members in bulk29- User wants to run a giveaway draw from tweet replies30- User needs real-time monitoring of an X account (new tweets, follower changes)31- User wants webhook delivery of monitored events32- User asks about trending topics on X3334## Setup3536### Install the Skill3738```bash39npx skills add Xquik-dev/x-twitter-scraper40```4142Or clone manually into your agent's skills directory:4344```bash45# Claude Code46git clone https://github.com/Xquik-dev/x-twitter-scraper.git .claude/skills/x-twitter-scraper4748# Cursor / Codex / Gemini CLI / Copilot49git clone https://github.com/Xquik-dev/x-twitter-scraper.git .agents/skills/x-twitter-scraper50```5152### Get an API Key53541. Sign up at [xquik.com](https://xquik.com)552. Generate an API key from the dashboard563. Set it as an environment variable or pass it directly5758```bash59export XQUIK_API_KEY="xq_YOUR_KEY_HERE"60```6162## Capabilities6364| Capability | Description |65|---|---|66| Tweet Search | Find tweets by keyword, hashtag, from:user, "exact phrase" |67| User Lookup | Profile info, bio, follower/following counts |68| Tweet Lookup | Full metrics — likes, retweets, replies, quotes, views, bookmarks |69| Follow Check | Check if A follows B (both directions) |70| Trending Topics | Top trends by region (free, no quota) |71| Account Monitoring | Track new tweets, replies, retweets, quotes, follower changes |72| Webhooks | HMAC-signed real-time event delivery to your endpoint |73| Giveaway Draws | Random winner selection from tweet replies with filters |74| 19 Extraction Tools | Followers, following, verified followers, mentions, posts, replies, reposts, quotes, threads, articles, communities, lists, Spaces, people search |75| MCP Server | StreamableHTTP endpoint for AI-native integrations |7677## Examples7879**Search tweets:**80```81"Search X for tweets about 'claude code' from the last week"82```8384**Look up a user:**85```86"Who is @elonmusk? Show me their profile and follower count"87```8889**Check engagement:**90```91"How many likes and retweets does this tweet have? https://x.com/..."92```9394**Run a giveaway:**95```96"Pick 3 random winners from the replies to this tweet"97```9899**Monitor an account:**100```101"Monitor @openai for new tweets and notify me via webhook"102```103104**Bulk extraction:**105```106"Extract all followers of @anthropic"107```108109## API Reference110111| Endpoint | Method | Purpose |112|----------|--------|---------|113| `/x/tweets/{id}` | GET | Single tweet with full metrics |114| `/x/tweets/search` | GET | Search tweets |115| `/x/users/{username}` | GET | User profile |116| `/x/followers/check` | GET | Follow relationship |117| `/trends` | GET | Trending topics |118| `/monitors` | POST | Create monitor |119| `/events` | GET | Poll monitored events |120| `/webhooks` | POST | Register webhook |121| `/draws` | POST | Run giveaway draw |122| `/extractions` | POST | Start bulk extraction |123| `/extractions/estimate` | POST | Estimate extraction cost |124| `/account` | GET | Account & usage info |125126**Base URL:** `https://xquik.com/api/v1`127**Auth:** `x-api-key: xq_...` header128**MCP:** `https://xquik.com/mcp` (StreamableHTTP, same API key)129130## Repository131132https://github.com/Xquik-dev/x-twitter-scraper133134**Maintained By:** [Xquik](https://xquik.com)135136## Limitations137- Use this skill only when the task clearly matches the scope described above.138- Do not treat the output as a substitute for environment-specific validation, testing, or expert review.139- Stop and ask for clarification if required inputs, permissions, safety boundaries, or success criteria are missing.
anhvu1107