用途:面向 X/Twitter 的研究、监控与内容发现,可通过 AIsa 中继查询用户资料、时间线、提及、粉丝、关注等;支持搜索推文与用户,查看回复、引用、转推者、话题上下文、趋势、列表、社区和 Spaces。发帖方面,在用户明确完成 OAuth 授权后可发布文字、图片和视频内容,未获授权时返回授权链接。
必要用法:先设置环境变量 export AISA_API_KEY="your-key"。读取客户端为 scripts/twitter_client.py,OAuth 与发帖客户端为 scripts/twitter_oauth_client.py,发帖指南见 references/post_twitter.md。所有网络调用指向 https://api.aisa.one/apis/v1/...。
常用命令示例:python3 scripts/twitter_client.py user-info --username elonmusk;python3 scripts/twitter_client.py search --query "AI agents" --type Latest;python3 scripts/twitter_client.py trends --woeid 1;python3 scripts/twitter_oauth_client.py status;python3 scripts/twitter_oauth_client.py authorize;python3 scripts/twitter_oauth_client.py post --text "Hello from AIsa"。--media-file 仅用于用户提供的本地工作区文件。
限制与边界:不支持基于密码的登录、Cookie 提取或浏览器凭据抓取;工作流依赖中继调用 api.aisa.one;不支持本包未涵盖的互动操作。不要索取 Twitter 密码或浏览器 Cookie,不要编造文案、推文链接或附件;在 API 确认成功前不得声称发布成功。该流程基于中继,会向 api.aisa.one 发送 API 请求、OAuth 请求与经批准的媒体上传,所需密钥为 AISA_API_KEY,无需密码或直接共享账号凭据。