xpoz-getting-started

Configure Xpoz authentication, verify accounts, and set up social media tracking.

15|3|Updated Feb 23, 2026
One-click install
npx skills add https://github.com/XPOZpublic/xpoz-agent-skills --skill xpoz-getting-started-xpozpublic
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: xpoz-getting-started
Source: https://github.com/XPOZpublic/xpoz-agent-skills/tree/main/skills/xpoz-getting-started
Command: npx skills add https://github.com/XPOZpublic/xpoz-agent-skills --skill xpoz-getting-started-xpozpublic

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? New users of the Xpoz social media intelligence platform often don't know how to authenticate, verify their account, or which integration path (MCP, SDK, CLI) fits their setup. This Skill walks through onboarding end to end so agents can access Twitter/X, Instagram, Reddit, and TikTok data. ## Core Features & Use Cases - Guided Authentication: Set up access keys and OAuth across MCP clients, Python SDK, TypeScript SDK, and CLI, with troubleshooting for common auth errors. - Account Verification: Check access key status and retrieve plan, billing, and usage details via getAccountDetails. - Tracking Setup: Add tracked keywords, users, subreddits, and hashtags per platform for continuous data coverage. - Skill Routing: Direct users to the right specialized skill (sentiment analysis, influencer discovery, data export, and more) based on their goal. - Use Case: A user says "I'm new to Xpoz, where do I start?" The agent detects no credentials, walks them through getting a free access key, verifies the account, and sets up brand keyword tracking on Twitter and Reddit. ## Quick Start Ask your agent to help you set up Xpoz and check your account status, then follow the prompts to connect an access key and add your first tracked keywords.

Frequently Asked Questions about xpoz-getting-started

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I set up Xpoz with Claude Code or another MCP client?

Add the Xpoz MCP server URL https://mcp.xpoz.ai/mcp to your agent's config with streamable-http transport. Most MCP clients handle OAuth automatically on the first tool call, and you can verify setup by calling checkAccessKeyStatus.

How do I get an Xpoz API key for the Python or TypeScript SDK?

Get a free access key at xpoz.ai/get-token, which includes up to 75K results with no credit card. Pass the key to the XpozClient constructor or set it as the XPOZ_API_KEY environment variable.

What social media platforms does Xpoz support?

Xpoz provides access to Twitter/X, Instagram, Reddit, and TikTok data without requiring social media API keys. Capabilities include user lookup, post search by keywords, comments, followers, and hashtag search depending on the platform.

Why am I getting an Unauthorized or AuthenticationError with Xpoz?

For MCP, re-run the OAuth flow to refresh authorization. For SDKs, verify your key at xpoz.ai/settings. Token exchange codes are single-use, so ask the user to re-authorize if the exchange fails.

What are tracked items in Xpoz and why should I set them up?

Tracked items are keywords, users, subreddits, or hashtags that Xpoz crawls regularly, giving search results better coverage than one-off queries. You add them with addTrackedItems and can check available slots via getAccountDetails.