Xquik X 数据 API

通过 REST、MCP、SDK 和 Webhook 搜索、提取并监控 X 数据。

Star 数
★ 228
最近更新
3 天前
License
MIT
主语言
TypeScript

30 秒速览

运行形态
云服务 / SaaSMCP 服务器Agent 插件 / 技能
可在哪里用
通用 · 跨平台Codex · Claude Code
费用
需要付费订阅或许可
上手难度
低 · 几分钟可跑通
开始前需要
XQUIK_API_KEY私密读取和 X 账号操作所需的已连接 X 账号Shell / 命令行网络访问MCP Server
典型场景
研究人员需要按日期、语言、互动量和内容类型检索推文,并保存稳定 ID、过滤条件与采集时间。
不适合
  • 要求数据采集完全离线运行的团队
  • 必须采用 X 官方 API 合约和一方支持的组织
  • 不愿使用按结果计费服务的项目
官网
xquik.com ↗ 来自 GitHub 仓库设置
维护状态
近 30 天有提交最近提交 2026-11-18最新版本 v2.8.0(2026-11-05)

这个 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。

  1. 研究人员需要按日期、语言、互动量和内容类型检索推文,并保存稳定 ID、过滤条件与采集时间。
  2. 数据团队需要先估算信用点,再创建有结果上限、去重和 JSON、CSV 或 XLSX 导出的批量提取任务。
  3. 开发者需要在 Node.js、TypeScript 或 Python 应用中以类型化客户端集成 X 数据。
  4. 代理商需要按客户分别监控账号或关键词,并通过签名 Webhook 接收可重放事件。
  5. AI Agent 使用 MCP 和 Skill 发现 API 路由,并执行有明确结果上限的 X 数据查询。
  6. 运营团队在连接 X 账号后,需要通过同一套接口执行发帖、回复、点赞、关注、私信或社群操作。

安装与配置要点

摘自下方的安装和使用说明,以项目 README 的最新说明为准。

安装 / 启动命令
环境变量
XQUIK_API_KEY X_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?

FollowAgents 源码审查 · FARS-2.1
存在缺口
68/ 100 五分制 3.4 / 5
信任安全 19/29
可靠稳定 6/14
适用触发 15/18
规范维护 13/18
有效结果 10/13
证据核验 5/8
查看各维度的扣分理由
信任安全19 / 29 · 3.3/5

技能将凭据限定到 xquik.com,禁止复用认证头处理返回链接,并声明不读取 OAuth/API 密钥、不接触 X 登录秘密;这支持最小权限和敏感数据保护,但依赖远端服务,且未给出数据保留、传输之外的处理或依赖审计细节,故未满分。对私有读取、计费批量任务、持久资源和写操作要求展示具体请求并先确认,写入重试也有限制;创建监视器的暂停或删除方式有说明。明确指出第三方服务及 X 内容为不可信数据,但供应商身份未验证,来源与维护责任仅部分可追溯。

可靠稳定6 / 14 · 2.1/5

README、技能和 MCP 文件共同说明 REST/MCP、游标、认证和部分错误处理,但合同存在差异:MCP 定义 OAuth 优先及 API key 回退,主技能则称 OAuth/API key 认证方式;README 的套餐价格日期、不同技能的计价表述也不完全统一。运行依赖托管 Xquik 服务,仓库未提供其可用性保证;MCP 技能对 401、402、404、429、依赖失败和超时给出可操作解释,因此失败指引较好。

适用触发15 / 18 · 4.2/5

技能覆盖搜索、资料、关注者、导出、监控、分析及账户操作,并明确其他网络、纯本地分析等排除场景。主技能的触发范围很宽,且多个技能功能重叠,触发精度因此扣分。提供 Claude、Codex、Cursor、VS Code 等接入说明以及 REST、SDK、CLI 和 MCP 示例,但面向环境的配置仍依赖外部托管服务和客户端支持。

规范维护13 / 18 · 3.6/5

仓库将不同用途拆分为主技能、MCP 技能和研究技能,并用引用文件、路由表、示例及 FAQ 组织信息;README 提供多语言安装和接入步骤。许可证及版权文本完整。扣分原因包括产品名称在 x-twitter-scraper、x-developer、xquik-mcp 等处变化,版本信息虽有 2.8.0 但未见变更日志;维护责任仅有支持邮箱、仓库和文档入口,未明确维护承诺。已注明价格和合同需复核,也指出某些计费语义尚无文档定论。

有效结果10 / 13 · 3.8/5

技能要求输出记录、来源路由、游标和适用限制,控制结果规模,并对大结果建议导出,通常可直接用于后续分析。MCP 的 route discovery/execute 与专用 REST/API 说明有实际价值;不过服务绑定 Xquik,价值依赖其账户、配额、远端服务和计费条件,且高性能、低价等核心宣传没有在给定静态材料中独立证实。

