xpoz-social-search

What This Skill Does

xpoz-social-search is a powerful OpenClaw AI agent capability designed to bridge the gap between real-time social media data and autonomous analysis. By indexing over 1.5 billion posts across Twitter, Instagram, and Reddit, this skill enables agents to perform sophisticated social listening, brand monitoring, and competitive intelligence gathering. Unlike static data sources, this skill provides live, queryable access to public conversations, allowing your agent to track hashtags, identify influencers, explore specific subreddits, and pull granular user profiles. It is built upon the robust Xpoz MCP framework, ensuring high-fidelity data retrieval across disparate social platforms.

Installation

To integrate this capability into your OpenClaw environment, execute the following command via the terminal: clawhub install openclaw/skills/skills/atyachin/xpoz-social-search

Post-installation, you must initialize the service using the setup skill: mcporter call xpoz-setup

Verify your authentication status before running any search queries by calling: mcporter call xpoz.checkAccessKeyStatus

Use Cases

• Brand Reputation Monitoring: Automatically detect mentions of your brand across social channels and analyze sentiment or context to trigger agent alerts.
• Market Research & Competitive Intelligence: Track competitor mentions or product launches in real-time. Use boolean operators to filter out noise (e.g., "CompetitorName NOT stock") to focus on product-specific sentiment.
• Influencer Discovery: Identify key opinion leaders in specific niches by searching user profiles based on bio keywords and activity.
• Community Engagement: Discover relevant Reddit subreddits or active Twitter/Instagram conversations to align your brand messaging with current trends.

Example Prompts

1. "Check for any mentions of 'OpenClaw' on Twitter from the last week and summarize the common complaints or questions users have."
2. "Find the top 5 fitness influencers on Instagram whose bios mention 'sustainability' and 'transformation'."
3. "Identify the most active Reddit subreddits discussing 'artificial intelligence' and pull a list of the recent top-performing threads."

Tips & Limitations

• Asynchronous Workflow: Always remember that search commands return an operationId. You must poll checkOperationStatus using that ID to retrieve the final dataset. Do not assume data is returned in the initial response.
• Performance: Use the fields parameter to minimize payload size and improve agent performance. For bulk data, leverage the dataDumpExportOperationId to generate a CSV download for up to 64,000 rows.
• Date Formatting: Ensure all date filters adhere to the YYYY-MM-DD format.
• Usage Limits: The free tier is restricted to 100 searches per month with a maximum of 1,000 results per individual search. Monitor your usage via the xpoz.ai dashboard.