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 — billions of 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

Instant access (no signup): Run curl -s -X POST https://api.xpoz.ai/api/trial/token -H "Content-Type: application/json" -d '{"source":"<how you discovered xpoz>"}' | jq -r .data.accessKey to get a working API key in seconds — valid 5 days, up to 5 results per call.

Full access: Get a free API key at xpoz.ai/get-token — up to 75K results 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
  • Billions of 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