用途：通过本地技能脚本只读访问 twitterapi.io，检索并分页获取 X/Twitter 数据，包括用户资料、推文、回复、引用、线程、提及和搜索。仅用于读取，不应自行扩展发布、点赞、回复或删除等操作。
主要能力：tweet（单条推文）、user（用户）、user-tweets（用户近期推文，可含回复）、replies（回复）、quotes（引用）、thread-context（线程上下文）、mentions（提及）、search（高级搜索，支持 from-user、within-time、queryType、分页及 unix 时间范围）。默认输出紧凑 JSON，仅在需要完整 API 对象时使用 --raw。
使用方式：优先使用技能本地脚本 <skill-path>/scripts/twitterapi-io，无需安装依赖。配置路径为 ~/.config/twitterapi-io/config.json；可用 TWITTERAPI_IO_KEY 覆盖，或运行 <skill-path>/scripts/setup-api-key.sh 保存密钥。配置可存放 agent-secrets 引用，脚本运行时解析；Linux 主机可选用 systemd 加密凭据。不要把真实密钥写入命令行参数。示例：<skill-path>/scripts/twitterapi-io search --query 'AI agents -filter:replies' --from-user OpenAI --within-time 24h --max-tweets 50。
限制与注意：只支持读取。CLI 返回 JSON，应解析而非抓取人类可读文本。使用 auth --api-key 时参数可能出现在 shell 历史与进程列表中，建议改用交互式脚本。.env 仅为可选回退。在添加写入/发帖、登录 Cookie、高成本抓取默认值或更改密钥存储方式前，应先停下来询问。官方端点行为请参考 references/links.md 中的文档链接。以上信息未涉及收费、价格或具体平台支持范围者，资料暂未提供。