用途
该技能用于通过 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 用户上下文。
- 关注者查询的具体调用方式暂未提供。