xpoz-social-search

实时搜索 Twitter、Instagram 和 Reddit 帖子。查找社交媒体提及、跟踪主题标签、发现影响者并分析参与度 - 1.5B+ 帖子已编入索引。社交聆听、品牌监控和竞争对手研究使人工智能代理变得容易。

# 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)

---

## 中文说明

# Xpoz 社交搜索

**多平台社交搜索：横跨 Twitter、Instagram、Reddit 的 15 亿+ 帖子。**

搜索帖子、查找用户、发现对话。基于 Xpoz MCP 构建。

## 设置

运行 `xpoz-setup` 技能。验证：`mcporter call xpoz.checkAccessKeyStatus`

## 工具参考

| 工具 | 平台 | 用途 |
|------|----------|---------|
| `getTwitterPostsByKeywords` | Twitter | 搜索推文 |
| `getInstagramPostsByKeywords` | Instagram | 搜索帖子 |
| `getRedditPostsByKeywords` | Reddit | 搜索帖子 |
| `getTwitterUsersByKeywords` | Twitter | 查找用户 |
| `getInstagramUsersByKeywords` | Instagram | 查找用户 |
| `getRedditUsersByKeywords` | Reddit | 查找用户 |
| `getTwitterUser` | Twitter | 按用户名/id 获取资料 |
| `getInstagramUser` | Instagram | 按用户名/id 获取资料 |
| `getRedditUser` | Reddit | 按用户名获取资料 |
| `searchTwitterUsers` | Twitter | 按姓名搜索 |
| `checkOperationStatus` | — | **轮询结果** |
| `getRedditSubredditsByKeywords` | Reddit | 查找 subreddit |

**参数：** `query`、`startDate`/`endDate`（YYYY-MM-DD）、`limit`、`fields`

## 用法模式

**搜索帖子：**
```bash
mcporter call xpoz.getTwitterPostsByKeywords query="MCP" startDate=2026-01-01
mcporter call xpoz.checkOperationStatus operationId=op_abc # Poll every 5s
```

**查找用户：**
```bash
mcporter call xpoz.getTwitterUsersByKeywords query='"open source" AND LLM'
```

**资料：**
```bash
mcporter call xpoz.getTwitterUser identifier=elonmusk identifierType=username
```

**布尔运算：** `AND`、`OR`、`NOT`、`"exact"`、`()`
```bash
query="Tesla AND cars NOT stock"
```

**CSV 导出：** 使用搜索返回的 `dataDumpExportOperationId`，轮询获取 URL（最多 64K 行）。

## 示例

**竞品情报：**
```bash
mcporter call xpoz.getTwitterPostsByKeywords query="CompetitorName"
mcporter call xpoz.getTwitterUsersByKeywords query="CompetitorName"
```

**影响者：**
```bash
mcporter call xpoz.getInstagramUsersByKeywords query="fitness transformation"
```

**社区：**
```bash
mcporter call xpoz.getRedditSubredditsByKeywords query="startup"
```

## 注意事项

⚠️ **务必轮询** `checkOperationStatus` —— 搜索返回的是 `operationId`，而非数据  
🚀 **使用 `fields`** 以提升性能  
📊 **大规模数据用 CSV** 通过 `dataDumpExportOperationId`  
📅 **日期：** `YYYY-MM-DD`（当前：2026）

**免费层：** 每月 100 次搜索，每次搜索 1K 条结果 | [xpoz.ai](https://xpoz.ai)