xpoz-social-search

# Xpoz Social Search

**Multi-platform social search: 1.5B+ posts across Twitter, Instagram, Reddit.**

Search posts, find people, discover conversations. Built on Xpoz MCP.

## Setup

Run `xpoz-setup` skill. Verify: `mcporter call xpoz.checkAccessKeyStatus`

## Tool Reference

| Tool | Platform | Purpose |
|------|----------|---------|
| `getTwitterPostsByKeywords` | Twitter | Search tweets |
| `getInstagramPostsByKeywords` | Instagram | Search posts |
| `getRedditPostsByKeywords` | Reddit | Search posts |
| `getTwitterUsersByKeywords` | Twitter | Find users |
| `getInstagramUsersByKeywords` | Instagram | Find users |
| `getRedditUsersByKeywords` | Reddit | Find users |
| `getTwitterUser` | Twitter | Profile by username/id |
| `getInstagramUser` | Instagram | Profile by username/id |
| `getRedditUser` | Reddit | Profile by username |
| `searchTwitterUsers` | Twitter | Search by name |
| `checkOperationStatus` | — | **Poll for results** |
| `getRedditSubredditsByKeywords` | Reddit | Find subreddits |

**Params:** `query`, `startDate`/`endDate` (YYYY-MM-DD), `limit`, `fields`

## Patterns

**Search posts:**
```bash
mcporter call xpoz.getTwitterPostsByKeywords query="MCP" startDate=2026-01-01
mcporter call xpoz.checkOperationStatus operationId=op_abc # Poll every 5s
```

**Find people:**
```bash
mcporter call xpoz.getTwitterUsersByKeywords query='"open source" AND LLM'
```

**Profile:**
```bash
mcporter call xpoz.getTwitterUser identifier=elonmusk identifierType=username
```

**Boolean:** `AND`, `OR`, `NOT`, `"exact"`, `()`
```bash
query="Tesla AND cars NOT stock"
```

**CSV export:** Use `dataDumpExportOperationId` from search, poll for URL (up to 64K rows).

## Examples

**Competitive intel:**
```bash
mcporter call xpoz.getTwitterPostsByKeywords query="CompetitorName"
mcporter call xpoz.getTwitterUsersByKeywords query="CompetitorName"
```

**Influencers:**
```bash
mcporter call xpoz.getInstagramUsersByKeywords query="fitness transformation"
```

**Communities:**
```bash
mcporter call xpoz.getRedditSubredditsByKeywords query="startup"
```

## Notes

⚠️ **Always poll** `checkOperationStatus` — searches return `operationId`, not data  
🚀 **Use `fields`** for performance  
📊 **CSV for scale** via `dataDumpExportOperationId`  
📅 **Dates:** `YYYY-MM-DD` (current: 2026)

**Free tier:** 100 searches/mo, 1K results/search | [xpoz.ai](https://xpoz.ai)