xpoz-getting-started

# Getting Started with Xpoz ## Overview Xpoz is a social media intelligence platform providing access to Twitter/X, Instagram, Reddit, and TikTok data — no social media API keys required. Available via MCP tools, Python SDK, TypeScript SDK, and CLI. ## When to Use Activate when the user asks: - "Help me set up Xpoz" - "What's my Xpoz account status?" - "Connect to Xpoz social media data" - "What can I do with Xpoz?" - "Set up tracking for my brand" - "I'm new to Xpoz, where do I start?" ## Step 1: Choose Your Integration Path | Situation | Path | |-----------|------| | Using an MCP-compatible AI agent (Claude Code, Cursor, Windsurf, etc.) | MCP | | Building a Python application | Python SDK | | Building a TypeScript/Node.js application | TypeScript SDK | | Running from terminal | CLI | **Quick check — already set up?** - MCP: call `checkAccessKeyStatus` — if it returns `hasAccessKey: true`, skip to Step 4 - SDK: try importing `XpozClient` — if no error, skip to Step 4 ## Step 2: Set Up Authentication ### Recommended: a free access key Real results need a real key: [get a free access key](https://xpoz.ai/get-token) (free tier, up to 75K results, no credit card), then follow your integration path (MCP, SDK, or CLI, below). MCP connections sign in with the same account via OAuth on first tool call. ### 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. Examp...