用途：为自主智能体提供 X（Twitter）数据读取与自动化能力，由 AIsa 驱动，一个 API key 即可使用。兼容任何实现 Agent Skills 规范的框架，如 Claude Code、OpenAI Codex、Cursor、Gemini CLI、OpenCode、Goose、OpenClaw、Hermes 等。
主要能力：读取操作无需登录，覆盖用户端点（用户信息、账号详情、按 ID 批量查询、最新推文、提及、粉丝、关注、认证粉丝、关注关系检查、用户搜索）、推文端点（高级搜索，queryType 必填 Latest 或 Top、按 ID 取推文、回复、引用、转发者、线程上下文、文章）、趋势（woeid=1 为全球）、列表成员与关注者、社区信息/成员/版主/推文/全社区搜索、Spaces 详情。
使用方式：需 Python 3、POSIX shell 和 AISA_API_KEY（在 aisa.one 获取）。先执行 export AISA_API_KEY="your-key"，再通过 curl 调用 https://api.aisa.one/apis/v1/twitter/... 端点，或使用 Python 客户端脚本，如 python3 {baseDir}/scripts/twitter_client.py user-info --username elonmusk、search --query "AI agents" --type Top、trends --woeid 1 等。
互动与发布：本文件不直接定义点赞/取消点赞/关注/取消关注逻辑，需按 ./references/engage_twitter.md 处理，且执行前须从 ./references/post_twitter.md 获取 OAuth 授权；发布、回复或引用同样走 ./references/post_twitter.md。互动操作可通过本地中继脚本 twitter_engagement_client.py 执行，如 like-latest、follow-user 等。
适用场景：监控影响者、追踪趋势、社交聆听与情感分析、竞品情报、自动化互动与发布工作流。
限制：读取查询约 $0.0004，采用按量付费，需先注册并充值；认证粉丝端点需 user_id 而非 userName；高级搜索必须指定 queryType；互动与发布依赖 OAuth 授权。其余价格、平台或效果细节暂未提供。