AIsa Twitter 命令中心

通过 AIsa 中继服务搜索 X/Twitter 用户资料、推文、趋势、列表、社区和 Spaces，支持经 OAuth 授权后的发布工作流。

适用场景

• 用户需要进行 Twitter/X 的研究、监控或内容发现。
• 用户希望查看用户资料、时间线、提及、趋势、回复、引用、列表、社区或 Spaces 内容。
• 用户希望在明确完成 OAuth 授权后起草或发布推文，无需共享密码。

不适用场景

• 用户需要基于密码的登录、Cookie 提取或浏览器凭证抓取。
• 工作流必须避免通过 api.aisa.one 进行中继调用。
• 请求涉及本模块未覆盖的支持互动操作。

快速参考

• 必需环境变量：AISA_API_KEY
• 读取客户端：scripts/twitter_client.py
• OAuth 与发布客户端：scripts/twitter_oauth_client.py
• 发布指南：references/post_twitter.md

安装配置

export AISA_API_KEY="your-key"

所有网络请求均发送至 https://api.aisa.one/apis/v1/...。

功能特性

• 读取用户数据、时间线、提及、关注者、关注列表及相关资料信息。
• 搜索推文和用户，检查回复、引用、转发者、线程上下文、趋势、列表、社区及 Spaces。
• 在完成 OAuth 授权后，发布纯文本、图片和视频推文。
• 若尚未完成授权，返回 OAuth 授权链接。

常用命令

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"

发布工作流程

当用户要求发送、发布、回复或引用 X/Twitter 内容时：

1. 检查是否已配置 AISA_API_KEY。
2. 若用户意图是发布，尝试执行发布流程。
3. 若授权尚未完成，优先返回 OAuth 授权链接。
4. --media-file 参数仅用于用户提供的本地工作区文件。
5. 不得在发布命令实际成功前声称发布已成功。

安全约束

• 不得索取 Twitter 密码或浏览器 Cookie。
• 不得虚构标题、推文链接或附件文件。
• 除非用户明确要求，否则不得默认打开本地浏览器。
• 不得在 API 确认成功前声称外部发布已成功。

安全说明

• 本流程为中继式设计，将 API 请求、OAuth 请求及已批准的媒体上传发送至 api.aisa.one。
• 所需密钥：AISA_API_KEY。
• 该流程无需密码、浏览器 Cookie 提取或直接账户凭证共享。

参考资料

• 详见 references/post_twitter.md 获取详细的发布示例和 OAuth 指导。