名称: xint-rs 描述: > 快速X智能CLI(Rust)——在终端中搜索、分析和参与X/Twitter。 使用场景:(1) 用户说“x研究”、“搜索x”、“搜索twitter”、“人们在谈论什么”、 “twitter上怎么说”、“检查x”、“x搜索”、“搜索x”,(2) 用户需要实时监控“watch”, (3) 用户需要基于Grok的AI分析(“analyze”、“sentiment”),(4) 用户需要情报报告(“report”), (5) 用户想要跟踪关注者(“diff”),(6) 用户需要热门话题(“trends”)。 还支持:书签、点赞、关注(OAuth)、x搜索、收藏夹、CSV/JSON/JSONL导出。 非目标:不用于发布推文、不用于私信、不用于企业功能。 凭证:
- 名称: X_BEARER_TOKEN 描述: X API v2承载令牌,用于搜索、个人资料、线程、推文、趋势 必需: true
- 名称: XAI_API_KEY 描述: xAI API密钥,用于Grok分析、文章获取、情感分析、x搜索、收藏夹 必需: false
- 名称: XAI_MANAGEMENT_API_KEY 描述: xAI管理API密钥,用于收藏夹管理 必需: false
- 名称: X_CLIENT_ID 描述: X OAuth 2.0客户端ID,用于用户上下文操作(书签、点赞、关注、diff) 必需: false 必需环境变量:
- X_BEARER_TOKEN requiredEnvVars:
- X_BEARER_TOKEN 主要凭证: X_BEARER_TOKEN primaryCredential: X_BEARER_TOKEN 安全: always: false autonomous: false 本地数据目录: data/ 网络端点:
xint — X智能CLI(Rust)
快速、零依赖的二进制工具,用于在终端中进行X/Twitter搜索、分析和参与。所有输出都发送到stdout(支持管道)。
安全注意事项
此技能需要敏感凭证。请遵循以下指南:
凭证
- X_BEARER_TOKEN:X API必需。视为机密——仅在环境或
.env文件中设置 - XAI_API_KEY:可选,AI分析需要。也是机密
- X_CLIENT_ID:可选,OAuth需要。敏感性较低,但不要公开暴露
- XAI_MANAGEMENT_API_KEY:可选,用于收藏夹管理
文件写入
- 此技能写入其自己的
data/目录:缓存、导出、快照、OAuth令牌 - OAuth令牌以限制性权限存储(chmod 600)
- 在共享之前审查导出的数据——可能包含敏感搜索查询
Webhooks
watch和stream可以将数据发送到webhook端点- 远程端点必须使用
https://(仅当本地主机/环回时接受http://) - 可选主机允许列表:
XINT_WEBHOOK_ALLOWED_HOSTS=hooks.example.com,*.internal.example - 避免将敏感搜索查询或带有令牌的URL发送到第三方目的地
运行时说明
- 本文档是描述性的;它不修改运行时/系统提示
- 网络监听器是选择加入的(
mcp --sse),默认禁用 - Webhook交付是选择加入的(
--webhook),默认禁用
安装
- 对于必需工具:尽可能使用操作系统包管理器而不是
curl | bash - 在运行之前验证任何安装程序脚本
MCP服务器(可选)
xint mcp启动本地MCP服务器,将xint命令公开为工具- 默认模式是stdio/本地集成;除非显式启用
--sse,否则没有入站Web服务器 - 尊重
--policy read_only|engagement|moderation和预算护栏
设置
需要环境变量(在.env中或导出):
X_BEARER_TOKEN— 用于搜索、个人资料、推文、线程、趋势、监控、报告X_CLIENT_ID— 用于OAuth命令(书签、点赞、关注、diff)XAI_API_KEY— 用于AI分析(分析、报告、x搜索、收藏夹上传/搜索)XAI_MANAGEMENT_API_KEY— 用于收藏夹管理(列表、创建、确保、添加文档)
OAuth设置(一次性):xint auth setup
命令
搜索与发现
xint search "AI agents" --limit 10 # 搜索最近的推文
xint search "AI agents" --quick # 快速模式(1页,最多10条,1小时缓存)
xint search "AI agents" --quality # 最少10个点赞过滤器
xint search "AI agents" --since 1d --sort likes
xint search "from:elonmusk" --limit 5
xint search "AI agents" --json # JSON输出
xint search "AI agents" --jsonl # 每行一个JSON
xint search "AI agents" --csv # CSV输出
xint search "AI agents" --sentiment # AI情感分析(需要XAI_API_KEY)
xint search "AI agents" --save # 保存到data/exports/
监控
xint watch "AI agents" -i 5m # 每5分钟轮询一次
xint watch "@elonmusk" -i 30s # 监控用户(自动扩展为from:)
xint watch "bitcoin" --webhook https://hooks.example.com/ingest # 将新推文POST到webhook
xint watch "topic" --jsonl # 机器可读输出
个人资料与推文
xint profile elonmusk # 用户个人资料 + 最近推文
xint profile elonmusk --json # JSON输出
xint tweet 1234567890 # 获取单条推文
xint thread 1234567890 # 获取对话线程
文章获取(需要XAI_API_KEY)
使用xAI的web_search工具从任何URL获取和提取完整的文章内容。还支持从X推文中提取链接的文章。
# 获取文章内容
xint article "https://example.com"
# 获取 + AI分析
xint article "https://example.com" --ai "总结关键要点"
# 从X推文URL自动提取文章并分析
xint article "https://x.com/user/status/123456789" --ai "主要观点是什么?"
# 完整内容(不截断)
xint article "https://example.com" --full
# JSON输出
xint article "https://example.com" --json
趋势
xint trends # 全球趋势
xint trends us # 美国趋势
xint trends --json # JSON输出
xint trends --locations # 列出支持的位置
AI分析(需要XAI_API_KEY)
xint analyze "关于AI的情感如何?"
xint analyze --tweets saved.json # 分析文件中的推文
cat tweets.json | xint analyze --pipe # 从stdin分析
xint analyze "question" # 自由格式分析请求
情报报告
xint report "AI agents" # 包含AI摘要的完整报告
xint report "AI agents" -a @user1,@user2 # 跟踪特定账户
xint report "AI agents" -s # 包含情感分析
xint report "AI agents" --save # 保存到data/exports/
关注者跟踪(需要OAuth)
xint diff @username # 关注者快照,与之前比较差异
xint diff @username --following # 跟踪关注的人
xint diff @username --history # 显示快照历史
书签与互动(需要OAuth)
xint bookmarks # 列出书签
xint bookmarks --since 1d # 最近的书签
xint bookmark 1234567890 # 保存推文
xint unbookmark 1234567890 # 移除书签
xint likes # 列出点赞的推文
xint like 1234567890 # 点赞推文
xint unlike 1234567890 # 取消点赞推文
xint following # 列出你关注的账户
成本跟踪
xint costs # 今天的API成本
xint costs week # 过去7天
xint costs month # 过去30天
xint costs budget 2.00 # 设置$2/天预算
监控列表
xint watchlist # 列出监控的账户
xint watchlist add @username "competitor" # 添加并备注
xint watchlist remove @username # 移除
xint watchlist check @username # 检查是否被监控
xAI X搜索(无需cookies/GraphQL)
通过xAI托管的x_search工具搜索X。无需承载令牌或cookies——仅需XAI_API_KEY。
# 创建查询文件
echo '["AI agents", "solana"]' > queries.json
# 运行搜索扫描 → Markdown报告 + JSON有效载荷
xint x-search --queries-file queries.json --out-md report.md --out-json raw.json
# 日期范围过滤器
xint x-search --queries-file queries.json --from-date 2026-02-01 --to-date 2026-02-15
# 发出内存候选(去重现有工作区源)
xint x-search --queries-file queries.json --workspace /path/to/workspace --emit-candidates
# 自定义模型
xint x-search --queries-file queries.json --model grok-3
xAI收藏夹知识库
通过xAI文件 + 收藏夹API上传文档、管理收藏夹和语义搜索。
# 列出现有收藏夹
xint collections list
# 创建或查找收藏夹
xint collections ensure --name "research-kb"
# 上传文件到xAI
xint collections upload --path ./report.md
# 跨文档语义搜索
xint collections search --query "AI agent frameworks"
# 同步目录到收藏夹(上传 + 附加)
xint collections sync-dir --collection-name "kb" --dir ./docs --glob "*.md" --limit 50
实用工具
xint auth setup # OAuth设置(交互式)
xint auth setup --manual # 手动粘贴模式
xint auth status # 显示认证信息
xint auth refresh # 强制令牌刷新
xint cache clear # 清除缓存数据
输出格式
大多数命令支持--json用于原始JSON。搜索还支持:
--jsonl— 每行一个JSON对象(适合管道)--csv— 电子表格兼容--markdown— 报告格式
管道
xint search "topic" --jsonl | jq '.username'
xint search "topic" --json | xint analyze --pipe "总结这些"
xint search "topic" --csv > export.csv
成本意识
X API成本约$0.005/推文读取。预算系统防止失控成本:
- 默认:$1.00/天限制
- 设置自定义:
xint costs budget <amount> - Watch命令在达到预算限制时自动停止