Xpoz Social Search

atyachin/xpoz-social-search

Installation

clawhub install atyachin/xpoz-social-search

Summary

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

SKILL.md

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

ToolPlatformPurpose
getTwitterPostsByKeywordsTwitterSearch tweets
getInstagramPostsByKeywordsInstagramSearch posts
getRedditPostsByKeywordsRedditSearch posts
getTwitterUsersByKeywordsTwitterFind users
getInstagramUsersByKeywordsInstagramFind users
getRedditUsersByKeywordsRedditFind users
getTwitterUserTwitterProfile by username/id
getInstagramUserInstagramProfile by username/id
getRedditUserRedditProfile by username
searchTwitterUsersTwitterSearch by name
checkOperationStatus—Poll for results
getRedditSubredditsByKeywordsRedditFind 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

Recommended skills

Browse all →