competitive-intel

# Competitive Intelligence ## Overview Compare multiple brands or products side by side across Twitter/X, Reddit, and Instagram. Measure share of voice, compare sentiment, identify positioning differences, and discover competitive advantages from real social conversations. ## When to Use Activate when the user asks: - "Compare [BRAND A] vs [BRAND B] on social media" - "Share of voice: [BRAND] vs competitors" - "Competitive analysis for [PRODUCT]" - "How does [BRAND A] sentiment compare to [BRAND B]?" - "What are people saying about [BRAND] vs [COMPETITOR]?" ## Setup & Authentication Before fetching data, ensure Xpoz access is configured. Follow these checks in order. ### Check 1: Already authenticated? **If you have MCP tools**, try calling any Xpoz tool (e.g., `checkAccessKeyStatus`). If it works → skip to Step 1. **If you have the SDK**, try: ```python from xpoz import XpozClient client = XpozClient() # reads XPOZ_API_KEY env var ``` If this succeeds without error → skip to Step 1. If neither works, you need to authenticate. Get a free access key (below). --- ### Recommended: a free access key Real analyses need a real key: [get a free access key](https://xpoz.ai/get-token) (free tier, up to 75K results, no credit card). SDK and CLI users set it as `XPOZ_API_KEY`; MCP connections sign in with the same account via OAuth on first tool call (paths below). --- ### Path A: MCP via mcporter (OpenClaw agents) If `mcporter` is available: ```bash mcporter call xpoz...