跳到正文
浏览文档

AI 代理

在 AI 代理里使用 xscraper

MCP 服务器给 Claude、Codex、Muse Code、Cursor、VS Code 以及其他 MCP 客户端提供九个只读的 X 数据工具。技能告诉代理哪一个工具适合这项任务，以及怎样用尽可能少的 token 得到答案。两者都使用你的 API key，每次工具调用的花费与它背后的 REST 调用相同。

获取 API keyensp1re/xscraper-agent-kit

MCP 服务器

MCPhttps://mcp.xscraper.online/mcp

可流式传输的 HTTP，密钥放在x-api-key请求头里。如果客户端只能启动本地服务器，同一批工具也可以通过 npm 包xscraper-mcp运行。结果默认是每条帖子或每个账号一行，并带上下一次调用需要的 ID；需要全部字段时，请求response_format: detailed。

x_search_tweets
用 X 的运算符搜索帖子，按最新或互动最多排序。搜索推文 6–14 个 token
x_search_users
按名字或简介查找账号。搜索用户 4–6 个 token
x_get_user
一个账号的资料，可选带上它最近的帖子或回复。按用户名获取资料 1 个 token用户推文 3–7 个 token最新一条推文 1 个 token
x_get_tweet
按 ID 或链接获取一条帖子，以及一页回复或引用。按 ID 获取推文 1 个 token推文的回复 4 个 token引用转推 4 个 token
x_get_followers
一个账号的粉丝，或它正在关注的人。粉丝 4 个 token正在关注 4 个 token
x_get_user_likes
一个账号点赞过的帖子。点赞的推文 4–8 个 token
x_get_list_tweets
一个 X 列表里的帖子。列表推文 3–7 个 token
x_get_trends
当前的趋势。趋势 2 个 token
x_get_balance
这把密钥还剩多少 token。Token 余额 0 个 token

连接客户端

在控制台里创建密钥，然后把服务器加到你的客户端。

在终端里运行一次。服务器会加到你的用户下；用 --scope project 可以通过 .mcp.json 共享给项目。

Claude Code
claude mcp add --transport http xscraper \
  https://mcp.xscraper.online/mcp \
  --header "x-api-key: $XSCRAPER_API_KEY"

技能

Agent Skills 是任务匹配时由代理加载的说明。它们遵循开放的 Agent Skills 格式，所以 Claude Code、Codex、Muse Code、Cursor、Copilot 和其他代理都能使用。源码在 GitHub。

xscraper-api
哪个工具回答哪个问题、X 搜索运算符、花费规则，以及给没有 MCP 的代理用的 REST 参考。
x-account-research
一个账号是谁、发什么、互动看起来是否真实，写成一份简短且带来源的简报。
x-topic-research
X 上对一个话题、品牌、发布或代码的说法：主题、抱怨和称赞，并附上链接。
x-thread-digest
一条帖子加上它的回复和引用转推，归纳成论点和值得注意的声音。
x-monitor
按计划观察账号或关键词，每次只搜索一次，并且只报告新帖子。

一次性安装技能和 MCP 服务器。请先在 shell 里设置 XSCRAPER_API_KEY。

Claude Code plugin
/plugin marketplace add ensp1re/xscraper-agent-kit
/plugin install xscraper@xscraper

Claude 应用：从 GitHub 下载技能文件夹，打包成 zip，在设置 → Capabilities → Skills 里上传。

花费与限制

  • 每个工具都列出价格，每条结果都以花掉的 token 和剩余余额结束。
  • x_get_balance 免费。技能会让代理先取一页，并在一项任务可能超过大约 50 个 token 时先问你。
  • 失败的调用会退回，但未找到的结果除外。超时的调用仍可能已扣费，所以代理会在重试前先查看余额。
  • 速率限制与 REST 相同：每把密钥每分钟 100 次请求。