home / skills / openclaw / skills / xpoz-social-search

xpoz-social-search skill

safe

This skill helps you monitor social conversations across Twitter, Instagram, and Reddit in real time, identifying mentions, influencers, and engagement

npx playbooks add skill openclaw/skills --skill xpoz-social-search

Review the files below or copy the command above to add this skill to your agents.

Files (3)

SKILL.md

3.3 KB

---
name: xpoz-social-search
description: "Search Twitter, Instagram, and Reddit posts in real time. Find social media mentions, track hashtags, discover influencers, and analyze engagement — 1.5B+ posts indexed. Social listening, brand monitoring, and competitor research made easy for AI agents."
homepage: https://xpoz.ai
metadata:
  {
    "openclaw":
      {
        "requires": { "bins": ["mcporter"], "skills": ["xpoz-setup"], "network": ["mcp.xpoz.ai"], "credentials": "Xpoz account (free tier) — auth via xpoz-setup skill (OAuth 2.1)" },
        "install": [{"id": "node", "kind": "node", "package": "mcporter", "bins": ["mcporter"], "label": "Install mcporter (npm)"}],
      },
  }
tags:
  - social-media
  - search
  - twitter
  - instagram
  - reddit
  - mcp
  - xpoz
  - research
  - intelligence
  - discovery
  - social-search
  - twitter-search
  - social-listening
  - brand-monitoring
  - hashtag
  - mentions
  - influencer
  - engagement
  - viral
  - trending
---

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

Overview

This skill enables real-time search across Twitter (X), Instagram, and Reddit with a 1.5B+ post index for social listening, brand monitoring, and competitor research. It exposes targeted tools to find posts, profiles, subreddits, and export large result sets. The skill returns an operationId for searches, so you poll status to retrieve results or CSV exports. Built for agents that need fast discovery of mentions, hashtags, influencers, and engagement signals.

How this skill works

You call platform-specific search tools with parameters like query, startDate/endDate, limit, and fields. Each search returns an operationId; use checkOperationStatus to poll until the operation completes and then fetch results or a CSV dataDumpExportOperationId for large exports. Support includes keyword and boolean queries, user lookups by identifier, and subreddit discovery for Reddit.

When to use it

Monitor brand mentions or campaign hashtags across multiple platforms in near real time.
Perform competitive research to surface competitor posts, account activity, and audience conversations.
Discover and vet influencers or creators by keyword and profile signals.
Analyze community discussions by finding subreddits and Reddit users relevant to a topic.
Export large datasets (CSV) for downstream analytics or reporting workflows.

Best practices

Always call checkOperationStatus and poll (every ~5s) — searches return operationId, not immediate data.
Use fields to request only required fields for faster responses and lower cost.
Use boolean operators (AND, OR, NOT, quotes, parentheses) to refine queries and reduce noise.
Limit date ranges for high-volume topics to keep result sets manageable.
Use CSV export via dataDumpExportOperationId for large-scale exports (up to 64K rows).

Example use cases

Track a product launch hashtag across Twitter and Instagram for early sentiment signals.
Compile a CSV of recent posts mentioning a competitor for a weekly marketing report.
Search Instagram users by niche keywords to build an influencer outreach list.
Locate active subreddits discussing a startup idea and extract top contributors for research.
Pull a timeline of a public figure's posts by username for archival or compliance review.

FAQ

Why do searches return an operationId instead of immediate results?

Searches are asynchronous to handle large queries and indexing; poll checkOperationStatus to know when results or CSV exports are available.

How do I limit returned data for performance?

Specify the fields parameter to request only needed attributes and set sensible date ranges and limits.