核心用法
xint 是一款面向开发者与研究人员的专业级 X/Twitter 情报 CLI 工具，将社交网络数据转化为可操作的洞察。其核心能力围绕搜索-分析-监控-报告四阶段工作流展开：
搜索层：支持高级 X API v2 查询语法（from:、url:、布尔运算符），可按点赞/印象/转发/时间排序，时间粒度精确到分钟。--quick 模式提供秒级结果，--quality 过滤低质内容，--sentiment 调用 Grok AI 逐条情感标注。
深度研究：article 命令通过 xAI 提取推文外链全文，解决 X 平台信息碎片化问题；thread 递归拉取完整对话；analyze 支持将搜索结果管道输入 Grok 进行主题聚合与观点提炼。
实时监控：watch 轮询指定查询，支持 webhook 推送与 JSONL 流式输出，适合追踪产品发布、市场事件或 KOL 动态；diff 追踪账号粉丝变化，需 OAuth 授权。
报告输出：report 整合搜索、情感、AI 摘要生成 Markdown 情报简报；导出格式覆盖 JSON/JSONL/CSV/Markdown，JSONL 设计为 Unix 管道友好。
显著优点
1. 成本透明：每项操作实时显示预估 API 费用（搜索 ~$0.005/条，写入 ~$0.01/次），内置日预算上限（默认 $1）
2. 隐私优先：OAuth token 本地存储（chmod 600），支持纯 Bearer Token 的无状态搜索模式
3. 工程友好：纯 TypeScript/Bun 构建，JSONL 输出原生支持 | jq 管道；MCP Server 可选暴露为工具集
4. AI 原生：深度集成 xAI Grok（非第三方转发），支持文章全文提取、情感分析、智能报告生成
潜在局限
- 写入受限：明确非目标为发推、私信、企业级功能；点赞/收藏/关注需 OAuth 且受 X 平台权限分级限制
- 成本敏感：X API v2 为付费层级，高频监控或大页数搜索易触达预算上限
- 地理/内容盲区：趋势数据依赖官方 API，部分区域可能回退到基于标签频率的启发式估计
- OAuth 复杂度：用户上下文操作（书签、diff）需完成 PKCE 流程，对纯脚本环境不够友好
适合人群
- 技术研究者、产品经理、投资者需追踪社区对新技术/产品的真实反馈
- 开发者调研开源库口碑、API 变更影响、竞品动态
- 分析师构建自动化舆情监控 pipeline（配合
--webhook+ JSONL） - 需要避免网页版干扰、追求可复现研究流程的命令行重度用户
常规风险
| 风险类型 | 说明 | 缓解措施 |
|---------|------|---------|
| API 密钥泄露 | Bearer Token 与 xAI Key 为付费敏感凭证 | 优先环境变量注入，项目级 `.env` 加 gitignore |
| Webhook 数据外泄 | `--webhook` 可能将搜索查询（含敏感词）发送至第三方 | 强制 HTTPS，可选 `XINT_WEBHOOK_ALLOWED_HOSTS` 域名白名单 |
| OAuth token 本地存储 | `data/oauth-tokens.json` 含用户授权凭证 | 文件权限 600，定期 `auth refresh` |
| 出口数据审查不足 | `--save` 导出的报告可能含原始推文敏感内容 | 分享前人工复核 `data/exports/` |
| 预算超支 | 实时成本为估算值，X API 账单延迟 | 设置保守日预算，定期 `costs` 核对 |
生态定位
介于官方 X API 原始接口与高端舆情 SaaS 之间，填补「开发者可负担的专业级社交情报工具」空白——比浏览器插件可规模化，比企业方案轻量且可控。