x-twitter-scraper

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

X (Twitter) Scraper — Xquik

Overview

概述

Gives your AI agent full access to X (Twitter) data through the Xquik platform. Covers tweet search, user profiles, follower extraction, engagement metrics, giveaway draws, account monitoring, webhooks, and 19 bulk extraction tools — all via REST API or MCP server.

通过Xquik平台让你的AI Agent完全访问X（Twitter）数据。涵盖推文搜索、用户资料、粉丝提取、互动指标、抽奖、账号监控、Webhooks以及19种批量提取工具——全部通过REST API或MCP服务器实现。

When to Use This Skill

何时使用该Skill

User needs to search X/Twitter for tweets by keyword, hashtag, or user
User wants to look up a user profile (bio, follower counts, etc.)
User needs engagement metrics for a specific tweet (likes, retweets, views)
User wants to check if one account follows another
User needs to extract followers, replies, retweets, quotes, or community members in bulk
User wants to run a giveaway draw from tweet replies
User needs real-time monitoring of an X account (new tweets, follower changes)
User wants webhook delivery of monitored events
User asks about trending topics on X

用户需要按关键词、话题标签或用户搜索X/Twitter推文
用户想要查询用户资料（简介、粉丝数等）
用户需要特定推文的互动指标（点赞、转发、浏览量）
用户想要查看某一账号是否关注了另一账号
用户需要批量提取粉丝、回复、转发、引用推文或社区成员
用户想要从推文回复中抽取抽奖获奖者
用户需要实时监控X账号（新推文、粉丝变化）
用户希望通过Webhooks接收监控事件
用户询问X上的热门话题

Setup

设置

Install the Skill

安装Skill

bash

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

Or clone manually into your agent's skills directory:

bash

undefined

bash

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

或手动克隆到你的agent的skills目录：

bash

undefined

Claude Code

git clone https://github.com/Xquik-dev/x-twitter-scraper.git .claude/skills/x-twitter-scraper

Cursor / Codex / Gemini CLI / Copilot

git clone https://github.com/Xquik-dev/x-twitter-scraper.git .agents/skills/x-twitter-scraper

undefined

git clone https://github.com/Xquik-dev/x-twitter-scraper.git .agents/skills/x-twitter-scraper

undefined

Get an API Key

获取API密钥

Sign up at xquik.com
Generate an API key from the dashboard
Set it as an environment variable or pass it directly

bash

export XQUIK_API_KEY="xq_YOUR_KEY_HERE"

在xquik.com注册账号
从控制台生成API密钥
将其设置为环境变量或直接传入

bash

export XQUIK_API_KEY="xq_YOUR_KEY_HERE"

Capabilities

功能

Capability	Description
Tweet Search	Find tweets by keyword, hashtag, from:user, "exact phrase"
User Lookup	Profile info, bio, follower/following counts
Tweet Lookup	Full metrics — likes, retweets, replies, quotes, views, bookmarks
Follow Check	Check if A follows B (both directions)
Trending Topics	Top trends by region (free, no quota)
Account Monitoring	Track new tweets, replies, retweets, quotes, follower changes
Webhooks	HMAC-signed real-time event delivery to your endpoint
Giveaway Draws	Random winner selection from tweet replies with filters
19 Extraction Tools	Followers, following, verified followers, mentions, posts, replies, reposts, quotes, threads, articles, communities, lists, Spaces, people search
MCP Server	StreamableHTTP endpoint for AI-native integrations

Capability	描述
Tweet Search	按关键词、话题标签、from:user、"精确短语"查找推文
User Lookup	资料信息、简介、粉丝/关注人数
Tweet Lookup	完整指标——点赞、转发、回复、引用、浏览量、收藏量
Follow Check	检查A是否关注B（双向）
Trending Topics	按地区查看热门话题（免费，无配额限制）
Account Monitoring	追踪新推文、回复、转发、引用、粉丝变化
Webhooks	向你的端点发送HMAC签名的实时事件
Giveaway Draws	从推文回复中随机选择获奖者，支持筛选
19 Extraction Tools	粉丝、关注对象、认证粉丝、提及内容、帖子、回复、转发、引用推文、线程、文章、社区、列表、Spaces、人物搜索
MCP Server	支持AI原生集成的StreamableHTTP端点

Examples

示例

Search tweets:

"Search X for tweets about 'claude code' from the last week"

Look up a user:

"Who is @elonmusk? Show me their profile and follower count"

Check engagement:

"How many likes and retweets does this tweet have? https://x.com/..."

Run a giveaway:

"Pick 3 random winners from the replies to this tweet"

Monitor an account:

"Monitor @openai for new tweets and notify me via webhook"

Bulk extraction:

"Extract all followers of @anthropic"

搜索推文：

"Search X for tweets about 'claude code' from the last week"

查询用户：

"Who is @elonmusk? Show me their profile and follower count"

查看互动数据：

"How many likes and retweets does this tweet have? https://x.com/..."

运行抽奖：

"Pick 3 random winners from the replies to this tweet"

监控账号：

"Monitor @openai for new tweets and notify me via webhook"

批量提取：

"Extract all followers of @anthropic"

API Reference

API参考

Endpoint	Method	Purpose
`/x/tweets/{id}`	GET	Single tweet with full metrics
`/x/tweets/search`	GET	Search tweets
`/x/users/{username}`	GET	User profile
`/x/followers/check`	GET	Follow relationship
`/trends`	GET	Trending topics
`/monitors`	POST	Create monitor
`/events`	GET	Poll monitored events
`/webhooks`	POST	Register webhook
`/draws`	POST	Run giveaway draw
`/extractions`	POST	Start bulk extraction
`/extractions/estimate`	POST	Estimate extraction cost
`/account`	GET	Account & usage info

Base URL:

https://xquik.com/api/v1

Auth:

x-api-key: xq_...

header MCP:

https://xquik.com/mcp

(StreamableHTTP, same API key)

Endpoint	Method	用途
`/x/tweets/{id}`	GET	获取单条推文及完整指标
`/x/tweets/search`	GET	搜索推文
`/x/users/{username}`	GET	获取用户资料
`/x/followers/check`	GET	检查关注关系
`/trends`	GET	获取热门话题
`/monitors`	POST	创建监控任务
`/events`	GET	轮询监控事件
`/webhooks`	POST	注册Webhook
`/draws`	POST	运行抽奖
`/extractions`	POST	启动批量提取
`/extractions/estimate`	POST	估算提取成本
`/account`	GET	获取账号及使用信息

基础URL：

https://xquik.com/api/v1

认证：

x-api-key: xq_...

请求头 MCP：

https://xquik.com/mcp

（StreamableHTTP，使用相同API密钥）

Repository

代码仓库

https://github.com/Xquik-dev/x-twitter-scraper

Maintained By: Xquik

https://github.com/Xquik-dev/x-twitter-scraper

维护方： Xquik

Limitations

限制

Use this skill only when the task clearly matches the scope described above.
Do not treat the output as a substitute for environment-specific validation, testing, or expert review.
Stop and ask for clarification if required inputs, permissions, safety boundaries, or success criteria are missing.

仅当任务明确符合上述描述的范围时使用该Skill。
请勿将输出结果替代环境特定的验证、测试或专家评审。
如果缺少必要的输入、权限、安全边界或成功标准，请暂停并请求澄清。