x-twitter-scraper

# Xquik API 集成 Xquik 是一个 X (Twitter) 实时数据平台，为 AI 智能体提供 REST API、HMAC Webhook 和 MCP 服务器。它涵盖了账户监控、批量数据提取（19 种工具）、抽奖、推文/用户查询、关注检查和趋势话题等功能。 ## 快速参考 | | | |---|---| | **基础 URL** | `https://xquik.com/api/v1` | | **认证** | `x-api-key: xq_...` 请求头 (xq_ 前缀后跟 64 位十六进制字符) | | **MCP 端点** | `https://xquik.com/mcp` (StreamableHTTP，使用相同的 API 密钥) | | **速率限制** | API：10 req/s 持续，20 req/s 突发；通用：60 req/s 持续，100 req/s 突发 | | **定价** | 20 美元/月基础版（含 1 个监控器），额外监控器 5 美元/月 | | **配额** | 每月使用上限，硬限制，无超额费用。耗尽时返回 `402` | | **文档** | [docs.xquik.com](https://docs.xquik.com) | ## 认证 每个请求都需要通过 `x-api-key` 请求头提供 API 密钥。密钥以 `xq_` 开头，从 [Xquik 控制面板](https://xquik.com) 生成。密钥仅在创建时显示一次；请妥善保存。 javascript const API_KEY = "xq_YOUR_KEY_HERE"; const BASE = "https://xquik.com/api/v1"; const headers = { "x-api-key": API_KEY, "Content-Type": "application/json" }; ## 选择合适的端点 | 目标 | 端点 | 说明 | |------|----------|-------| | 通过 ID/URL 获取单条推文 | `GET /x/tweets/{id}` | 完整指标：点赞、转发、浏览、书签 | | 按关键词/标签搜索推文 | `GET /x/tweets/search?q=...` | 可选互动指标 | | 获取用户资料 | `GET /x/users/{username}` | 简介、关注/粉丝数、头像 | | 检查关注关系 | `GET /x/followers/check?source=A&target=B` | 双向检查 | | 获取热门趋势 | `GET /trends?woeid=1` | 免费，不消耗配额 | | 监控 X 账户 | `POST /monitors` | 追踪推文、回复、引用、粉丝变化 | | 轮询事件 | `GET /events` | 基于游标分页，可按 monitorId/eventType 过滤 | | 实时接收事件 | `POST /webhooks` | HMAC 签名交付至你的 HTTPS 端点 | | 运行抽奖 | `POST /draws` | 从推文回复中随机抽取获胜者 | | 批量提取数据 | `POST /extractions` | 19 种工具类型，提取前请先估算成本 | | 检查账户/使用情况 | `GET /account` | 计划状态、监控器数量、使用百分比 | ## 提取工具（19 种类型） | 工具类型 | 必需字段 | 描述 | |-----------|---------------|-------------| | `reply_extractor` | `targetTweetId` | 回复推文的用户 |