CLI Overview

The Xpoz CLI gives you direct access to social media intelligence from your terminal. Search users, posts, comments, and communities across four platforms — no code required.

Key Features

Dynamic Commands

Commands are auto-generated from the Xpoz Python SDK via reflection. When new tools are added to the platform, they appear in the CLI automatically.

4 Platforms

Twitter/X, Instagram, Reddit, and TikTok — the same coverage as the MCP server and SDKs.

Pagination

Walk through paginated results with --all-pages, or jump to a specific page with --page.

CSV Export

Get a CSV download URL for any search result with --export-csv-url — ideal for bulk data collection.

Cross-Platform Binaries

Native binaries for Linux (x86_64, arm64), macOS (Apple Silicon), and Windows (x86_64). Also available via pip, Homebrew, and winget.

JSON Output

Structured JSON output by default, with a --output pretty option for human-readable formatting.

Quick Example

# Get a Twitter user profile
xpoz-cli twitter get_user --identifier elonmusk

# Search posts with boolean operators
xpoz-cli twitter search_posts --query '"AI" AND ethics' --start-date 2025-01-01 --limit 20

# Export results as CSV
xpoz-cli twitter search_posts --query bitcoin --export-csv-url

How It Works

The CLI wraps the Xpoz Python SDK, which connects to the Xpoz MCP server. Every command maps directly to an MCP tool — twitter search_posts calls the same getTwitterPostsByKeywords tool available through the MCP server and SDKs.

xpoz-cli twitter search_posts --query "AI"
    |
    v
Xpoz Python SDK (xpoz)
    |
    v
Xpoz MCP Server (mcp.xpoz.ai)
    |
    v
Results (JSON / CSV)

Next Steps

Installation

Install via script, Homebrew, pip, winget, or binary download.

Usage

Platforms, global flags, pagination, and examples.

Authentication

Set up your access key and manage auth credentials.

​Key Features