xint-rs_skill

Overview

This skill is a fast, zero-dependency CLI for searching, monitoring, and analyzing X/Twitter from the terminal. It combines raw API search, real-time watch polling, and optional xAI-powered analysis to produce pipe-friendly JSON/CSV/markdown outputs. Use it for lightweight research, follower diffs, trends, and automated intelligence reports without a heavyweight UI.

How this skill works

The CLI queries X using a bearer token and can optionally use xAI keys for AI analysis, article extraction, and x_search. Commands stream results to stdout and can export to data/exports/ as JSON, JSONL, CSV, or markdown. Watch mode polls at set intervals and can POST new items to webhooks; OAuth flows enable bookmarks, likes, and follower snapshots.

When to use it

• You want quick command-line searches: "x search" or "search twitter for" queries.
• You need continuous monitoring: use "watch" to poll keywords or accounts and push to webhooks.
• You want AI summaries or sentiment: run "analyze" or include --sentiment with search when XAI_API_KEY is available.
• You need intelligence reports: use "report" to generate summarized findings and save to exports.
• You want follower tracking: use "diff" for snapshots and historical comparisons.
• You need trending topics or location-based trends: run "trends" for quick discovery.

Best practices

• Store X_BEARER_TOKEN and XAI_API_KEY in environment or a .env file; never commit credentials to repos.
• Review exports in data/exports/ before sharing; they may contain sensitive queries or account data.
• Use --jsonl for machine pipelines and --json for programmatic analysis; CSV for spreadsheets and --markdown for human reports.
• Limit watch polling intervals and set costs budgets to avoid unexpected API charges.
• Prefer webhooks you control (own server, Slack/Discord workspace) when using --webhook.

Example use cases

• Rapid research: xint search "AI agents" --limit 50 --json -> pipe into analysis or a notebook.
• Real-time monitoring: xint watch "brand name" -i 5m --webhook https://your.server/notify to capture mentions.
• Intelligence report: xint report "competitor" -s --save to produce an AI-summarized briefing and export.
• Follower auditing: xint diff @username --history to detect follower/following changes over time.
• Content extraction: xint article "https://x.com/user/status/123" --ai "Summarize key points" to fetch linked articles and analyze.