X Twitter Scraper MCP Server

X Twitter Scraper API For Tweets, Followers, MCP

Xquik is an independent third-party service. Not affiliated with X Corp. "Twitter" and "X" are trademarks of X Corp.

Xquik is a production Twitter/X scraper API and X API alternative for teams that need structured X data at scale: tweet search, profiles, followers, following, engagement, media, lists, communities, trends, monitors, webhooks, exports, MCP tools, SDKs, and confirmation-gated X actions.

This repository packages Xquik as an AI agent skill for Claude Code, OpenAI Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, and other skills-compatible agents. It helps agents choose the right REST endpoint, MCP tool, SDK, webhook, extraction, export, or approval-gated workflow without guessing.

The npm package x-developer is this agent skill and plugin bundle. The separate x-twitter-scraper package is the typed TypeScript SDK.

Includes 126 REST API operations, HMAC webhooks, 23 extraction tools, SDK pointers, and confirmation-gated writes.

MCP v2.5.3 exposes 118 MCP operations through 2 tools. Add https://xquik.com/mcp, then follow the current client compatibility path. OAuth-capable clients complete OAuth 2.1; API-key fallback is client-specific; ChatGPT custom apps require OAuth. Eight credential or session-bound REST operations remain outside MCP: 3 account API-key operations, saved-payment top-up, account top-up redirect, and 3 guest-wallet credential operations.

Codex OAuth compatibility: Affected Codex releases discard the RFC 9207 iss callback value even though Xquik returns it. If Codex reports Authorization server response missing required issuer: expected https://xquik.com, use XQUIK_API_KEY through the Codex bearer_token_env_var setting. Follow the Codex OAuth troubleshooting guide and track openai/codex#31573.

Why Teams Use Xquik

• Replace fragmented Twitter scraper tools with one X data API for reads, exports, monitors, webhooks, SDKs, MCP, and gated writes.
• Ship X data integrations faster with endpoint routing for tweet search, user lookup, timelines, followers, replies, quotes, retweeters, favoriters, media, lists, communities, articles, trends, and Spaces.
• Build production apps, not just dataset runs with REST APIs, typed SDKs, OpenAPI, MCP tools, cursor pagination, webhook delivery, and exports.
• Control large jobs before they run with usage estimates for extractions, draws, monitors, webhooks, and other metered workflows.
• Keep agents safe around X content with OAuth-first MCP, scoped API-key access, read-only defaults, untrusted-content delimiters, and explicit approval for private reads, writes, persistent resources, and bulk jobs.
• Support enterprise-scale X data pipelines with high-throughput read limits, bulk extraction jobs, exports, event replay, and webhook automation.
• Win high-intent search traffic for Twitter scraper API, X scraper, X API alternative, tweet search API, Twitter follower export, social listening API, X monitoring, and X automation.

What You Can Scrape From X Twitter

Start From Any X Input

Use profile URLs, @handles, user IDs, tweet URLs, tweet IDs, search queries, hashtags, list IDs, community IDs, Space IDs, article tweet IDs, webhook destinations, or bulk target lists. Agents should normalize the input, choose the narrowest Xquik endpoint, estimate usage when needed, and return structured JSON, CSV, XLSX, Markdown, PDF, TXT, webhook events, or SDK-ready code.

Twitter Scraper API Use Cases

Built For Agents And Apps

Usage Control, Rate Limits, And High-Volume Workflows

Xquik is built for production X data jobs where teams need bounded usage, large result sets, and integration paths beyond a single dataset run.

• Higher read throughput for supported workflows: Xquik docs list read limits at 60 requests per second per account. Official X API rate-limit tables use per-15-minute windows for many endpoints, including recent search at 450 requests per app and 300 requests per user per 15 minutes.
• Use POST /extractions/estimate before large exports so agents can show expected usage before creating work.
• Use cursor pagination and batch endpoints for high-throughput read workflows.
• Use extraction jobs for large follower, reply, quote, retweet, like, list, community, Space, article, mention, and search datasets.
• Use exports when teams need CSV, JSON, Markdown, PDF, TXT, or XLSX handoff.
• Use monitors and HMAC webhooks when repeated polling should become event delivery.
• Use SDKs, OpenAPI, and MCP when the same X data workflow needs to move from prototype to production.

Production Workflow Coverage

Use Xquik when an X data task must continue into an app, agent, dataset, webhook, export, or confirmed connected-account action.

