twitterapi-io

使用已安装的 twitterapi-io 命令行工具进行 twitterapi.io 的只读访问。

此技能旨在简化常见的 twitterapi.io 读取操作，降低噪音，避免每次重新构建自定义 API 调用。

快速规则

• - 仅将此技能用于读取操作。
• 不要即兴编写发布/点赞/回复/删除流程。
• 默认情况下优先使用紧凑的 JSON 输出。
• 仅在确实需要完整 API 对象时使用 --raw。
• 验证端点行为时，优先参考 references/links.md 中的官方文档链接。

安装偏好

优先使用已安装的命令行工具，而非硬编码的脚本路径。

推荐安装方式：

bash
pipx install git+https://github.com/ropl-btc/twitterapi-io-cli.git

在仓库检出目录中的备用安装方式：

bash
pip install .

安装后，使用以下命令：

twitterapi-io

命令

显示内置帮助

bash
twitterapi-io help

一次性认证

bash
twitterapi-io auth --api-key YOUR_KEY

也可以使用环境变量：

bash
export TWITTERAPIIOKEY=YOUR_KEY

获取单条推文

bash
twitterapi-io tweet --url https://x.com/jack/status/20

或：

bash
twitterapi-io tweet --id 20

获取单个用户

bash
twitterapi-io user --username OpenAI

获取用户的最新推文

bash
twitterapi-io user-tweets --username OpenAI --limit 10

包含回复：

bash
twitterapi-io user-tweets --username OpenAI --limit 10 --include-replies

获取推文的回复

bash
twitterapi-io replies --url https://x.com/jack/status/20 --limit 20

可选 Unix 时间戳过滤：

bash
twitterapi-io replies --id 20 --since-time 1741219200 --until-time 1741305600 --limit 20

获取引用推文

bash
twitterapi-io quotes --id 20 --limit 20

获取线程上下文

bash
twitterapi-io thread-context --id 20 --limit 40

获取用户的提及

bash
twitterapi-io mentions --username OpenAI --limit 20

高级搜索

bash
twitterapi-io search --query AI agents -filter:replies --from-user OpenAI --within-time 24h --max-tweets 50

需要时使用 Top 结果：

bash
twitterapi-io search --query AI agents --queryType Top --max-pages 2

需要时使用明确的 Unix 时间戳操作符：

bash
twitterapi-io search --query $BTC --since-time 1741219200 --until-time 1741305600 --max-tweets 50

工作流程

1. 1. 如果需要底层官方 twitterapi.io 文档链接，请阅读 references/links.md。
2. 确保已安装 twitterapi-io 命令行工具。
3. 通过 auth 或环境变量确保 API 密钥存在。
4. 根据需要使用 tweet、user、user-tweets、replies、quotes、thread-context、mentions 或 search。
5. 保持读取操作的范围明确且精准。

预期输出

命令行工具返回 JSON。请解析 JSON，而非抓取人类可读文本。

默认输出为紧凑格式，噪音较低。
当确实需要完整端点负载时，使用 --raw。

文件

• - 包仓库：https://github.com/ropl-btc/twitterapi-io-cli
• 兼容性包装器：scripts/twitterapi_io.py
• 官方文档链接：references/links.md
• 配置存储：~/.config/twitterapi-io/config.json

何时停止并询问

在以下情况前请停止并询问：

• - 添加写入/发布功能
• 添加登录 Cookie 流程
• 添加广泛/高成本的抓取默认设置
• 更改 API 密钥存储方式