Xquik X 数据 API

这个 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 账号后，需要通过同一套接口执行发帖、回复、点赞、关注、私信或社群操作。

如何安装或部署这个 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 有哪些优点和局限？

这个 Agent 与同类方案有什么区别？

与相关度最高的同类 agent 并排比较关键指标。

FollowAgents 如何评估这个 Agent？

常见问题