核心用法
xint是一款面向终端的X/Twitter情报分析CLI工具，采用TypeScript构建，通过Bun运行时执行。核心工作流围绕search命令展开，支持复杂查询语法（布尔运算符、时间范围、互动量过滤），并可通过管道串联实现从数据采集到AI分析的全流程自动化。工具设计遵循Unix哲学，输出格式涵盖JSON/JSONL/CSV/Markdown，便于与jq、tee等标准工具链集成。
关键命令模块包括：
- 情报采集：
search（支持--quick快速模式、--sentiment情感分析）、profile/thread/tweet（单点深度挖掘）、article（全文抓取，利用Grok绕过付费墙） - 实时监控：
watch（轮询新推文，支持webhook推送）、diff（粉丝变动追踪，需OAuth） - AI增强：
analyze（Grok智能分析）、report（自动生成情报报告）、sentiment（逐条情感评分） - 用户操作：
bookmarks/likes/following（需OAuth，支持同步至Obsidian知识库）
Agentic研究循环是核心设计模式：将研究问题分解为3-5个定向查询→执行搜索并评估信号质量→追踪高互动线程→深度抓取链接内容→Grok综合总结→按主题结构化输出。
显著优点
技术架构优势：纯TypeScript实现，仅依赖@modelcontextprotocol/sdk，供应链攻击面极小；支持MCP协议，可作为Claude等Agent的外部工具集；Bun运行时提供亚秒级冷启动。
成本控制精细：内置API成本追踪（data/api-costs.json），支持按日预算硬限制（默认$1/日），每次调用显示预估费用（X API约$0.005/推文，Grok按token计费）。
输出工程友好：JSONL格式专为Unix管道设计（xint search "AI" --jsonl | jq 'select(.metrics.likes > 100)'），Markdown报告可直接嵌入Obsidian/Notion，CSV导出支持Excel透视分析。
隐私与安全设计：OAuth Token以600权限存储；Webhook强制HTTPS（本地回环除外）；支持只读策略模式（--policy read_only）防止误操作；搜索自动附加-is:retweet减少噪音。
AI原生集成：深度整合xAI Grok API，支持文章全文抓取（绕过X的280字限制）、情感分析、智能摘要，且可切换grok-4/grok-3-mini等模型平衡成本与质量。
潜在缺点与局限性
来源可信度约束：维护者为个人开发者（0xNyk/T3级别），无企业SLA保障，需自行审计代码更新。curl|bash安装模式虽支持SHA256校验，但仍属供应链风险点。
API依赖与成本门槛：X API v2为付费服务（基础套餐$100/月起），xAI API需另行计费。免费层级限制严格（如搜索仅限最近7天），深度历史研究需Full-archive搜索（$0.01/推文）。
功能边界明确：不支持发推、DM、企业级功能（如广告API）；OAuth配置流程对非技术用户存在门槛；Obsidian同步需本地vault路径硬编码，跨设备同步需额外配置。
数据时效性限制：缓存TTL固定15分钟，watch命令为轮询非真流式，最小间隔30秒，高并发场景可能遗漏推文。
平台政策风险：X API服务条款频繁变更，2023年后多次收紧数据访问权限，长期可用性存疑。
适合的目标群体
- 市场情报分析师：追踪竞品动态、行业热点、KOL观点，利用
report生成可溯源简报 - 学术研究/数字人文研究者：采集社交媒体话语数据，JSONL格式便于导入Python/R分析
- 量化交易者/加密研究员：实时监控币种讨论热度、情绪拐点（
watch+sentiment组合） - 技术布道者与PM：跟踪技术发布反响、开发者社区反馈，同步至Obsidian构建知识库
- 开源情报(OSINT)从业者：
diff追踪目标账号社交图谱变化，reposts分析传播路径
使用风险
凭证泄露风险：X_BEARER_TOKEN和XAI_API_KEY为高价值凭证，误提交至GitHub或暴露于共享环境将导致API滥用。建议采用direnv等工具隔离项目级.env。
意外费用风险：虽设每日预算，但Webhook自动推送或长时间watch运行仍可能累积费用。生产环境建议设置硬配额告警。
数据合规风险：抓取用户数据需遵守GDPR/CCPA及X Developer Agreement，商用场景需法律审查。导出的JSON可能包含可识别个人信息(PII)。
依赖稳定性风险：X API v2存在非向后兼容变更历史；xAI API为新兴服务，定价与可用性可能调整。
Webhook注入风险：若未配置XINT_WEBHOOK_ALLOWED_HOSTS白名单，攻击者可能诱导用户向恶意端点推送数据。