mcpField
X
x-scraper

x-scraper

github.com/fetcher-sh数据与数据库23.9k 次安装8 周前更新
代码仓库

关于 x-scraper

为 Agent 提供 X 帖子、个人资料、时间线、关注者、列表和趋势数据的技能，通过付费 HTTP GET 接口访问。支持搜索运算符及多种账户和帖子查询；README 称其无需 X 开发者账户。

主要功能

  1. 01使用 X 运算符搜索帖子
  2. 02搜索账户并解析个人资料
  3. 03获取时间线、回复、关注者及关注对象
  4. 04读取 X 列表的帖子和成员
  5. 05查询帖子、转发者及趋势

适用场景

  1. 01跟踪符合关键词或日期范围的帖子
  2. 02研究账户发帖内容和受众
  3. 03查看 X 列表中的动态
  4. 04按国家/地区查看趋势话题

MCP 相关

通过 https://twitter.fetcher.sh/mcp 连接。MCP 客户端可查看端点信息、检查余额，并使用付费工具访问所列 X 数据接口。

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/fetcher-sh/fetcher-skills --skill x-scraper

安装后在 Claude Code 中输入/x-scraper确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

references/
comparison.md
endpoints.md
faq.md
scenarios.md

详细介绍

X（Twitter）数据 API

面向 Agent 的即插即用 X 数据源：搜索帖子、查询个人资料、获取时间线和关注者、读取列表并查看趋势——每次调用只需发送一个普通 HTTP GET 请求，按调用付费。无需开发者账号、应用审核、OAuth 握手，也无需等待 X 自身的 API 套餐开放或速率限制审批。如果你的任务提到了 X 搜索查询、用户名、帖子 / 推文 ID 或列表 ID，就使用此工具。

Base URL：https://twitter.fetcher.sh——API 主机仍名为 twitter（它早于品牌更名，并与 Agent 已在使用的搜索词一致）；以下内容均为最新的 X 数据。

也以 twitter-scraper 名称发布——端点完全相同，也以“Twitter”名称收录，因为这两个名称至今仍在日常使用中。

快速参考

Base URLhttps://twitter.fetcher.sh
认证Authorization: Bearer bby_live_... 或 x402（USDC）
价格$0.002–$0.005/次调用
端点15 个，全部为 GET
MCPhttps://twitter.fetcher.sh/mcp
机器可读/openapi.json · /llms.txt · /skill.md

我需要哪个端点？

我想要……调用
按关键词或运算符（from:、since:、min_faves: 等）搜索帖子GET /api/search
按名称搜索账号GET /api/search/users
按 @用户名查询个人资料GET /api/handle/{handle}
获取用户的关注者或关注对象GET /api/user/{id}/followers 或 /followings
按 ID 获取单条帖子GET /api/tweet/{id}
查看转发帖子的用户GET /api/tweet/{id}/retweeters
读取 X 列表的帖子或成员GET /api/list/{id}/tweets 或 /members
查看某个国家的热门话题GET /api/trends

每一行的完整参数详情：references/endpoints.md。

认证

有两种支付方式，数据相同——完整机制请参阅 fetcher skill：

# 1. Prepaid credits (recommended — get a key at https://fetcher.sh/topup
#    or via POST /api/credits/topup, see the fetcher skill)
export FETCHER_API_KEY="bby_live_xxxxxxxxxxxx"
curl -H "Authorization: Bearer $FETCHER_API_KEY" \
  "https://twitter.fetcher.sh/api/search?query=hello"

# 2. x402 pay-per-call — omit the header; a GET with no payment returns 402
#    with machine-readable payment requirements (USDC on Base, Polygon,
#    Arbitrum, Monad, or Solana). @x402/fetch signs and retries automatically.

每个响应的格式均为 { "status": number, "message": string, "data": ... }；HTTP 状态码与 status 一致。

端点（15 个——全部为 GET，除特别注明外均为 $0.005/次调用）

