xint-rs

name	xint-rs
description	Fast X Intelligence CLI (Rust) — search, analyze, and engage on X/Twitter from the terminal. Use when: (1) user says "x research", "search x for", "search twitter for", "what are people saying about", "what's twitter saying", "check x for", "x search", "search x", (2) user wants real-time monitoring with "watch", (3) user needs AI-powered analysis with Grok ("analyze", "sentiment"), (4) user needs intelligence reports ("report"), (5) user wants to track followers ("diff"), (6) user needs trending topics ("trends"). Also supports: bookmarks, likes, following (OAuth), x-search, collections, CSV/JSON/JSONL export. Non-goals: Not for posting tweets, not for DMs, not for enterprise features.
credentials	[{"name":"X_BEARER_TOKEN","description":"X API v2 bearer token for search, profile, thread, tweet, trends","required":true},{"name":"XAI_API_KEY","description":"xAI API key for Grok analysis, article fetching, sentiment, x-search, collections","required":false},{"name":"XAI_MANAGEMENT_API_KEY","description":"xAI Management API key for collections management","required":false},{"name":"X_CLIENT_ID","description":"X OAuth 2.0 client ID for user-context operations (bookmarks, likes, following, diff)","required":false}]
required_env_vars	["X_BEARER_TOKEN"]
requiredEnvVars	["X_BEARER_TOKEN"]
primary_credential	X_BEARER_TOKEN
primaryCredential	X_BEARER_TOKEN
security	{"always":false,"autonomous":false,"local_data_dir":"data/","network_endpoints":["https://api.x.com","https://x.com","https://api.x.ai"]}

xint — X Intelligence CLI (Rust)

Fast, zero-dependency binary for X/Twitter search, analysis, and engagement from the terminal. All output goes to stdout (pipe-friendly).

Security Considerations

This skill requires sensitive credentials. Follow these guidelines:

Credentials

• X_BEARER_TOKEN: Required for X API. Treat as a secret - prefer exported environment variables (optional project-local .env)
• XAI_API_KEY: Optional, needed for AI analysis. Also a secret
• X_CLIENT_ID: Optional, needed for OAuth. Less sensitive but don't expose publicly
• XAI_MANAGEMENT_API_KEY: Optional, for collections management

File Writes

• This skill writes to its own data/ directory: cache, exports, snapshots, OAuth tokens
• OAuth tokens stored with restrictive permissions (chmod 600)
• Review exported data before sharing - may contain sensitive search queries

Webhooks

• watch and stream can send data to webhook endpoints
• Remote endpoints must use https:// (http:// is accepted only for localhost/loopback)
• Optional host allowlist: XINT_WEBHOOK_ALLOWED_HOSTS=hooks.example.com,*.internal.example
• Avoid sending sensitive search queries or token-bearing URLs to third-party destinations

Runtime Notes

• This file documents usage and safety controls for the CLI only.
• Network listeners are opt-in (mcp --sse) and disabled by default
• Webhook delivery is opt-in (--webhook) and disabled by default

Installation

• For required tools: prefer OS package managers over curl | bash when possible
• Verify any installer scripts before running

MCP Server (Optional)

• xint mcp starts a local MCP server exposing xint commands as tools
• Default mode is stdio/local integration; no inbound web server unless --sse is explicitly enabled
• Respect --policy read_only|engagement|moderation and budget guardrails

Setup

Requires env vars (in .env or exported):

• — for search, profile, tweet, thread, trends, watch, report