best-practiceslisted
Install: claude install-skill XPOZpublic/xpoz-claude-code-plugin
# Xpoz Best Practices
## Overview
Xpoz is a social media intelligence platform providing access to **Twitter/X**, **Instagram**, **Reddit**, and **TikTok** data through 48 MCP tools — 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)
- Setting up authentication or tracking
- Troubleshooting errors or empty results
- Choosing which tool to use for a specific task
## Quick Start
The Xpoz MCP server should already be configured by the plugin. If not, run `/xpoz:getting-started`.
See **[references/authentication.md](references/authentication.md)** for detailed auth flows and troubleshooting.
## Query Syntax
All keyword search tools support boolean query syntax:
| Operator | Example | Effect |
|----------|---------|--------|
| Exact phrase | `"machine learning"` | Matches exact phrase |
| OR | `"AI" OR "artificial intelligence"` | Matches either term |
| AND | `"Tesla" AND "earnings"` | Matches both terms |
| Grouping | `("deep learning" OR "neural network") AND python` | Combines operators |
**Date filtering:** Use `startDate` / `endDate` in YYYY-MM-DD format. Omit to use defaults (varies by tool).
**Content filtering** (Twitter only): Set `filterOutRetweets: true` to exclude retweets.
**Forbidden in query string:** `from:`, `