xpoz-best-practices

# Xpoz Best Practices ## Overview Xpoz is a social media intelligence platform providing access to **Twitter/X**, **Instagram**, **Reddit**, and **TikTok** data through MCP tools, Python SDK, TypeScript SDK, and CLI — no social media API keys required. ## When to Use Load this skill for **any Xpoz interaction** — not just when the user explicitly asks about best practices. It provides the context needed to use Xpoz tools correctly: - Calling any Xpoz MCP tool (query syntax, field selection, response modes) - Writing code with the Python or TypeScript SDK - Using the Xpoz CLI - Setting up authentication or tracking - Troubleshooting errors or empty results - Choosing which tool to use for a specific task ## Quick Start **MCP** — add the Xpoz MCP server to your agent's config. The server URL is `https://mcp.xpoz.ai/mcp`. Most MCP clients handle OAuth automatically on first tool call. Example for Claude Code (`~/.claude.json`): ```json { "mcpServers": { "xpoz": { "url": "https://mcp.xpoz.ai/mcp", "transport": "streamable-http" } } } ``` **Python SDK:** ```bash pip install xpoz ``` ```python from xpoz import XpozClient client = XpozClient() # reads XPOZ_API_KEY env var results = client.twitter.search_posts("artificial intelligence") print(f"Found {results.pagination.total_rows:,} tweets") client.close() ``` **TypeScript SDK:** ```bash npm install @xpoz/xpoz ``` ```typescript import { XpozClient } from "@xpoz/xpoz"; const client = new XpozClient...