x-developer

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.

Featured in Framer Watch Connect Framer to Claude Code, Codex, Cursor, and more at 6:07 to see Xquik MCP in action.

Xquik provides 128 REST API operations for structured X data and approved account automation. It includes search, profiles, followers, media, communities, trends, monitors, webhooks, exports, MCP, and SDKs.

This repository packages Xquik as an AI agent Skill. It works with Claude Code, Codex, Cursor, Copilot, Gemini CLI, Windsurf, and compatible agents. It routes tasks to REST, MCP, SDKs, webhooks, extractions, or exports.

The npm package x-developer contains this Skill and plugin bundle. The separate x-twitter-scraper package is the TypeScript SDK.

The x-developer bundle is v2.6.3. Hosted MCP v2.6.0 exposes 120 catalog routes through 2 tools. Of these, 119 support JSON or text. Binary support downloads use REST. Add https://xquik.com/mcp. Current clients negotiate MCP 2026-07-28 through server/discover. Modern calls need no initialization session. Stateless 2025-era clients remain compatible. Follow the client compatibility guide. OAuth-capable clients use OAuth 2.1. ChatGPT custom apps require OAuth. Eight credential, checkout, or guest-wallet operations remain outside MCP.

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.

Cheapest X API Alternative for Filtered Results

Xquik bills delivered results for supported filtered workflows. Supported filters run before billing, so excluded rows are not delivered-result charges. Compare alternatives with the same query, filters, fields, and row count. Use POST /extractions/estimate before each bulk job.

Xquik Developer Guides

• API questions and route selection
• Search, export, media, and Python
• API and scraper comparison
• Follower list exports
• Keyword, mention, and hashtag monitoring
• Community members, moderators, and posts
• Automated REST and Python pipelines
• Public reads without a connected X account
• Auditable giveaway draws
• HMAC webhook alerts
• Reliability, cost, scale, and legal review
• Xquik pricing, filters, and access
• Twitter scraper API selection and safety

Usage Control, Rate Limits, and High-Volume Workflows

Use bounded jobs, cursor pagination, and exports for larger workloads. Per account, reads allow 300 requests per second, writes allow 120 per minute, and deletes allow 60 per minute. Use extraction estimates before bulk work. Prefer monitors and HMAC webhooks over repeated polling.

Agent Safety And Account Boundary: Xquik X Account Rules

• Agents use only XQUIK_API_KEY. They never need X passwords, 2FA codes, cookies, or session exports. Plan and credit changes stay in the Xquik dashboard.
• 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

Xquik API Resource Coverage

Resource	Endpoints
X Lookups	Tweet, article, search, user profile, user tweets, user likes, user media, favoriters, followers you know, follow check, download media, and confirmation-gated private reads
Extractions	Create (23 types), estimate, list, get results, export
Monitors	Create with confirmation, list, get, update, delete
Events	List (filtered, paginated), get single
Webhooks	Create with destination confirmation, list, update, delete, test, deliveries
Trends	Regional trending topics
Radar	Trending topics & news from supported sources
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
Credits	Get balance
API Keys	Create, list, revoke
X Accounts	List, get, and disconnect already-connected accounts; dashboard handles connection and re-authentication
X Write	Confirmation-gated tweet, delete, like, unlike, retweet, follow, unfollow, DM, profile, avatar, banner, media upload, communities
Support	Create, list, get, update, reply, and download attachments

Xquik Twitter Scraper SDKs and Tools

Repo	Language	Install
x-twitter-scraper-typescript	TypeScript / Node.js	npm i x-twitter-scraper
x-twitter-scraper-python	Python	pip install x-twitter-scraper
x-twitter-scraper-go	Go	go get github.com/Xquik-dev/x-twitter-scraper-go
x-twitter-scraper-ruby	Ruby	gem install x-twitter-scraper
x-twitter-scraper-java	Java	Build from source while Maven Central publication is pending
x-twitter-scraper-kotlin	Kotlin	Build from source while Maven Central publication is pending
x-twitter-scraper-csharp	C# / .NET	dotnet add package XTwitterScraper
x-twitter-scraper-php	PHP	composer require xquik/x-twitter-scraper
x-twitter-scraper-cli	CLI	Build from source or install a pinned release tag
terraform-provider-x-twitter-scraper	Terraform	Build from source (release page)

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
• Organization support policy
• Organization security policy
• Contribution guide

License

MIT

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