Xpoz Agent Skills

Agent skills for social media intelligence, powered by Xpoz. Give your AI coding agent real-time access to Twitter/X, Instagram, Reddit, and TikTok data — 1.5B+ posts indexed.

Compatible with Claude Code, OpenAI Codex CLI, ChatGPT, and any agent that supports the SKILL.md standard.

🧠 Skills

Skill	Description	Use When
social-sentiment-analyzer	Analyze brand/topic sentiment across Twitter, Reddit & Instagram	"What's the sentiment around Tesla?"
twitter-data-export	Export Twitter search results to CSV (up to 500K rows)	"Export tweets about AI from last month"
influencer-discovery	Find and rank influencers by niche, engagement & authenticity	"Find top crypto influencers on Twitter"
reddit-research	Search and analyze Reddit discussions for market research	"What are people saying about Cursor on Reddit?"
competitive-intel	Compare brands: share of voice, sentiment & positioning	"Compare Slack vs Discord vs Teams sentiment"
security-osint	Monitor social platforms for vulnerability & threat discussions	"Find discussions about Log4j on Twitter and Reddit"

🚀 Quick Setup

Prerequisites

Get a free API key at xpoz.ai/get-token — 100,000 results/month free, no credit card required.

Install Skills

# Clone the repo
git clone https://github.com/XPOZpublic/xpoz-agent-skills.git

# Copy skills to your agent's skills directory
# Claude Code:
cp -r xpoz-agent-skills/skills/* ~/.claude/skills/

# Or install individual skills:
cp -r xpoz-agent-skills/skills/social-sentiment-analyzer ~/.claude/skills/

Configure Xpoz

Each skill supports two integration paths — pick whichever fits your workflow:

Option A: MCP Server (recommended for Claude Code)

Add to your ~/.claude.json:

{
  "mcpServers": {
    "xpoz": {
      "url": "https://mcp.xpoz.ai/mcp",
      "transport": "http-stream"
    }
  }
}

Authentication is handled via OAuth on first use — no API keys needed in the config. Just sign in with your Google account when prompted.

If using mcporter (included with OpenClaw):

mcporter config add xpoz https://mcp.xpoz.ai/mcp --auth oauth
mcporter config login xpoz

Option B: Python SDK (recommended for coding tasks)

pip install xpoz
export XPOZ_API_KEY=your-api-key

Option C: TypeScript SDK

npm install @xpoz/xpoz
export XPOZ_API_KEY=your-api-key

📊 What Xpoz Provides

Multi-platform: Twitter/X, Instagram, Reddit, TikTok
1.5B+ posts indexed and searchable
Natural language queries with boolean operators
CSV exports up to 500K rows in one download
User intelligence: profiles, followers, engagement metrics, authenticity scoring
Real-time + historical: rolling 60-day windows with instant results

📄 License

MIT — see LICENSE.

🔗 Links

Xpoz Platform: xpoz.ai
Get API Key: xpoz.ai/get-token
Python SDK: github.com/XPOZpublic/xpoz-python-sdk
TypeScript SDK: github.com/XPOZpublic/xpoz-ts-sdk
MCP Server: github.com/XPOZpublic/xpoz-mcp