XPOZ Social Intelligence - Claude Code Plugin
Real-time social media analysis for Claude Code, powered by XPOZ MCP
🚀 Quick Install
# Add the XPOZ marketplace
/plugin marketplace add XPOZpublic/xpoz-claude-code-plugins
# Install the plugin
/plugin install xpoz-social-intelligence@xpoz-marketplace
XPOZ Social Intelligence brings real-time social media analysis to Claude Code. Analyze data from Twitter/X and Instagram to uncover sentiment, discover influencers, and generate competitive insights.
Four specialized skills for brand analysis and prediction market intelligence, with data from Twitter/X, Reddit, and Instagram.
Features
Brand Intelligence Skills
| Skill | Command | Description |
|---|
| Brand Snapshot | /brand-snapshot [BRAND] | Deep-dive analysis with sentiment, narratives, SWOT, and influencers |
| Brand Competition | /brand-competition [BRAND] | Compare brand vs competitors: share of voice, sentiment, positioning |
| Brand Influencers | /brand-influencers [BRAND] | Discover influencers by tier, partnership opportunities, rising stars |
| Polymarket Analyzer | /polymarket-analyzer [URL or keyword] | Prediction market event analysis with social sentiment gap detection |
What You Get
- Real Data: Fetches actual posts from Twitter/X, Reddit, and Instagram via XPOZ MCP
- Sentiment Analysis: Classifies posts as positive/neutral/negative
- Narrative Extraction: Identifies 5+ recurring themes in brand conversation
- SWOT Analysis: Auto-generates strengths, weaknesses, opportunities, threats
- Influencer Discovery: Classifies by tier (Mega/Macro/Micro/Nano) and voice type
- Prediction Market Intelligence: Compares Polymarket odds against real social sentiment
- Beautiful Reports: Generates standalone HTML reports with dark theme
Example Reports
View live examples directly in your browser:
| Report | View | Description |
|---|
| Tesla Brand Snapshot | Live Preview | Sentiment analysis, narratives, SWOT, influencers |
| Tesla Competition | Live Preview | Tesla vs Rivian, BYD, Lucid - share of voice, positioning |
| Tesla Influencers | Live Preview | Influencer discovery, partnership opportunities |
| US Recession 2026 | Live Preview | Binary event: market odds vs social sentiment |
| FIFA World Cup Winner | Live Preview | Multi-choice event: candidate field analysis |
| GOP Nominee 2028 | Live Preview | Multi-choice event: political prediction market |
Quick Start
Step 1: Set Up Your XPOZ Account (Required First!)
Before installing the skills, you need to configure XPOZ to collect data for your topics of interest:
- Sign up for free at xpoz.ai - click "Start Free"
- Go to Settings: Navigate to xpoz.ai/settings
- Define your keywords: This is crucial! XPOZ needs to know which topics to monitor. Add keywords for:
- Brand names you want to analyze (e.g., "Tesla", "NVIDIA", "Apple")
- Ticker symbols (e.g., "$TSLA", "$NVDA", "$AAPL")
- Industry terms relevant to your analysis
- Get your API Key: Scroll to the bottom of the settings page to find your API key
Important: XPOZ collects social posts based on your defined keywords. If you don't configure keywords for a topic, there won't be data available for analysis. Set up your keywords first, then allow some time for data collection before running reports.
Step 2: Install the Skills
Option 1: Clone Repository (Recommended)
git clone https://github.com/XPOZpublic/xpoz-claude-code-plugins.git
cd xpoz-claude-code-plugins
./install.sh
Option 2: Manual Install
- Copy skills to Claude Code:
# Create skills directory if it doesn't exist
mkdir -p ~/.claude/skills
# Copy the skill folders
cp -r skills/brand-snapshot ~/.claude/skills/
cp -r skills/brand-competition ~/.claude/skills/
cp -r skills/brand-influencers ~/.claude/skills/
cp -r skills/polymarket-analyzer ~/.claude/skills/
- Configure XPOZ MCP Server:
Add to your Claude Code MCP configuration (~/.claude.json):
{
"mcpServers": {
"xpoz-mcp": {
"url": "https://mcp.xpoz.ai/mcp",
"transport": "http-stream",
"headers": {
"Authorization": "Bearer YOUR_XPOZ_API_KEY"
}
}
}
}
Replace YOUR_XPOZ_API_KEY with the API key from xpoz.ai/settings.
- Verify installation:
# In Claude Code, check if skills are loaded
/skills
You should see:
brand-snapshotbrand-competitionbrand-influencerspolymarket-analyzer
Usage
Brand Snapshot
Comprehensive single-brand analysis:
/brand-snapshot NVIDIA
Output includes:
- Sentiment score (0-100)
- 5 key narratives with sentiment indicators
- SWOT analysis
- Top influencers with voice type classification
- Key quotes from Twitter
Brand Competition
Compare brand against competitors:
/brand-competition Tesla
Output includes:
- Share of voice pie chart
- Sentiment comparison across companies
- Competitive positioning analysis
- Cross-company influencer identification
Brand Influencers
Discover partnership opportunities:
/brand-influencers Apple
Output includes:
- Influencer tier distribution (Mega/Macro/Micro/Nano)
- Voice type classification (analyst, trader, news, official, etc.)
- Partnership scores (0-100)
- Rising stars detection
- Critical voices monitoring
Polymarket Analyzer
Analyze prediction market events with social intelligence:
/polymarket-analyzer https://polymarket.com/event/bitcoin-150k
Or search by keyword:
/polymarket-analyzer "FIFA World Cup winner"
Output includes:
- Market snapshot (odds, volume, liquidity)
- Candidate field with market vs social bars (multi-choice events)
- Sentiment gap analysis (market odds vs social consensus)
- Top voices (YES/NO camps)
- Conversation catalysts
- Risk/opportunity signal
Supports:
- Binary events (YES/NO) — e.g., "Will BTC hit $150K?"
- Multi-choice events — e.g., "2026 FIFA World Cup Winner" (top 6 candidates)
Configuration Options
Query Expansion
The skills automatically expand brand names to include ticker symbols:
| Brand | Expanded Query |
|---|
| NVIDIA | "NVIDIA" OR "$NVDA" |
| Tesla | "Tesla" OR "$TSLA" |
| Apple | "Apple" OR "$AAPL" |
| Microsoft | "Microsoft" OR "$MSFT" |
Date Range
Default: Last 7 days. The skills use the current date to calculate the date range automatically.
Troubleshooting
"No results found"
This usually means XPOZ hasn't collected data for your keywords yet:
- Go to xpoz.ai/settings
- Verify your keywords are configured correctly
- Allow time for data collection (new keywords may take a few hours to start populating)
"MCP server not found"
Ensure the XPOZ MCP server is configured in your Claude Code settings:
# Check MCP configuration
claude mcp list
"Operation timeout"
The XPOZ API uses async operations. If a query times out:
- Try a more specific query
- Reduce the date range
- Check your API key is valid at xpoz.ai/settings
API Reference
XPOZ MCP Tools Used
| Tool | Purpose |
|---|
getTwitterPostsByKeywords | Fetch tweets matching brand/event query |
getTwitterUsersByKeywords | Fetch users discussing brand |
getRedditPostsByKeywords | Fetch Reddit posts matching query |
getInstagramPostsByKeywords | Fetch Instagram posts matching query |
countTweets | Count tweet volume for a keyword |
checkOperationStatus | Poll for async operation results |
Pricing
- Free: 100,000 results/month
- Pro: $20/month for 1M results
- Max: $200/month for 10M results
See xpoz.ai for current pricing.
License
MIT License - see LICENSE for details.
Support
Powered by XPOZ Social Intelligence - Real-time social media analysis for AI applications.
