什么是 io.github.kriptoburak/xquik?
提供实时 X(Twitter)数据能力,支持推文搜索、用户查询、媒体获取与持续监控等。
README
X (Twitter) Scraper API Skill: Search Tweets, Get Profile Tweets, Followers, Posting & Replies
An AI agent skill for Xquik, a Twitter API alternative for developers who need to search tweets, get tweets from profiles, export followers, download media, monitor accounts, and automate posting workflows.
Use it for advanced Twitter search, tweet search API calls, profile tweet scraping, follower export to CSV, media download, tweet scheduling, send tweets, post replies, like, repost, follow, DM, webhooks, MCP, and official SDK workflows from AI coding agents.
Includes 100+ REST API endpoints, 2 MCP tools, HMAC webhooks, 23 bulk extraction tools, and confirmation-gated write actions.
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.
Usage Costs
This installable skill can read credit balance and estimate usage costs. Users manage plan and credit changes in the Xquik dashboard.
vs Official X API
| Xquik | Official X API | Notes | |
|---|---|---|---|
| Access model | Dashboard-managed account + usage credits | Usage-based account | This skill reads balance and estimates cost only |
| Post reads | Metered in usage credits | Pay-per-usage resource pricing | Estimate before running |
| User lookup | Metered in usage credits | Pay-per-usage resource pricing | Estimate before running |
| Trend reads | Metered in usage credits | Pay-per-usage resource pricing | Estimate before running |
| Write actions | Metered in usage credits | Pay-per-usage write pricing | Confirmation required |
| Bulk extraction | Metered per result in usage credits | Charged per returned resource | Built-in extraction jobs are included with Xquik |
| Monitoring + webhooks | Active monitors are metered; webhooks included | No direct monitor product in pricing table | Real-time delivery is included |
| Giveaway draws | Metered per entry in usage credits | No comparable draw product | Draw engine is included |
| MCP server | Included | Not listed | Agent tools are included |
Source: official X API pricing, which lists current pay-per-usage rates.
Per-Operation Usage Credits
| Operation | Credits |
|---|---|
| Read (tweet, search, timeline, bookmarks, etc.) | 1 |
| Read (user profile, verified followers, followers you know) | 1 |
| Read (favoriters) | 1 |
| Read (trends) | 3 |
| Follow check, article | 5 |
| Write (tweet, like, retweet, follow, DM, etc.) | 10 |
| Extraction (tweets, replies, quotes, mentions, posts, likes, media, search, favoriters, retweeters, community members, people search, list members, list followers) | 1/result |
| Extraction (followers, following, verified followers) | 1/result |
| Extraction (articles) | 5/result |
| Draw | 1/entry |
| Active monitors | 21/hour |
| Webhooks, radar, compose, drafts | 0 |
Skill Account Boundary
Only balance reads and usage estimates are in scope for this skill. Plan and credit changes are dashboard-only.
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. Free
- 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 (free)
- Usage credits: Check balance and estimate costs; dashboard handles plan and credit changes
- Support tickets: Open and manage support tickets via API
- MCP server: 2 tools covering 100+ endpoints for AI agent integration
Capabilities
| Area | Details |
|---|---|
| REST API | 100+ endpoints across 10 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, and confirmation-gated private reads |
| Write Actions | Confirmation-gated post/delete tweets, like/unlike, retweet, follow/unfollow, remove followers, 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 with ongoing-cost confirmation |
| Webhooks | HMAC-SHA256 signature verification in Node.js, Python, Go |
| Media Download | Download images, videos, GIFs with permanent hosted URLs |
| Engagement Analytics | Likes, retweets, replies, quotes, views, bookmarks per tweet |
| Trending Topics | Regional trends plus supported news sources via Radar |
| Tweet Composition | Algorithm-optimized tweet composer with scoring checklist (free) |
| Usage Credits | Check balance and estimate costs; dashboard handles plan and credit changes |
| 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, 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 (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 |
| 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 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.
| 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) |
| tweetclaw | OpenClaw plugin | openclaw plugins install @xquik/tweetclaw |
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 # REST API endpoint reference
│ ├── 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
├── 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
常见问题
io.github.kriptoburak/xquik 是什么?
提供实时 X(Twitter)数据能力,支持推文搜索、用户查询、媒体获取与持续监控等。
相关 Skills
前端设计
by anthropics
面向组件、页面、海报和 Web 应用开发,按鲜明视觉方向生成可直接落地的前端代码与高质感 UI,适合做 landing page、Dashboard 或美化现有界面,避开千篇一律的 AI 审美。
✎ 想把页面做得既能上线又有设计感,就用前端设计:组件到整站都能产出,难得的是能避开千篇一律的 AI 味。
网页应用测试
by anthropics
用 Playwright 为本地 Web 应用编写自动化测试,支持启动开发服务器、校验前端交互、排查 UI 异常、抓取截图与浏览器日志,适合调试动态页面和回归验证。
✎ 借助 Playwright 一站式验证本地 Web 应用前端功能,调 UI 时还能同步查看日志和截图,定位问题更快。
网页构建器
by anthropics
面向复杂 claude.ai HTML artifact 开发,快速初始化 React + Tailwind CSS + shadcn/ui 项目并打包为单文件 HTML,适合需要状态管理、路由或多组件交互的页面。
✎ 在 claude.ai 里做复杂网页 Artifact 很省心,多组件、状态和路由都能顺手搭起来,React、Tailwind 与 shadcn/ui 组合效率高、成品也更精致。
相关 MCP Server
GitHub
编辑精选by GitHub
GitHub 是 MCP 官方参考服务器,让 Claude 直接读写你的代码仓库和 Issues。
✎ 这个参考服务器解决了开发者想让 AI 安全访问 GitHub 数据的问题,适合需要自动化代码审查或 Issue 管理的团队。但注意它只是参考实现,生产环境得自己加固安全。
Context7 文档查询
编辑精选by Context7
Context7 是实时拉取最新文档和代码示例的智能助手,让你告别过时资料。
✎ 它能解决开发者查找文档时信息滞后的问题,特别适合快速上手新库或跟进更新。不过,依赖外部源可能导致偶尔的数据延迟,建议结合官方文档使用。
by tldraw
tldraw 是让 AI 助手直接在无限画布上绘图和协作的 MCP 服务器。
✎ 这解决了 AI 只能输出文本、无法视觉化协作的痛点——想象让 Claude 帮你画流程图或白板讨论。最适合需要快速原型设计或头脑风暴的开发者。不过,目前它只是个基础连接器,你得自己搭建画布应用才能发挥全部潜力。