SuperAPI AI 工具集

twitter

数据与分析

查看项目

更新于 10-16 06:57

技能介绍

用途

该技能用于通过 Twitter API v2 查询 Twitter/X 平台上的公开数据,包括搜索推文、获取用户资料、查询用户时间线以及关注者信息。

主要能力

  • 搜索推文:调用 recent search 端点,可按查询词检索近期推文,并获取推文 ID、文本、创建时间及公开指标等字段。
  • 获取用户资料:通过用户名查询用户信息,可获取用户 ID、名称、用户名、简介及公开指标。
  • 获取用户时间线:通过用户 ID 查询该用户发布的推文,可获取推文 ID、文本、创建时间等字段。
  • 关注者查询:技能描述中提及可获取关注者信息,但资料未提供具体调用示例。

使用方式

需先配置环境变量:

  • TWITTER_BEARER_TOKEN:Bearer token

搜索推文示例:

curl -s -H "Authorization: Bearer $TWITTER_BEARER_TOKEN" \
  "https://api.twitter.com/2/tweets/search/recent?query=SEARCH_QUERY&max_results=10&tweet.fields=created_at,public_metrics" | jq '.data[] | {id, text, created_at, metrics: .public_metrics}'

获取用户资料示例:

curl -s -H "Authorization: Bearer $TWITTER_BEARER_TOKEN" \
  "https://api.twitter.com/2/users/by/username/USERNAME?user.fields=public_metrics,description" | jq '.data | {id, name, username, description, metrics: .public_metrics}'

获取用户时间线示例:

curl -s -H "Authorization: Bearer $TWITTER_BEARER_TOKEN" \
  "https://api.twitter.com/2/users/USER_ID/tweets?max_results=10&tweet.fields=created_at,public_metrics" | jq '.data[] | {id, text, created_at}'

适用场景

适用于需要以编程方式检索 Twitter/X 公开数据的场景,例如查询特定关键词的近期推文、查看某个用户的公开资料或时间线。

限制

  • 各端点存在速率限制,具体请查阅 Twitter API 文档。
  • 该技能为只读模式,使用 bearer token 即可完成查询;如需发布内容,则需要 OAuth 1.0a 用户上下文。
  • 关注者查询的具体调用方式暂未提供。