# Xpoz Agent Skills

> Agent skills for social media intelligence, powered by Xpoz. Compatible with Claude Code, Codex CLI, and ChatGPT.

- **Type:** MCP server
- **Install:** `agentstack add mcp-xpozpublic-xpoz-agent-skills`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [XPOZpublic](https://agentstack.voostack.com/s/xpozpublic)
- **Installs:** 0
- **Category:** [Integrations](https://agentstack.voostack.com/c/integrations)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [XPOZpublic](https://github.com/XPOZpublic)
- **Source:** https://github.com/XPOZpublic/xpoz-agent-skills

## Install

```sh
agentstack add mcp-xpozpublic-xpoz-agent-skills
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# Xpoz Agent Skills

Agent skills for social media intelligence, powered by [Xpoz](https://xpoz.ai?utm_source=github&utm_medium=agent-skills&utm_campaign=readme). 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](https://github.com/anthropics/skills) standard.

## 🧠 Skills

| Skill | Description | Use When |
|-------|-------------|----------|
| [social-sentiment-analyzer](skills/social-sentiment-analyzer/) | Analyze brand/topic sentiment across Twitter, Reddit & Instagram | "What's the sentiment around Tesla?" |
| [twitter-data-export](skills/twitter-data-export/) | Export Twitter search results to CSV (up to 500K rows) | "Export tweets about AI from last month" |
| [influencer-discovery](skills/influencer-discovery/) | Find and rank influencers by niche, engagement & authenticity | "Find top crypto influencers on Twitter" |
| [reddit-research](skills/reddit-research/) | Search and analyze Reddit discussions for market research | "What are people saying about Cursor on Reddit?" |
| [competitive-intel](skills/competitive-intel/) | Compare brands: share of voice, sentiment & positioning | "Compare Slack vs Discord vs Teams sentiment" |
| [security-osint](skills/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":""}' | 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](https://xpoz.ai/get-token?utm_source=github&utm_medium=agent-skills&utm_campaign=readme) — 100,000 results/month free, no credit card required.

### Install Skills

```bash
# 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`:

```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):
```bash
mcporter config add xpoz https://mcp.xpoz.ai/mcp --auth oauth
mcporter config login xpoz
```

#### Option B: Python SDK (recommended for coding tasks)

```bash
pip install xpoz
export XPOZ_API_KEY=your-api-key
```

#### Option C: TypeScript SDK

```bash
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](LICENSE).

## 🔗 Links

- **Xpoz Platform**: [xpoz.ai](https://xpoz.ai?utm_source=github&utm_medium=agent-skills&utm_campaign=readme)
- **Get API Key**: [xpoz.ai/get-token](https://xpoz.ai/get-token?utm_source=github&utm_medium=agent-skills&utm_campaign=readme)
- **Python SDK**: [github.com/XPOZpublic/xpoz-python-sdk](https://github.com/XPOZpublic/xpoz-python-sdk)
- **TypeScript SDK**: [github.com/XPOZpublic/xpoz-ts-sdk](https://github.com/XPOZpublic/xpoz-ts-sdk)
- **MCP Server**: [github.com/XPOZpublic/xpoz-mcp](https://github.com/XPOZpublic/xpoz-mcp)

## 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](https://github.com/XPOZpublic)
- **Source:** [XPOZpublic/xpoz-agent-skills](https://github.com/XPOZpublic/xpoz-agent-skills)
- **License:** MIT

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

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** yes
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-xpozpublic-xpoz-agent-skills
- Seller: https://agentstack.voostack.com/s/xpozpublic
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.