mcpField
T
twitter-api

twitter-api

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

关于 twitter-api

twitter-api 是供 Agent 获取 Twitter/X 帖子、个人资料、时间线、列表和趋势的数据源技能。它通过 HTTP 和 MCP 接口按次付费提供这些读取操作，无需 X 开发者账号或 OAuth 设置。

主要功能

  1. 01使用 X 运算符搜索推文
  2. 02查询个人资料和用户时间线
  3. 03读取关注者、关注对象和列表
  4. 04获取推文、回复和转推者
  5. 05查询特定国家的趋势

适用场景

  1. 01查找符合关键词或筛选条件的帖子
  2. 02查看账号时间线和关注者
  3. 03检查推文回复及转推者
  4. 04按国家查看热门趋势

MCP 相关

提供 https://twitter.fetcher.sh/mcp MCP 端点，用于发现端点、查询余额和付费获取数据。MCP 客户端可使用 bearer 密钥认证，也可按次通过 x402 付款。

安装

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

$npx skills add https://github.com/fetcher-sh/fetcher-skills --skill twitter-api

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

包含的文件

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

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

详细介绍

Twitter / X API

面向 Agent 的即插即用 Twitter/X 数据源：搜索推文、解析个人资料、获取时间线和关注者、读取列表以及查看趋势——全部通过一次普通 HTTP GET 请求完成，按调用付费。无需开发者账号、应用审核或 OAuth 握手，也无需等待 X 自身的 API 套餐或速率限制审批。如果你的任务涉及 Twitter/X 搜索查询、用户名、推文 ID 或列表 ID，这就是你要用的技能。

基础 URL：https://twitter.fetcher.sh

也以 x-api 发布——使用相同的主机和端点，也以“X”名称编入索引，因为 Agent 和用户会以不同方式称呼这个平台。

快速参考

基础 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
读取 Twitter 列表的推文或成员GET /api/list/{id}/tweets 或 /members
查看某个国家的热门话题GET /api/trends

每个端点的完整参数详情：references/endpoints.md。

身份验证

有两种付费方式，获取相同数据——完整机制请参阅 fetcher 技能：

# 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.005Twitter 列表的成员账号
/api/list/{id}/tweets$0.005Twitter 列表的推文动态
/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"

获取 Twitter 列表的成员和推文：

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": {
    "twitter": {
      "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 skill。

错误

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

参考

评论

支持 Markdown