Xquik-dev/x-twitter-scraper
GitHub: Xquik-dev/x-twitter-scraper
为 AI 编程代理提供 X/Twitter 数据抓取和自动化操作能力的技能包,集成 60+ API 端点和 MCP 工具。
Stars: 15 | Forks: 1
# 适用于 AI 编程代理的 X API / Twitter 抓取技能
一个 [AI 代理技能](https://skills.sh),为编程代理提供关于 [Xquik](https://xquik.com) X (Twitter) 实时数据平台的深度知识。搜索和提取推文、下载媒体、抓取粉丝/关注列表、监控账户,并连接到 MCP 服务器以实现 AI 原生工作流。
支持 **40+ AI 编程代理**,包括 Claude Code、OpenAI Codex、Cursor、GitHub Copilot、Gemini CLI、Windsurf、VS Code Cline、Roo Code、Goose、Amp、Augment、Continue、OpenHands、Trae、OpenCode 等。
## 安装说明
通过 [skills CLI](https://skills.sh) 安装(自动检测您已安装的代理):
```
npx skills add Xquik-dev/x-twitter-scraper
```
### 手动安装
## 此技能的功能
安装后,此技能将让您的 AI 编程助手获得关于 Xquik 平台的深度知识:
- **推文搜索与查询**:通过关键词、hashtag、高级运算符(`from:`、`to:`、`"exact phrase"`、`OR`、`-exclude`)搜索推文。获取任意推文的完整互动指标(点赞、转发、回复、浏览量、收藏)
- **用户资料查询**:获取任意 X 账户的粉丝/关注数、简介、位置和资料数据
- **粉丝与关注提取**:提取任意账户的完整粉丝列表、认证粉丝和关注列表
- **回复、转发与引用提取**:批量提取任意推文的所有回复、转发和引用推文
- **媒体下载**:从任意推文下载图片、视频和 GIF,并提供永久托管的 URL
- **话题串与文章提取**:提取完整推文话题串和链接文章内容
- **社区与 Space 数据**:提取社区成员、版主、帖子以及 Space 参与者
- **人员与推文搜索提取**:按关键词批量搜索用户或按 hashtag 提取推文(最多 1,000 条)
- **互关检查器**:检查两个账户是否互相关注
- **X 账户监控**:实时追踪账户的新推文、回复、引用、转发和粉丝变化
- **Webhook 推送**:在您的 HTTPS 端点接收经 HMAC 签名的事件通知
- **热门话题**:按地区获取热门 hashtag 和话题
- **Radar**:来自 7 个来源(Google Trends、Hacker News、Polymarket、TrustMRR、Wikipedia、GitHub、Reddit)的热门新闻。免费
- **抽奖活动**:通过可配置的过滤器从推文回复中进行透明抽奖
- **写入操作**:通过已连接的 X 账户发布推文、点赞、转发、关注/取关、发送私信、更新资料、上传媒体、管理社区
- **Telegram 集成**:在 Telegram 中接收实时监控事件通知
- **MCP 服务器集成**:通过 MCP 将 AI 代理连接到 X 数据(v2:覆盖 76 个端点的 2 工具沙盒,v1 旧版:18 个独立工具)
## 功能特性
| 领域 | 详情 |
|------|---------|
| **REST API** | 跨 12 个资源组的 76 个端点,支持重试逻辑和分页 |
| **推文获取** | 单条推文查询(含完整指标)、关键词/hashtag 搜索 |
| **用户查询** | 资料数据、粉丝/关注数、认证状态 |
| **粉丝分析** | 提取任意账户的粉丝、关注、认证粉丝 |
| **数据提取** | 20 种批量提取工具(回复、转发、引用、话题串、文章、社区、列表、Spaces、人员搜索、推文搜索、提及、帖子) |
| **抽奖活动** | 从推文回复中随机抽取获奖者,支持 11 种过滤选项 |
| **写入操作** | 发布/删除推文、点赞/取消点赞、转发、关注/取关、私信、资料更新、媒体上传、社区操作 |
| **Telegram 集成** | 通过 Telegram 机器人发送实时监控事件通知 |
| **账户监控** | 实时追踪推文、回复、引用、转发、粉丝变化 |
| **Webhooks** | Node.js、Python、Go 中的 HMAC-SHA256 签名验证 |
| **媒体下载** | 下载图片、视频、GIF 并提供永久托管的 URL(首次下载计费,缓存免费) |
| **MCP Server** | v2:2 工具沙盒(76 个端点),v1 旧版:18 个工具。StreamableHTTP,支持 10 个平台的配置 |
| **互动分析** | 每条推文的点赞、转发、回复、引用、浏览量、收藏 |
| **热门话题** | 带搜索查询的区域热门趋势 |
| **推文创作** | 算法优化的推文编辑器,含评分清单(免费) |
| **TypeScript 类型** | 所有 API 对象的完整类型定义 |
## 支持的代理
Claude Code、OpenAI Codex、Cursor、GitHub Copilot、Gemini CLI、Windsurf、VS Code Copilot、Cline、Roo Code、Goose、Amp、Augment、Continue、OpenHands、Trae、OpenCode,以及任何支持 skills.sh 协议的代理。
## API 覆盖范围
| 资源 | 端点 |
|----------|-----------|
| X Lookups | 按 ID 查询推文、搜索推文、用户资料、关注检查、下载媒体 |
| Extractions | 创建(20 种类型)、估算、列出、获取结果、导出 |
| Monitors | 创建、列出、获取、更新、删除 |
| Events | 列表(过滤、分页)、获取单个事件 |
| Webhooks | 创建、列出、更新、删除、测试、投递记录 |
| Trends | 区域热门话题 |
| Radar | 来自 7 个来源的热门话题和新闻(免费) |
| Draws | 带过滤器创建、列出、获取获奖者、导出 |
| Styles | 分析、保存、列出、获取、删除、比较、表现 |
| Compose | 推文创作(撰写、优化、评分) |
| Drafts | 创建、列出、获取、删除 |
| Account | 获取账户、更新区域设置、设置 X 身份、订阅 |
| API Keys | 创建、列出、撤销 |
| X Accounts | 连接、列出、获取、断开连接、重新认证 |
| X Write | 推文、删除、点赞、取消点赞、转发、关注、取关、私信、资料、头像、横幅、媒体上传、社区 |
| Integrations | 创建(Telegram)、列出、获取、更新、删除、测试、投递记录 |
## 技能结构
```
x-twitter-scraper/
├── skills/
│ └── x-twitter-scraper/
│ ├── SKILL.md # Main skill (auth, endpoints, patterns)
│ ├── metadata.json # Version and references
│ └── references/
│ ├── api-endpoints.md # All REST API endpoints
│ ├── mcp-tools.md # All 18 v1 legacy MCP tools with schemas
│ ├── mcp-setup.md # MCP configs for 10 platforms (v2 + v1)
│ ├── webhooks.md # Webhook setup & verification
│ ├── extractions.md # 20 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
```
## 链接
- [Xquik 平台](https://xquik.com)
- [API 文档](https://docs.xquik.com)
- [API 参考](https://docs.xquik.com/api-reference/overview)
- [MCP 服务器指南](https://docs.xquik.com/mcp/overview)
- [skills.sh 页面](https://skills.sh/Xquik-dev/x-twitter-scraper)
## 许可证
MIT
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 ```标签:AI编程代理, API集成, Claude, Copilot, Cursor, CVE检测, MCP服务器, MITM代理, REST API, Twitter爬虫, URL抓取, Webhooks, X平台自动化, 即时通讯监控, 可观测性, 大模型工具, 威胁情报, 媒体下载, 开发者工具, 数据抓取, 数据泄露, 社交媒体监控, 粉丝提取, 舆情分析, 舆论监控, 逆向工具