用途：这是 starchild-ai-agent 官方技能库中的 Twitter/X 数据技能，以脚本模式运行，对 twitterapi.io 接口提供只读访问，适合处理任何 x.com 或 twitter.com 链接、查询推文与账号信息。Twitter 会拦截爬虫，因此遇到这类 URL 应先用本技能而非网页抓取方式。
主要能力：exports.py 中提供 13 个函数。推文类包括 twitter_search_tweets（高级搜索，支持 from:、to:、#tag、$cashtag、lang:、has:media、has:links、is:reply、min_faves:N、since:、until: 等操作符）、twitter_get_tweets（按 ID 批量取推文）、twitter_tweet_replies、twitter_tweet_retweeters、twitter_tweet_thread_context、twitter_tweet_quote、twitter_get_article（长文正文）、twitter_get_trends（趋势话题）。用户类包括 twitter_user_info（简介、关注与被关注数、推文数、认证状态）、twitter_user_tweets、twitter_user_followers、twitter_user_followings、twitter_search_users。返回值为直接来自 twitterapi.io 的字典，字段随端点而异，建议先查看一次再写脚本。
使用方式：本技能为脚本模式，不注册运行时工具，需读取 SKILL.md 后用 bash 加 python3 调用。典型调用为 import sys、json，将技能目录加入 sys.path，再从 exports 导入函数并调用，例如 twitter_user_info(username="vitalikbuterin") 与 twitter_user_tweets(username="vitalikbuterin")。用户名不带 @；从 URL 提取推文 ID 时取 x.com/{user}/status/{id} 或 twitter.com/{user}/status/{id} 的最后一段，并以字符串传入，避免整数精度丢失。分页时若响应含 next_cursor，下次调用作为 cursor 回传。请求经 sc-proxy 的 core.http_client.proxied_get 转发，TWITTER_API_KEY 由服务端自动注入，本地无需配置密钥。
适用场景：单条推文详情、某账号近期发帖、KOL 发现与 cashtag 提及检索、趋势话题查询、线程与引用分析等。
限制与计费：twitterapi.io 按实际返回条目计费，而非请求数或请求中的 max_results；sc-proxy 按返回条目数乘单价收费（推文 45、资料 54、粉丝 45 积分；10 万积分 1 美元，3 倍上游价），每请求最少 1 条。上游 last_tweets 端点没有页大小参数，每页固定最多返回约 20 条推文并计费，twitter_user_tweets 也不接受该参数，客户端截取不省钱。轮询某账号新推文应改用 twitter_search_tweets 的 advanced_search 方式（如 from:{handle} include:nativeretweets since_time:... until_time:...），无新推文时只计 1 条，成本明显更低；已知 ID 时用 twitter_get_tweets 只付对应推文。粉丝/关注列表默认每页 200 条即按 200 条计费，应控制翻页范围，仅需 ID 图关系时使用批量 followers IDs 端点。错误处理：402 表示代理积分不足，需提示用户充值且不要重试；429 为限流，应告知用户而非自动重试；404 为用户不存在，建议核对用户名拼写。本技能不订阅托管流/webhook 产品，不要使用 /oapi/x_user_stream/* 或 /oapi/tweet_filter/* 端点。版本政策：签名、环境变量或 sc-proxy 契约变更升 MAJOR，新增函数或澄清响应结构升 MINOR，修 bug 或仅文档变更升 PATCH。旧 tools.py 与 init.py 仅为兼容保留，不再是首选入口。