AIsa Twitter 帖子互动

通过 AIsa 中继服务搜索 X/Twitter 用户资料、推文、热门趋势，以及执行已批准的互动操作。

适用场景

• 用户需要开展 Twitter/X 研究，并同时执行发帖、点赞、取消点赞、关注或取关等操作流程。
• 任务可使用 Python 客户端，且已配置 AISA_API_KEY 环境变量并完成显式 OAuth 授权。
• 工作流需依赖单一软件包，覆盖读取、发帖及互动操作全部能力。

不适用场景

• 用户需要提取 Cookie、密码登录，或部署完全本地化的 Twitter 客户端。
• 工作流必须避免基于中继的网络请求，或禁止通过 api.aisa.one 上传媒体文件。
• 任务依赖未公开文档说明的密钥或浏览器生成的身份认证值。

快速参考

• 必需环境变量：AISA_API_KEY
• 读取客户端：scripts/twitter_client.py
• 发帖客户端：scripts/twitter_oauth_client.py
• 互动客户端：scripts/twitter_engagement_client.py
• 参考文档：references/post_twitter.md、references/engage_twitter.md

初始化配置

export AISA_API_KEY="your-key"

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

功能能力

• 读取用户、推文、热门趋势、列表、社群（Communities）和 Spaces 数据。
• 在完成显式 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"
python3 scripts/twitter_engagement_client.py like-latest --user "@elonmusk"
python3 scripts/twitter_engagement_client.py follow-user --user "@elonmusk"

工作流说明

• 发帖、回复、转发（quote）及媒体上传操作，请参阅 references/post_twitter.md。
• 点赞、取消点赞、关注与取关操作，请参阅 references/engage_twitter.md。
• 所有写入类操作（write action）前，必须先完成 OAuth 授权。

安全约束

• 不得索取密码、浏览器 Cookie 或任何未公开文档说明的密钥。
• 当存在多个候选目标账号或推文 ID 时，不得擅自猜测具体对象。
• 除非中继服务返回明确的成功响应，否则不得声称互动或发帖操作已成功执行。