端点价格返回内容
/api/search$0.005匹配查询的帖子；支持 X 的高级搜索运算符
/api/search/users$0.005匹配名称 / 关键词查询的账号
/api/handle/{handle}$0.005按 @用户名查询个人资料
/api/handle/{handle}/about$0.005按 @用户名查询扩展个人资料 / 关于信息
/api/user/{id}$0.005按数字用户 ID 查询个人资料
/api/user/{id}/tweets$0.005用户的帖子时间线
/api/user/{id}/replies$0.005用户的回复
/api/user/{id}/followers$0.005用户的关注者
/api/user/{id}/followings$0.005用户关注的账号
/api/tweet/{id}$0.002按 ID 查询单条帖子
/api/tweet/{id}/replies$0.005帖子的回复
/api/tweet/{id}/retweeters$0.005转发帖子的账号
/api/list/{id}/members$0.005X 列表的成员账号
/api/list/{id}/tweets$0.005X 列表的帖子动态
/api/trends$0.005某个国家的热门话题

{id} / {handle} 是路径参数——请替换为实际值。可选查询参数（cursor、sort）用于分页或重新排序；在其他位置出现时，只有 query（搜索）和 country（趋势）是必需参数。

场景

/api/search 上的查询会直接转到 X 自身的搜索，因此其运算符可以直接使用：from:、to:、since:、until:、min_faves:、min_retweets:、filter:、-filter:。

某个账号发布的所有内容：

curl -H "Authorization: Bearer $FETCHER_API_KEY" \
  "https://twitter.fetcher.sh/api/search?query=from%3AOpenAI&sort=Latest"

两个日期之间：

curl -H "Authorization: Bearer $FETCHER_API_KEY" \
  --data-urlencode "query=x402 since:2026-01-01 until:2026-02-01" -G \
  "https://twitter.fetcher.sh/api/search"

仅看热门帖子，排除回复：

curl -H "Authorization: Bearer $FETCHER_API_KEY" \
  --data-urlencode "query=ai agents min_faves:500 -filter:replies" -G \
  --data-urlencode "sort=Top" \
  "https://twitter.fetcher.sh/api/search"

按名称搜索账号：

curl -H "Authorization: Bearer $FETCHER_API_KEY" \
  --data-urlencode "query=climate scientist" -G \
  "https://twitter.fetcher.sh/api/search/users"

按用户名查找个人资料，然后获取其简介/关于信息：

curl -H "Authorization: Bearer $FETCHER_API_KEY" \
  "https://twitter.fetcher.sh/api/handle/nasa"

curl -H "Authorization: Bearer $FETCHER_API_KEY" \
  "https://twitter.fetcher.sh/api/handle/nasa/about"

某用户的帖子、回复、关注者或关注对象（使用上方用户名查询结果中的数字 ID）：

curl -H "Authorization: Bearer $FETCHER_API_KEY" \
  "https://twitter.fetcher.sh/api/user/11348282/tweets"

curl -H "Authorization: Bearer $FETCHER_API_KEY" \
  "https://twitter.fetcher.sh/api/user/11348282/followers"

单条帖子、其回复，以及转发它的用户：

curl -H "Authorization: Bearer $FETCHER_API_KEY" \
  "https://twitter.fetcher.sh/api/tweet/1234567890123456789"

curl -H "Authorization: Bearer $FETCHER_API_KEY" \
  "https://twitter.fetcher.sh/api/tweet/1234567890123456789/replies"

curl -H "Authorization: Bearer $FETCHER_API_KEY" \
  "https://twitter.fetcher.sh/api/tweet/1234567890123456789/retweeters"

X 列表的成员和帖子：

curl -H "Authorization: Bearer $FETCHER_API_KEY" \
  "https://twitter.fetcher.sh/api/list/1234567890/members"

curl -H "Authorization: Bearer $FETCHER_API_KEY" \
  "https://twitter.fetcher.sh/api/list/1234567890/tweets"

某个国家的热门话题：

curl -H "Authorization: Bearer $FETCHER_API_KEY" \
  "https://twitter.fetcher.sh/api/trends?country=United%20States"

MCP

{
  "mcpServers": {
    "x": {
      "url": "https://twitter.fetcher.sh/mcp",
      "headers": { "Authorization": "Bearer bby_live_..." }
    }
  }
}

免费：search_endpoints、describe_endpoint、check_balance。付费： fetch_data（上述任意端点）、topup_credits，以及名为 twitter_search 的快捷工具。移除 headers 块即可通过 x402 按次付费——完整流程请参阅 fetcher 技能。

错误

  • 400 — 缺少或参数无效（消息会指出参数）
  • 401 — 未知密钥或密钥已轮换
  • 402 — 需要付款（x402 挑战）或 topup_required（额度已用尽）
  • 404 — 非计价路径
  • 无速率限制；上游故障不退款（结算先于交付）

参考资料

评论

支持 Markdown