核心用法
xint 是一款面向终端的X/Twitter情报分析工具，通过X API v2和xAI Grok实现从基础搜索到深度研究的完整工作流：
基础搜索：search 命令支持高级查询语法（from:、url:、布尔运算）、时间过滤（--since）、互动量阈值（--min-likes）及多维排序。自动排除转推，内置15分钟缓存和成本估算。
深度研究：article 提取推文链接的全文内容；thread 展开完整对话；analyze 通过Grok对搜索结果进行AI主题分析和情感判断；report 一键生成结构化情报报告。
实时监控：watch 轮询监控话题或账号，支持Webhook推送和JSONL管道输出；diff 追踪关注者变化快照。
数据管理：支持书签/点赞读写、趋势查看、关注列表导出，输出格式覆盖JSON/JSONL/CSV/Markdown。
显著优点
- 成本透明：每笔调用实时计费，支持日预算上限（默认$1），数据写入
data/api-costs.json - 管道友好：
--jsonl输出专为Unix管道设计，可无缝衔接jq、tee等工具 - AI原生：集成xAI Grok实现情感分析、文章摘要、智能报告生成
- 安全设计：OAuth token以600权限存储，Webhook强制HTTPS（远程），支持域名白名单
- 研究闭环：从问题分解→多查询搜索→线程追踪→原文抓取→AI合成→Markdown报告的完整agentic流程
局限与风险
- 认证门槛：需自行申请X API v2 Bearer Token（基础搜索）和xAI API Key（AI功能），OAuth功能需额外配置
- 付费API：X API v2为按量计费（约$0.005/推文读取），高频使用成本累积显著
- 数据权限：书签、点赞、关注者追踪等读写功能需用户OAuth授权，无法匿名使用
- 平台依赖：X API政策变动可能影响功能可用性；Grok分析质量受模型限制
适合人群
- 开发者/研究员：需要程序化获取Twitter数据、监控技术话题或行业动态
- 社区运营：追踪账号增长、分析竞品动态、导出互动数据
- 内容创作者：快速收集热点素材、生成带源引用的情报简报
- 数据分析师：通过JSONL/CSV导出进行下游处理
常规风险
| 场景 | 风险 | 缓解措施 |
|------|------|----------|
| 密钥泄露 | `X_BEARER_TOKEN`、`XAI_API_KEY`泄露导致API滥用 | 仅通过环境变量或`.env`注入，避免硬编码 |
| 预算超支 | 高频搜索或大量分页导致意外费用 | 设置`costs budget set <N>`，监控`costs`命令 |
| 隐私泄露 | 导出文件或Webhook传输含敏感搜索词 | 审查`data/exports/`内容，配置`XINT_WEBHOOK_ALLOWED_HOSTS` |
| OAuth令牌被盗 | `data/oauth-tokens.json`权限不当 | 自动`chmod 600`，定期`auth refresh` |
| MCP暴露 | `--sse`模式开启 unintended 入站服务 | 默认stdio模式，显式启用SSE时配置`--policy` |