Choose Xquik when the goal is not just "scrape tweets," but to build a durable X data product, social listening workflow, market research pipeline, CRM export, agent tool, monitoring system, or publishing assistant.

Agent Safety And Account Boundary

This skill can read credit balance and request usage estimates. Plan and credit changes stay in the Xquik dashboard.

• Agents use only XQUIK_API_KEY. They never need X passwords, 2FA codes, cookies, or session exports.
• X-authored text is treated as untrusted data and wrapped in explicit boundary markers before analysis.
• Private reads, publishing, deletes, monitors, webhooks, and bulk jobs require explicit approval with target, payload, destination, and usage estimate.
• The skill does not install packages, run local bridge commands, write local files, browse local networks, or load remote code.

Installation

Install via the skills CLI (auto-detects your installed agents):

npx skills@1.5.3 add Xquik-dev/x-twitter-scraper

This installs the primary x-twitter-scraper skill, including SKILL.md and every file in references/.

Manual Installation

Use manual installation only when the skills CLI is unavailable. Copy the primary skill directory, not the repository root.

target_dir=".agents/skills/x-twitter-scraper"
tmp_dir="$(mktemp -d)"

git clone --depth 1 https://github.com/Xquik-dev/x-twitter-scraper.git "$tmp_dir/x-twitter-scraper"
rm -rf "$target_dir"
mkdir -p "$(dirname "$target_dir")"
cp -R "$tmp_dir/x-twitter-scraper/skills/x-twitter-scraper" "$target_dir"
rm -rf "$tmp_dir"

Target directories:

• Codex / Cursor / Gemini CLI / GitHub Copilot / Cline / OpenCode: .agents/skills/x-twitter-scraper
• Claude Code: .claude/skills/x-twitter-scraper
• Windsurf: .windsurf/skills/x-twitter-scraper
• Roo Code: .roo/skills/x-twitter-scraper
• Continue: .continue/skills/x-twitter-scraper
• Goose: .goose/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 after explicit approval
• DM history: Retrieve conversation history with explicit approval
• Mutual follow checker: Check if two accounts follow each other
• X account monitoring: Track accounts for new tweets, replies, quotes, retweets with explicit approval
• Webhook delivery: Receive HMAC-signed event notifications at your HTTPS endpoint
• Trending topics: Get trending hashtags and topics by region
• Radar: Trending news from supported trend and news sources
• Giveaway draws: Run transparent draws from tweet replies with configurable filters
• Write actions: Post tweets, like, retweet, follow/unfollow, remove followers, send DMs, update profile, upload media, manage communities after explicit approval
• Tweet composition: Algorithm-optimized tweet composer with scoring
• Usage guardrails: Check balance and estimate usage; dashboard handles plan and credit changes
• Support tickets: Open and manage support tickets via API
• MCP server: MCP v2.5.3 exposes 118 operations through 2 tools with OAuth 2.1 discovery

Capabilities

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

Xquik 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.

Skill Structure

x-twitter-scraper/
├── skills/
│   └── x-twitter-scraper/
│       ├── SKILL.md                      # Main skill (auth, usage guardrails, endpoints, patterns)
│       ├── metadata.json                 # Version and references
│       ├── skill-card.md                 # Trust and release review card
│       ├── skillspector-report.md        # Latest static SkillSpector evidence
│       └── references/
│           ├── api-endpoints.md          # REST API routing index
│           ├── api-endpoints-*.md        # Split endpoint sections for targeted agent loading
│           ├── mcp-tools.md              # MCP tool selection rules and workflow patterns
│           ├── mcp-setup.md              # Current MCP client setup and compatibility
│           ├── webhooks.md               # Webhook setup & verification
│           ├── extractions.md            # 23 extraction tool types
│           ├── types.md                  # TypeScript type routing index
│           ├── types-*.md                # Split schema sections for targeted agent loading
│           └── python-examples.md        # Python code examples
├── task-guides/                          # Public task guides, not installable skills
├── server.json                           # MCP Registry metadata
├── logo.png                              # Marketplace logo
├── LICENSE                               # MIT
└── README.md                             # This file

Links

• Xquik Documentation
• API Reference
• MCP Server Guide
• Framework guides: Mastra, CrewAI, LangChain, Pydantic AI, Google ADK, Microsoft Agent Framework, n8n, Zapier, Make, Pipedream, Composio migration
• skills.sh Page
• skills.sh Primary Skill Page

License

MIT