用途:为智能体提供 X(Twitter)数据访问与自动化能力,由 AIsa 提供,使用单一 API Key。
主要能力:读取操作无需登录,支持用户资料、账号所在地与验证信息、批量按 ID 查用户、最近推文、提及、粉丝、关注、验证粉丝、关注关系检查、按关键词搜索用户;推文高级搜索(Latest/Top)、按 ID 取推文、回复、引用、转发者、线程上下文、文章;趋势(woeid=1 为全球);列表成员与关注者;社区信息、成员、版主、社区推文、跨社区搜索;Space 详情。
使用方式:需先在 aisa.one 注册获取 API Key,充值后设置环境变量 export AISA_API_KEY="your-key"。可用 curl 调用 REST 端点,如 curl "https://api.aisa.one/apis/v1/twitter/user/info?userName=elonmusk" -H "Authorization: Bearer $AISA_API_KEY";也可用 python3 scripts/twitter_client.py 命令行,例如 user-info --username elonmusk、search --query "AI agents" --type Top、trends --woeid 1、thread --tweet-id 等。
适用场景:监控影响者最新推文、跟踪全球趋势、社交聆听与情感分析、竞品动态提醒、发帖工作流的数据支撑。
限制:本文件不定义发布逻辑;若需发送、发布、回复或引用推文,需参考 ./references/post_twitter.md。verifiedFollowers 需 user_id 而非 userName;advanced_search 必须指定 queryType。计费为按量付费,Twitter 读取查询约 $0.0004,每次响应含 usage.cost 与 usage.credits_remaining;完整端点文档见 API Reference。