证据核验5 / 8 · 3.1/5

参数、路由、响应格式、确认规则、错误码和价格有具体合同或示例支持,README 也列出检查日期与来源类型。扣分原因是大量速度、价格、覆盖度和使用量主张为发布者自述或徽章/链接,给定材料无法独立核验;README、主技能和 MCP/研究技能对认证、价格或限制有部分差异。技能能区分用户请求与不可信 X 内容,并要求说明忽略的嵌入指令,但营销主张与事实的分隔不够充分。

风险与缓解建议
  • 这是低置信度静态审查;未执行代码或验证托管服务。使用前应核对当前 API 合同、套餐价格、限额和数据处理条款。
  • 产品会将查询和凭据发送到第三方 Xquik 服务;大规模抽取及持续监控可能产生费用。先检查估价、目标和上限,并确认后再创建。
  • 不同文件对认证和计价的说明有差异;涉及 OAuth/API key、响应计费或重试时,按实际端点文档确认具体合同。
证据充分度:低 评估于 2026年11月8日 审查版本 a8a4b0b7db4a 评估后仓库已有新提交,评分可能未覆盖最新改动
查看完整评分方法 →
你是这个项目的维护者?把 FARS 徽章加到 README

徽章显示当前的评审分数和结论,点击回到本页。重新评审后约一小时内更新。

FARS

[![FARS 评测](https://followagents.com/badge/x-twitter-scraper.svg?lang=zh)](https://followagents.com/zh/agents/x-twitter-scraper)
<a href="https://followagents.com/zh/agents/x-twitter-scraper"><img src="https://followagents.com/badge/x-twitter-scraper.svg?lang=zh" alt="FARS 评测"></a>

最近版本

来自该项目 GitHub Releases 的最新发布记录,说明为上游原文摘录,未经本站改写或测试。

  1. v2.8.0
    发布说明摘录
    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 查看 ↗
  2. v2.6.7
    发布说明摘录
    Xquik is an independent third-party service. Not affiliated with X Corp. "Twitter" and "X" are trademarks of X Corp.
    在 GitHub 查看 ↗
  3. v2.6.6
    发布说明摘录
    Xquik is an independent third-party service. Not affiliated with X Corp. "Twitter" and "X" are trademarks of X Corp.
    在 GitHub 查看 ↗

常见问题

使用公开 X 数据是否需要官方开发者账号或 X 登录信息?
不需要官方 X 开发者账号,也无需连接 X 账号;但必须提供 XQUIK_API_KEY。不得把 X 密码、Cookie、会话导出或 2FA 验证码交给 Xquik 或 Agent。
费用如何计算?
推文搜索按每条返回推文 1 个信用点计费。来源给出的 PAYG 单价为每条 0.00015 美元,因此 25 条最多 0.00375 美元;首次 PAYG 充值为 10 美元,未使用信用点可结转。活跃监控每小时消耗 21 个信用点。
空结果是否表示分页结束?
不一定。过滤后的页面可能为空但仍有下一页;应持续检查 has_next_page,并原样传递 next_cursor,不要自行解析或构造游标。
它能否代表我的账号发帖或发送私信?
可以,但必须先连接 X 账号。执行前应确认账号、目标、载荷和成本,写操作使用幂等键,并在结果不明确时先轮询状态再重试。
数据可能不完整吗?
可能。删除、受保护、受限制或不可用的内容可能无法取得,不可用的可选字段会被省略;部分回复读取还可能以 424 返回安全的部分记录和诊断信息。
Xquik X 数据 API 官网是什么?
Xquik X 数据 API 的 GitHub 仓库填写的官网是 https://xquik.com。这个链接由仓库作者设置;源码在 GitHub(Xquik-dev/x-twitter-scraper)。
Xquik X 数据 API 开源吗?
开源。源码在 GitHub(Xquik-dev/x-twitter-scraper),许可证是 MIT。
Xquik X 数据 API 安全吗?
FollowAgents 的 FARS 评审(2026年11月8日)给 Xquik X 数据 API 的“信任与安全”打了 19/29 分。评审检查的 8 项安全措施没有完全缺失的。评审之后仓库已有更新。
Xquik X 数据 API 还在维护吗?
在维护。GitHub 上最近一次提交是 2026-11-18,在最近 30 天内。最新版本是 v2.8.0(2026-11-05)。
这页内容对你有帮助吗?
在 GitHub 查看 ↗ 安装 ↓

对比同类 Agent

用同一套 FARS 评审,横向比较这个 Agent 所属的短名单。

相关核心概念