Xpoz Claude Code Plugins

XPOZ Social Intelligence - Claude Code Plugin

[](https://github.com/XPOZpublic/xpoz-claude-code-plugins) [](LICENSE) [](https://xpoz.ai)

> 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

🔗 View Live Examples

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:

1. Sign up for free at xpoz.ai - click "Start Free"
2. Go to Settings: Navigate to xpoz.ai/settings
3. 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

1. 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

1. 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/

1. 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.

1. Verify installation:

# In Claude Code, check if skills are loaded
/skills

You should see:

• brand-snapshot
• brand-competition
• brand-influencers
• polymarket-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:

1. Go to xpoz.ai/settings
2. Verify your keywords are configured correctly
3. 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:

1. Try a more specific query
2. Reduce the date range
3. 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](LICENSE) for details.

Support

• XPOZ Settings: xpoz.ai/settings
• Issues: GitHub Issues

---

Powered by XPOZ Social Intelligence - Real-time social media analysis for AI applications.

Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: XPOZpublic
• Source: XPOZpublic/xpoz-claude-code-plugins
• License: MIT

Install and usage instructions live in the source repository linked above.