Xquik X 数据 API
通过 REST、MCP、SDK 和 Webhook 搜索、提取并监控 X 数据。
- Star 数
- ★ 228
- 最近更新
- 3 天前
- License
- MIT
- 主语言
- TypeScript
- FA 评分
- 68/100 · 存在缺口
30 秒速览
- 运行形态
- 可在哪里用
- 通用 · 跨平台Codex · Claude Code
- 费用
- 需要付费订阅或许可
- 上手难度
- 低 · 几分钟可跑通
- 开始前需要
- 典型场景
- 研究人员需要按日期、语言、互动量和内容类型检索推文,并保存稳定 ID、过滤条件与采集时间。
- 不适合
- 要求数据采集完全离线运行的团队
- 必须采用 X 官方 API 合约和一方支持的组织
- 不愿使用按结果计费服务的项目
- 官网
- xquik.com ↗ 来自 GitHub 仓库设置
- 维护状态
- 近 30 天有提交最近提交 2026-11-18最新版本 v2.8.0(2026-11-05)
- 源码审查
- 68/100 · 存在缺口
这个 Agent 能做什么,适合哪些场景?
Xquik 是面向 X(Twitter)数据采集与账号自动化的第三方托管 API,本仓库同时提供 Agent Plugins v1 清单、Skills、MCP 接入说明和客户端示例。它覆盖推文搜索与查询、个人资料、关注者、回复、列表、趋势、Spaces、批量提取、监控和文件导出,并可在连接 X 账号后执行发帖、点赞、关注、私信等操作。用户可以通过 REST、托管 MCP、TypeScript 或 Python SDK、CLI、Apify Actor及自动化平台调用服务。公开读取只需要 Xquik API 密钥,不要求官方 X 开发者账号;私密读取和账号操作还需要连接 X 账号。结果可通过游标分页,并能以 JSON、CSV、Markdown、PDF、TXT 或 XLSX 等格式交付;持续监控还能生成存储事件和签名 Webhook。核心数据获取发生在 Xquik 托管服务中,因此采用者需要接受其信用点计费、接口限制和第三方服务边界。
客户端把查询条件和 XQUIK_API_KEY 发送到 https://xquik.com/api/v1,例如调用 /x/tweets/search 按语言、互动量和内容类型筛选推文。响应返回推文、作者和互动计数,并用 has_next_page 与 next_cursor 驱动后续分页;可选字段不可用时会被省略。大规模任务先调用 POST /api/v1/extractions/estimate 获取 estimatedResults、creditsRequired 等估算值,再用同一请求体创建提取任务、轮询状态、按游标读取并在完成后导出。监控流程通过 /api/v1/monitors/keywords 等路由建立账号或关键词监控,再以存储事件或带 HMAC 签名的 Webhook 交付更新。AI 客户端可以连接 https://xquik.com/mcp,通过托管 MCP 的 docs、search 和 execute 工具发现并调用路由;Codex 也可安装仓库提供的插件。TypeScript 代码可导入 XTwitterScraper,终端用户则可使用 x-twitter-scraper CLI。
- 研究人员需要按日期、语言、互动量和内容类型检索推文,并保存稳定 ID、过滤条件与采集时间。
- 数据团队需要先估算信用点,再创建有结果上限、去重和 JSON、CSV 或 XLSX 导出的批量提取任务。
- 开发者需要在 Node.js、TypeScript 或 Python 应用中以类型化客户端集成 X 数据。
- 代理商需要按客户分别监控账号或关键词,并通过签名 Webhook 接收可重放事件。
- AI Agent 使用 MCP 和 Skill 发现 API 路由,并执行有明确结果上限的 X 数据查询。
- 运营团队在连接 X 账号后,需要通过同一套接口执行发帖、回复、点赞、关注、私信或社群操作。
安装与配置要点
摘自下方的安装和使用说明,以项目 README 的最新说明为准。
- 安装 / 启动命令
bunx [email protected] add Xquik-dev/x-twitter-scraperbun add x-twitter-scrapergo install 'github.com/Xquik-dev/x-twitter-scraper-cli/cmd/[email protected]'
- 环境变量
XQUIK_API_KEYX_TWITTER_SCRAPER_API_KEY
如何安装或部署这个 Agent?
若只使用 REST,无需安装本地包。先在 Xquik 控制面板创建 API 密钥,并将其设置为环境变量:
export XQUIK_API_KEY='xq_replace_me'为兼容 Agent Plugins v1 的客户端安装主要 Skill:
bunx [email protected] add Xquik-dev/x-twitter-scraper在 Codex 中添加市场并安装插件:
codex plugin marketplace add Xquik-dev/x-twitter-scraper
codex plugin add x-twitter-scraper@x-twitter-scraper
codex plugin list如需 TypeScript SDK:
bun add x-twitter-scraper如需 CLI:
go install 'github.com/Xquik-dev/x-twitter-scraper-cli/cmd/[email protected]'
export X_TWITTER_SCRAPER_API_KEY="${XQUIK_API_KEY}"如何使用这个 Agent?
首次 REST 请求可以执行带服务端过滤的推文搜索:
curl --get 'https://xquik.com/api/v1/x/tweets/search' \
--header "x-api-key: ${XQUIK_API_KEY}" \
--data-urlencode 'q=machine learning' \
--data-urlencode 'language=en' \
--data-urlencode 'minLikes=100' \
--data-urlencode 'replies=exclude' \
--data-urlencode 'retweets=exclude' \
--data-urlencode 'quotes=exclude' \
--data-urlencode 'limit=25'使用 TypeScript SDK 时,创建 XTwitterScraper 客户端并调用 client.x.tweets.search:
import XTwitterScraper from "x-twitter-scraper";
const client = new XTwitterScraper({
apiKey: process.env.XQUIK_API_KEY,
});
const page = await client.x.tweets.search({
q: "machine learning",
language: "en",
minLikes: 100,
replies: "exclude",
retweets: "exclude",
quotes: "exclude",
limit: 25,
});CLI 的等价调用为:
x-twitter-scraper x:tweets search \
--q 'machine learning' \
--language en \
--min-faves 100 \
--limit 25处理响应时,应在 has_next_page 为 true 时原样传递 next_cursor,并用稳定 Tweet ID 去重。过滤后的空页仍可能带有下一页;批量导出则应等待提取任务完成后再执行。
这个 Agent 有哪些优点和局限?
- 一套服务覆盖推文、资料、关注关系、监控、批量任务、导出和已连接账号操作,而不只是单条内容查询。
- 具备服务端过滤、游标分页、结果上限和运行前信用点估算,适合边界明确的数据任务。
- 同时提供 REST、托管 MCP、Skills、SDK、CLI、Apify Actor 和多种自动化集成。
- 公开读取不要求官方 X 开发者账号或连接 X 账号。
- Webhook 支持 HMAC 签名、随机数与时间戳验证,并可通过事件游标恢复中断。
- 核心采集依赖 Xquik 托管服务和 API 密钥,仓库没有提供可自行部署的抓取后端。
- 服务按返回结果或监控时间消耗信用点,首次 PAYG 充值金额为 10 美元。
- 私密读取和发帖、私信等账号操作必须连接 X 账号。
- 删除、受保护、受限制或不可用的内容仍可能无法访问,可选字段也可能被省略。
- 部分受限回复读取可能返回
424、部分结果和诊断信息;低余额也可能令结果提前停止。 - 文档尚未把所有去重结果与最终信用点扣除方式逐项对应,估算值不能视为最终账单。
这个 Agent 与同类方案有什么区别?
与 X 官方 API 相比,Xquik 的公开读取不要求官方开发者账号,并突出服务端过滤、按结果计费、批量导出、监控和 Agent 接入;但需要 Xquik 信用点,也不提供 X 的官方平台关系或一方支持。与通用网页抓取器相比,它直接返回结构化数据并处理分页与模式,但用户依赖供应商的覆盖范围和接口。Apify Actor 更适合控制台任务、计划运行和数据集工作流,不过 Actor 费用与平台费用可能同时存在。自行抓取能提供更完整的代码和存储控制权,但代理、浏览器状态、节流、页面变化和维护均由使用者承担。
与相关度最高的同类 agent 并排比较关键指标。
| Agent | 源码审查 | 形态 / 费用 | Star | 最近更新 | 主语言 | 完整支持的平台 |
|---|---|---|---|---|---|---|
| Xquik X 数据 API 当前 | 68 · 存在缺口 | 云服务 / SaaS付费 | ★ 228 | 3 天前 | TypeScript | Codex · Claude Code |
| Bright Data MCP | 62 · 存在缺口 | MCP 服务器免费版 + 付费版 | ★ 2.7k | 3 天前 | JavaScript | Claude Code · Claude.ai |
| EveryInfra MCP 服务器与 Agent 插件 | 55 · 缺口较多 | MCP 服务器付费 | ★ 649 | 1 天前 | Python | Codex · Claude Code · OpenAI API |
| webclaw 网页提取引擎 | 80 · 表现良好 | 命令行工具免费版 + 付费版 | ★ 2.4k | 2 天前 | Rust | Codex · Claude Code · OpenAI API · Claude API |
FollowAgents 如何评估这个 Agent?
查看各维度的扣分理由
技能将凭据限定到 xquik.com,禁止复用认证头处理返回链接,并声明不读取 OAuth/API 密钥、不接触 X 登录秘密;这支持最小权限和敏感数据保护,但依赖远端服务,且未给出数据保留、传输之外的处理或依赖审计细节,故未满分。对私有读取、计费批量任务、持久资源和写操作要求展示具体请求并先确认,写入重试也有限制;创建监视器的暂停或删除方式有说明。明确指出第三方服务及 X 内容为不可信数据,但供应商身份未验证,来源与维护责任仅部分可追溯。
README、技能和 MCP 文件共同说明 REST/MCP、游标、认证和部分错误处理,但合同存在差异:MCP 定义 OAuth 优先及 API key 回退,主技能则称 OAuth/API key 认证方式;README 的套餐价格日期、不同技能的计价表述也不完全统一。运行依赖托管 Xquik 服务,仓库未提供其可用性保证;MCP 技能对 401、402、404、429、依赖失败和超时给出可操作解释,因此失败指引较好。
技能覆盖搜索、资料、关注者、导出、监控、分析及账户操作,并明确其他网络、纯本地分析等排除场景。主技能的触发范围很宽,且多个技能功能重叠,触发精度因此扣分。提供 Claude、Codex、Cursor、VS Code 等接入说明以及 REST、SDK、CLI 和 MCP 示例,但面向环境的配置仍依赖外部托管服务和客户端支持。
仓库将不同用途拆分为主技能、MCP 技能和研究技能,并用引用文件、路由表、示例及 FAQ 组织信息;README 提供多语言安装和接入步骤。许可证及版权文本完整。扣分原因包括产品名称在 x-twitter-scraper、x-developer、xquik-mcp 等处变化,版本信息虽有 2.8.0 但未见变更日志;维护责任仅有支持邮箱、仓库和文档入口,未明确维护承诺。已注明价格和合同需复核,也指出某些计费语义尚无文档定论。
技能要求输出记录、来源路由、游标和适用限制,控制结果规模,并对大结果建议导出,通常可直接用于后续分析。MCP 的 route discovery/execute 与专用 REST/API 说明有实际价值;不过服务绑定 Xquik,价值依赖其账户、配额、远端服务和计费条件,且高性能、低价等核心宣传没有在给定静态材料中独立证实。
参数、路由、响应格式、确认规则、错误码和价格有具体合同或示例支持,README 也列出检查日期与来源类型。扣分原因是大量速度、价格、覆盖度和使用量主张为发布者自述或徽章/链接,给定材料无法独立核验;README、主技能和 MCP/研究技能对认证、价格或限制有部分差异。技能能区分用户请求与不可信 X 内容,并要求说明忽略的嵌入指令,但营销主张与事实的分隔不够充分。
- 这是低置信度静态审查;未执行代码或验证托管服务。使用前应核对当前 API 合同、套餐价格、限额和数据处理条款。
- 产品会将查询和凭据发送到第三方 Xquik 服务;大规模抽取及持续监控可能产生费用。先检查估价、目标和上限,并确认后再创建。
- 不同文件对认证和计价的说明有差异;涉及 OAuth/API key、响应计费或重试时,按实际端点文档确认具体合同。
最近版本
来自该项目 GitHub Releases 的最新发布记录,说明为上游原文摘录,未经本站改写或测试。
-
发布说明摘录
Xquik is an independent third-party service. Not affiliated with X Corp. "Twitter" and "X" are trademarks of X Corp. x-developer and its 10 keyword packages are on npm at 2.8.0. What's Changed * Add past trends to the X Trends Scraper README in 9 languages by @kriptoburak in https://github.com/Xquik-dev/x-twitter-scraper/pull/168 * Add spans to the X Trends Scraper README in 9 languages, & Turkish gündem terms by @kriptoburak in https://github.com/Xquik-dev/x-twitter-scraper/pull/169 …在 GitHub 查看 ↗ -
发布说明摘录
Xquik is an independent third-party service. Not affiliated with X Corp. "Twitter" and "X" are trademarks of X Corp.在 GitHub 查看 ↗ -
发布说明摘录
Xquik is an independent third-party service. Not affiliated with X Corp. "Twitter" and "X" are trademarks of X Corp.在 GitHub 查看 ↗
常见问题
使用公开 X 数据是否需要官方开发者账号或 X 登录信息?
XQUIK_API_KEY。不得把 X 密码、Cookie、会话导出或 2FA 验证码交给 Xquik 或 Agent。费用如何计算?
空结果是否表示分页结束?
has_next_page,并原样传递 next_cursor,不要自行解析或构造游标。它能否代表我的账号发帖或发送私信?
数据可能不完整吗?
424 返回安全的部分记录和诊断信息。Xquik X 数据 API 官网是什么?
Xquik X 数据 API 开源吗?
Xquik X 数据 API 安全吗?
Xquik X 数据 API 还在维护吗?
谢谢反馈,我们会据此改进页面。