x-twitter-scraper

X (Twitter) data platform skill for AI coding agents. 111 REST API endpoints, 2 MCP tools, 23 extraction types, HMAC webhooks. Read tweets from $0.00015 per call (33x cheaper than the official X API). Pay-per-use via Machine Payments Protocol or Xquik API key.

X API / Twitter Scraper Skill for AI Coding Agents

License: MIT GitHub stars npm version npm downloads X Tweet Scraper on Apify x-twitter-scraper MCP server smithery badge

An AI agent skill that gives coding agents deep knowledge of the Xquik X (Twitter) real-time data platform. 111 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

XquikX API BasicX API Pro
Monthly cost$20$100$5,000
Cost per tweet read$0.00015~$0.01~$0.005
Cost per user lookup$0.00015~$0.01~$0.005
Write actions$0.0015LimitedLimited
Bulk extractionFrom $0.00015/resultNot availableNot available
Monitoring + webhooksFreeNot availableNot available
Giveaway draws$0.00015/entryNot availableNot available
MCP serverIncludedNot availableNot available

Per-Operation Costs (1 credit = $0.00015)

OperationCreditsCost
Read (tweet, search, timeline, bookmarks, etc.)1$0.00015
Read (user profile, verified followers, followers you know)1$0.00015
Read (favoriters)1$0.00015
Read (trends)3$0.00045
Follow check, article7$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)1/result$0.00015/result
Extraction (articles)5/result$0.00075/result
Draw1/entry$0.00015/entry
Monitors, webhooks, radar, compose, drafts0Free

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 111 endpoints.
  • MPP: 32 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

Claude Code
git clone https://github.com/Xquik-dev/x-twitter-scraper.git .claude/skills/x-twitter-scraper
Codex / Cursor / Gemini CLI / GitHub Copilot
git clone https://github.com/Xquik-dev/x-twitter-scraper.git .agents/skills/x-twitter-scraper
Windsurf
git clone https://github.com/Xquik-dev/x-twitter-scraper.git .windsurf/skills/x-twitter-scraper
Cline
git clone https://github.com/Xquik-dev/x-twitter-scraper.git .agents/skills/x-twitter-scraper
Roo Code
git clone https://github.com/Xquik-dev/x-twitter-scraper.git .roo/skills/x-twitter-scraper
Continue
git clone https://github.com/Xquik-dev/x-twitter-scraper.git .continue/skills/x-twitter-scraper
Goose
git clone https://github.com/Xquik-dev/x-twitter-scraper.git .goose/skills/x-twitter-scraper
OpenCode
git clone https://github.com/Xquik-dev/x-twitter-scraper.git .agents/skills/x-twitter-scraper

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
  • 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
  • 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 111 endpoints for AI agent integration
  • Pay-per-use (MPP): Anonymous access to 32 endpoints via on-chain payments, no account needed

Capabilities

AreaDetails
REST API111 endpoints across 10 categories with retry logic and pagination
MCP Server2 tools (explore + xquik). StreamableHTTP, configs for 10 platforms
Data Extraction23 bulk extraction tools (replies, retweets, quotes, favoriters, threads, articles, user likes, user media, communities, lists, Spaces, people search, tweet search, mentions, posts)
X LookupsTweet, user, article, search, user tweets, user likes, user media, favoriters, mutual followers, bookmarks, notifications, timeline, DM history
Write ActionsPost/delete tweets, like/unlike, retweet, follow/unfollow, DM, profile update, avatar/banner, media upload, community actions
Giveaway DrawsRandom winner selection from tweet replies with 11 filter options
Account MonitoringReal-time tracking of tweets, replies, quotes, retweets
WebhooksHMAC-SHA256 signature verification in Node.js, Python, Go
Media DownloadDownload images, videos, GIFs with permanent hosted URLs
Engagement AnalyticsLikes, retweets, replies, quotes, views, bookmarks per tweet
Trending TopicsRegional trends + 7 free news sources via Radar
Tweet CompositionAlgorithm-optimized tweet composer with scoring checklist (free)
Credits & BillingCheck balance, top up, manage subscription via API
Pay-Per-Use (MPP)32 endpoints with anonymous on-chain payments, no account needed
TypeScript TypesComplete 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

ResourceEndpoints
X LookupsTweet, 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
ExtractionsCreate (23 types), estimate, list, get results, export
MonitorsCreate, list, get, update, delete
EventsList (filtered, paginated), get single
WebhooksCreate, list, update, delete, test, deliveries
TrendsRegional trending topics
RadarTrending topics & news from 7 sources (free)
DrawsCreate with filters, list, get with winners, export
StylesAnalyze, save, list, get, delete, compare, performance
ComposeTweet composition (compose, refine, score)
DraftsCreate, list, get, delete
AccountGet account, update locale, set X identity, subscribe
CreditsGet balance, top up
API KeysCreate, list, revoke
X AccountsConnect, list, get, disconnect, re-authenticate
X WriteTweet, delete, like, unlike, retweet, follow, unfollow, DM, profile, avatar, banner, media upload, communities
SupportCreate ticket, list, get, update, reply

Official SDKs & Tools

Use the X Twitter Scraper API in your language of choice. All SDKs are auto-generated, kept in sync with the OpenAPI spec, and follow idiomatic conventions for each ecosystem.

RepoLanguageInstallStars
x-twitter-scraper-typescriptTypeScript / Node.jsnpm i x-twitter-scraperStars
x-twitter-scraper-pythonPythonpip install x-twitter-scraperStars
x-twitter-scraper-goGogo get github.com/Xquik-dev/x-twitter-scraper-goStars
x-twitter-scraper-rubyRubygem install x-twitter-scraperStars
x-twitter-scraper-javaJavaimplementation("com.x_twitter_scraper.api:x-twitter-scraper-java:0.3.0")Stars
x-twitter-scraper-kotlinKotlinimplementation("com.x_twitter_scraper.api:x-twitter-scraper-kotlin:0.3.0")Stars
x-twitter-scraper-csharpC# / .NETdotnet add package XTwitterScraperStars
x-twitter-scraper-phpPHPcomposer require xquik/x-twitter-scraperStars
x-twitter-scraper-cliCLIgo install github.com/Xquik-dev/x-twitter-scraper-cli/cmd/x-twitter-scraper@latestStars
terraform-provider-x-twitter-scraperTerraformBuild from source (latest release)Stars
tweetclawOpenClaw pluginopenclaw plugins install @xquik/tweetclawStars

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

Máy chủ liên quan

NotebookLM Web Importer

Nhập trang web và video YouTube vào NotebookLM chỉ với một cú nhấp. Được tin dùng bởi hơn 200.000 người dùng.

Cài đặt tiện ích Chrome