X Twitter Scraper
Real-time X (Twitter) data platform with 2 MCP tools covering 120+ REST API endpoints. Search tweets, look up users, get timelines, extract followers/likes/retweets in bulk, monitor accounts, run giveaway draws, and perform write actions (tweet, like, retweet, follow, DM). OAuth 2.1 authentication with PKCE.
README
X API / Twitter Scraper Skill for AI Coding Agents
An AI agent skill that gives coding agents deep knowledge of the Xquik X (Twitter) real-time data platform. 120 REST API endpoints, 2 MCP tools, HMAC webhooks, 23 bulk extraction tools, and write actions.
The cheapest X data API on the market — reads from $0.00015/call (33x cheaper than the official X API).
Works with 40+ AI coding agents including Claude Code, OpenAI Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, VS Code, Cline, Roo Code, Goose, Amp, Augment, Continue, OpenHands, Trae, OpenCode, and more.
Pricing
Xquik is dramatically cheaper than every alternative for X/Twitter data access.
vs Official X API
| Xquik | X API Basic | X API Pro | |
|---|---|---|---|
| Monthly cost | $20 | $100 | $5,000 |
| Cost per tweet read | $0.00015 | ~$0.01 | ~$0.005 |
| Cost per user lookup | $0.0003 | ~$0.01 | ~$0.005 |
| Write actions | $0.0015 | Limited | Limited |
| Bulk extraction | From $0.00015/result | Not available | Not available |
| Monitoring + webhooks | Free | Not available | Not available |
| Giveaway draws | $0.00015/entry | Not available | Not available |
| MCP server | Included | Not available | Not available |
Per-Operation Costs (1 credit = $0.00015)
| Operation | Credits | Cost |
|---|---|---|
| Read (tweet, search, timeline, bookmarks, etc.) | 1 | $0.00015 |
| Read (user profile, verified followers, followers you know) | 2 | $0.0003 |
| Read (favoriters) | 1 | $0.00015 |
| Read (trends) | 3 | $0.00045 |
| Follow check, article | 7 | $0.00105 |
| Write (tweet, like, retweet, follow, DM, etc.) | 10 | $0.0015 |
| Extraction (tweets, replies, quotes, mentions, posts, likes, media, search, favoriters, retweeters, community members, people search, list members, list followers) | 1/result | $0.00015/result |
| Extraction (followers, following, verified followers) | 2/result | $0.0003/result |
| Extraction (articles) | 5/result | $0.00075/result |
| Draw | 1/entry | $0.00015/entry |
| Monitors, webhooks, radar, compose, drafts, integrations | 0 | Free |
Pay-Per-Use (No Subscription)
Two options for pay-per-use without a monthly subscription:
- Credits: Top up credits via
POST /credits/topup($10 minimum). 1 credit = $0.00015. Works with all 120 endpoints. - MPP: 16 X-API endpoints accept anonymous on-chain payments via Machine Payments Protocol. No account needed. SDK:
npm i mppx viem.
Installation
Install via the skills CLI (auto-detects your installed agents):
npx skills add Xquik-dev/x-twitter-scraper
Manual Installation
<details> <summary>Claude Code</summary>
git clone https://github.com/Xquik-dev/x-twitter-scraper.git .claude/skills/x-twitter-scraper
</details>
<details> <summary>Codex / Cursor / Gemini CLI / GitHub Copilot</summary>
git clone https://github.com/Xquik-dev/x-twitter-scraper.git .agents/skills/x-twitter-scraper
</details>
<details> <summary>Windsurf</summary>
git clone https://github.com/Xquik-dev/x-twitter-scraper.git .windsurf/skills/x-twitter-scraper
</details>
<details> <summary>Cline</summary>
git clone https://github.com/Xquik-dev/x-twitter-scraper.git .agents/skills/x-twitter-scraper
</details>
<details> <summary>Roo Code</summary>
git clone https://github.com/Xquik-dev/x-twitter-scraper.git .roo/skills/x-twitter-scraper
</details>
<details> <summary>Continue</summary>
git clone https://github.com/Xquik-dev/x-twitter-scraper.git .continue/skills/x-twitter-scraper
</details>
<details> <summary>Goose</summary>
git clone https://github.com/Xquik-dev/x-twitter-scraper.git .goose/skills/x-twitter-scraper
</details>
<details> <summary>OpenCode</summary>
git clone https://github.com/Xquik-dev/x-twitter-scraper.git .agents/skills/x-twitter-scraper
</details>
What This Skill Does
When installed, this skill gives your AI coding assistant deep knowledge of the Xquik platform:
- Tweet search & lookup: Search tweets by keyword, hashtag, advanced operators. Get full engagement metrics for any tweet
- User profile lookup: Fetch follower/following counts, bio, location, and profile data for any X account
- User activity feeds: Get user's recent tweets, liked tweets, and media tweets
- Tweet engagement data: Get who liked (favoriters) any tweet, mutual followers between accounts
- Follower & following extraction: Extract complete follower lists, verified followers, and following lists
- Reply, retweet & quote extraction: Bulk extract all replies, retweets, and quote tweets
- Media download: Download images, videos, and GIFs with permanent hosted URLs
- Thread & article extraction: Extract full tweet threads and linked article content
- Community & Space data: Extract community members, moderators, posts, and Space participants
- Bookmarks & notifications: Access bookmarks, bookmark folders, notifications, and home timeline
- DM history: Retrieve conversation history with any user
- Mutual follow checker: Check if two accounts follow each other
- X account monitoring: Track accounts for new tweets, replies, quotes, retweets, and follower changes
- Webhook delivery: Receive HMAC-signed event notifications at your HTTPS endpoint
- Trending topics: Get trending hashtags and topics by region
- Radar: Trending news from 7 sources (Google Trends, Hacker News, Polymarket, TrustMRR, Wikipedia, GitHub, Reddit). Free
- Giveaway draws: Run transparent draws from tweet replies with configurable filters
- Write actions: Post tweets, like, retweet, follow/unfollow, send DMs, update profile, upload media, manage communities
- Telegram integrations: Receive real-time monitor event notifications in Telegram
- Flow automations: Trigger-driven workflows with monitor events, schedules, search, and inbound webhooks
- Tweet composition: Algorithm-optimized tweet composer with scoring (free)
- Credits & billing: Check balance, top up credits, manage subscription
- Support tickets: Open and manage support tickets via API
- MCP server: 2 tools covering 120 endpoints for AI agent integration
- Pay-per-use (MPP): Anonymous access to 16 endpoints via on-chain payments, no account needed
Capabilities
| Area | Details |
|---|---|
| REST API | 120 endpoints across 12 categories with retry logic and pagination |
| MCP Server | 2 tools (explore + xquik). StreamableHTTP, configs for 10 platforms |
| Data Extraction | 23 bulk extraction tools (replies, retweets, quotes, favoriters, threads, articles, user likes, user media, communities, lists, Spaces, people search, tweet search, mentions, posts) |
| X Lookups | Tweet, user, article, search, user tweets, user likes, user media, favoriters, mutual followers, bookmarks, notifications, timeline, DM history |
| Write Actions | Post/delete tweets, like/unlike, retweet, follow/unfollow, DM, profile update, avatar/banner, media upload, community actions |
| Giveaway Draws | Random winner selection from tweet replies with 11 filter options |
| Account Monitoring | Real-time tracking of tweets, replies, quotes, retweets, follower changes |
| Webhooks | HMAC-SHA256 signature verification in Node.js, Python, Go |
| Telegram Integrations | Real-time monitor event notifications via Telegram bot |
| Media Download | Download images, videos, GIFs with permanent hosted URLs |
| Engagement Analytics | Likes, retweets, replies, quotes, views, bookmarks per tweet |
| Trending Topics | Regional trends + 7 free news sources via Radar |
| Tweet Composition | Algorithm-optimized tweet composer with scoring checklist (free) |
| Credits & Billing | Check balance, top up, manage subscription via API |
| Pay-Per-Use (MPP) | 16 endpoints with anonymous on-chain payments, no account needed |
| TypeScript Types | Complete type definitions for all API objects |
Supported Agents
Claude Code, OpenAI Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, VS Code Copilot, Cline, Roo Code, Goose, Amp, Augment, Continue, OpenHands, Trae, OpenCode, and any agent that supports the skills.sh protocol.
API Coverage
| Resource | Endpoints |
|---|---|
| X Lookups | Tweet, article, search, user profile, user tweets, user likes, user media, favoriters, followers you know, follow check, download media, bookmarks, bookmark folders, notifications, timeline, DM history |
| Extractions | Create (23 types), estimate, list, get results, export |
| Monitors | Create, list, get, update, delete |
| Events | List (filtered, paginated), get single |
| Webhooks | Create, list, update, delete, test, deliveries |
| Trends | Regional trending topics |
| Radar | Trending topics & news from 7 sources (free) |
| Draws | Create with filters, list, get with winners, export |
| Styles | Analyze, save, list, get, delete, compare, performance |
| Compose | Tweet composition (compose, refine, score) |
| Drafts | Create, list, get, delete |
| Account | Get account, update locale, set X identity, subscribe |
| Credits | Get balance, top up |
| API Keys | Create, list, revoke |
| X Accounts | Connect, list, get, disconnect, re-authenticate |
| X Write | Tweet, delete, like, unlike, retweet, follow, unfollow, DM, profile, avatar, banner, media upload, communities |
| Integrations | Create (Telegram), list, get, update, delete, test, deliveries |
| Automations | Create, list, get, update, delete, add/update/delete steps, positions, test, inbound webhook |
| Support | Create ticket, list, get, update, reply |
Skill Structure
x-twitter-scraper/
├── skills/
│ └── x-twitter-scraper/
│ ├── SKILL.md # Main skill (auth, pricing, endpoints, patterns)
│ ├── metadata.json # Version and references
│ └── references/
│ ├── api-endpoints.md # All REST API endpoints
│ ├── mcp-tools.md # MCP tool selection rules and workflow patterns
│ ├── mcp-setup.md # MCP configs for 10 platforms (v2 + v1)
│ ├── webhooks.md # Webhook setup & verification
│ ├── extractions.md # 23 extraction tool types
│ ├── types.md # TypeScript type definitions
│ └── python-examples.md # Python code examples
├── server.json # MCP Registry metadata
├── glama.json # Glama.ai directory metadata
├── logo.png # Marketplace logo
├── LICENSE # MIT
└── README.md # This file
Links
License
MIT
推荐服务器
Baidu Map
百度地图核心API现已全面兼容MCP协议,是国内首家兼容MCP协议的地图服务商。
Playwright MCP Server
一个模型上下文协议服务器,它使大型语言模型能够通过结构化的可访问性快照与网页进行交互,而无需视觉模型或屏幕截图。
Magic Component Platform (MCP)
一个由人工智能驱动的工具,可以从自然语言描述生成现代化的用户界面组件,并与流行的集成开发环境(IDE)集成,从而简化用户界面开发流程。
Audiense Insights MCP Server
通过模型上下文协议启用与 Audiense Insights 账户的交互,从而促进营销洞察和受众数据的提取和分析,包括人口统计信息、行为和影响者互动。
VeyraX
一个单一的 MCP 工具,连接你所有喜爱的工具:Gmail、日历以及其他 40 多个工具。
graphlit-mcp-server
模型上下文协议 (MCP) 服务器实现了 MCP 客户端与 Graphlit 服务之间的集成。 除了网络爬取之外,还可以将任何内容(从 Slack 到 Gmail 再到播客订阅源)导入到 Graphlit 项目中,然后从 MCP 客户端检索相关内容。
Kagi MCP Server
一个 MCP 服务器,集成了 Kagi 搜索功能和 Claude AI,使 Claude 能够在回答需要最新信息的问题时执行实时网络搜索。
e2b-mcp-server
使用 MCP 通过 e2b 运行代码。
Neon MCP Server
用于与 Neon 管理 API 和数据库交互的 MCP 服务器
Exa MCP Server
模型上下文协议(MCP)服务器允许像 Claude 这样的 AI 助手使用 Exa AI 搜索 API 进行网络搜索。这种设置允许 AI 模型以安全和受控的方式获取实时的网络信息。