getting-startedlisted
Install: claude install-skill XPOZpublic/xpoz-claude-code-plugin
# 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. This plugin connects Claude Code to Xpoz via MCP, giving you 48 tools for searching posts, looking up users, tracking keywords, and exporting data.
## 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: Check MCP Connection
Try calling `checkAccessKeyStatus` to verify the Xpoz MCP server is connected.
If it returns `hasAccessKey: true`, skip to **Step 3**.
## Step 2: Configure MCP Connection
The plugin ships the Xpoz MCP server configuration, so the server appears in Claude Code automatically. Authentication uses OAuth:
1. Tell the user to run `/mcp`, select **xpoz**, and choose **Authenticate**.
2. A browser window opens; the user signs in and authorizes. Accounts are free — no credit card required.
3. Back in Claude Code, retry `checkAccessKeyStatus` to confirm the connection.
### Manual fallback (token-based)
If OAuth is unavailable in the user's environment, they can use an access token instead:
1. Ask the user:
> "Go to https://xpoz.ai/get-token (free, no credit card) and paste the token here."
**WAIT for the user to reply with the token.** Do not proceed until they respon