AIsa Twitter API 命令中心

通过一个由 AIsa 支持的统一命令中心，执行 Twitter/X 上的研究、监控、趋势发现，以及经批准的内容发布任务。

适用场景

• 用户希望使用单一 Twitter/X 技能完成研究、监控或内容发现任务。
• 用户希望查看个人资料、时间线、提及、热门话题、回复、转发引用、列表、社群（Communities）或 Spaces。
• 用户希望在获得明确 OAuth 授权后起草或发布推文，且不共享密码。

不适用场景

• 用户需要基于密码的登录方式、Cookie 提取或浏览器凭据抓取。
• 工作流必须避免通过中继方式调用 api.aisa.one。
• 请求核心操作为点赞、关注、回复或增长类动作——此类操作更适合由 aisa-twitter-engagement-suite 处理。

快速参考

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

配置步骤

export AISA_API_KEY="your-key"

功能能力

• 读取用户数据、时间线、提及、关注者、被关注者及相关的个人资料信息。
• 搜索推文与用户，检查回复、转发引用（quotes）、转发者（retweeters）、推文上下文（thread context）、热门趋势、列表、社群（Communities）和 Spaces。
• 在获得明确 OAuth 授权后，发布纯文本、图片及视频内容。

高意图工作流

• 在撰写前，对某位创作者、竞品或特定叙事开展调研。
• 监控某一关键词、产品上线或自定义观察列表，并快速拉取相关推文。
• 仅在用户明确完成 OAuth 授权后，才起草并发布推文。

常用命令

python3 scripts/twitter_client.py search --query "AI agents" --type Latest
python3 scripts/twitter_oauth_client.py authorize
python3 scripts/twitter_oauth_client.py post --text "Hello from AIsa"

安全守则

• 不得索取 Twitter 密码或浏览器 Cookie。
• 不得虚构配图说明（captions）、推文 URL 或附件文件。
• 除非 API 明确返回成功响应，否则不得声称外部发布已成功执行。

示例请求

• 调研本周 X 平台上开发者关于 AI agents 的讨论内容。
• 跟踪用户对我方产品发布的反馈，并提取具有代表性的推文。
• 构建一个小型竞品账号观察列表，并汇总今日关键变动。
• 完成授权流程后，发布一条附带图片的简短 Twitter 推文。

安全说明

• 该工作流基于中继（relay-based），所有 API 请求、OAuth 请求及经批准的媒体上传均发送至 api.aisa.one。
• 必需密钥：AISA_API_KEY。
• 本工作流无需密码或浏览器 Cookie 提取。