sales-skills/sales-xpoz
skills/sales-xpoz/SKILL.md
Xpoz platform help — social data API and MCP server for AI agents, searching Twitter/X, Instagram, TikTok, Reddit via natural language queries, 1.5B+ indexed posts, OAuth 2.1, TypeScript/Python SDKs, CSV exports. Use when Xpoz MCP server isn't connecting or authenticating, search results are returning irrelevant posts and you need better queries, CSV exports are timing out or returning incomplete data, you want to build a brand monitoring pipeline using the Xpoz SDK, you're hitting the 100K free tier limit and need to understand upgrade options, or you need to compare Xpoz vs Octolens vs Brand24 for developer-first social listening. Do NOT use for social listening strategy across tools (use /sales-social-listening) or choosing between social listening platforms (use /sales-social-listening).
$ install --global
skillsauthnpx skillsauth add sales-skills/sales sales-xpozInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: May 7, 2026, 2:36 AM126.0s4 files scanned
SKILL.md
- name:
- sales-xpoz
- description:
- Xpoz platform help — social data API and MCP server for AI agents, searching Twitter/X, Instagram, TikTok, Reddit via natural language queries, 1.5B+ indexed posts, OAuth 2.1, TypeScript/Python SDKs, CSV exports. Use when Xpoz MCP server isn't connecting or authenticating, search results are returning irrelevant posts and you need better queries, CSV exports are timing out or returning incomplete data, you want to build a brand monitoring pipeline using the Xpoz SDK, you're hitting the 100K free tier limit and need to understand upgrade options, or you need to compare Xpoz vs Octolens vs Brand24 for developer-first social listening. Do NOT use for social listening strategy across tools (use /sales-social-listening) or choosing between social listening platforms (use /sales-social-listening).
- argument-hint:
- [describe what you need help with in Xpoz — e.g., 'MCP server not connecting' or 'how to search Reddit posts by keyword']
- license:
- MIT
- version:
- 1.0.0
- tags:
- [sales, social-listening, social-data-api, mcp, platform]
- github:
- https://github.com/XPOZpublic
Xpoz Platform Help
Step 1 — Gather context
If references/learnings.md exists, read it first for accumulated platform knowledge.
Ask the user:
-
What do you need help with?
- A) MCP server setup or connection issues
- B) Search queries returning bad results
- C) SDK integration (TypeScript or Python)
- D) CSV exports and async operations
- E) Understanding pricing/limits
- F) Building a monitoring pipeline
- G) Something else — describe it
-
Which access method are you using?
- A) MCP server (Claude Desktop, Cursor, Windsurf, Claude Code)
- B) TypeScript SDK (
@xpoz/xpoz) - C) Python SDK (
xpoz) - D) Haven't started yet
-
Which plan are you on?
- A) Free (100K results/mo)
- B) Pro ($20/mo, 1M results)
- C) Max ($200/mo, 10M results)
- D) Not sure
If the user's request already provides most of this context, skip directly to Step 2.
Step 2 — Route or answer directly
- Social listening strategy or tool comparison →
/sales-social-listening [question] - Brand monitoring setup methodology →
/sales-social-listening [question] - Octolens-specific questions →
/sales-octolens [question] - Brand24 questions →
/sales-brand24 [question] - Influencer discovery →
/sales-influencer-marketing
Otherwise, answer directly from the platform reference below.
Step 3 — Xpoz platform reference
Read references/platform-guide.md for the full platform reference — capabilities, pricing, MCP tools inventory, SDK usage, data model, integration recipes, code examples.
Answer the user's question using only the relevant section. Don't dump the full reference.
Step 4 — Actionable guidance
Based on the user's specific situation:
- MCP setup — verify config JSON, check OAuth flow, test with simple query
- Query optimization — use platform-specific tools, add date filters, limit results
- Pipeline building — choose SDK vs MCP, handle pagination, implement caching
- Exports — use async operations with status polling for large datasets
- Cost management — monitor result counts, use caching to reduce API calls
If you discover a gotcha, workaround, or tip not covered in references/learnings.md, append it there.
Gotchas
Best-effort from research — review these, especially items about plan-gated features and integration gotchas that may be outdated.
- TikTok tools are "coming soon." Don't build pipelines relying on TikTok data from Xpoz yet — it's listed but not fully available.
- No webhooks or push notifications. Xpoz is pull-only (MCP queries or SDK calls). You must poll for new data — there's no way to get notified when new mentions appear.
- Free tier is generous but has no tracked items. The 100K results/month free tier gives 1 tracked item — you can search but can't set up persistent monitoring across multiple brands/keywords without upgrading.
- OAuth requires Google account. MCP authentication uses Google OAuth 2.1 — there's no API key option for MCP connections. SDKs use API keys obtained from xpoz.ai/get-token.
- No Boolean search. Unlike Awario or Brand24, you can't construct complex Boolean queries. Natural language and keyword filters are the query method.
- Results are from indexed data, not real-time. The 1.5B+ post database is continuously updated but there may be a lag between when content is posted and when it appears in Xpoz results. Use
forceLatest: truefor freshest data. - CSV exports are async. Large exports (up to 500K rows) run as background operations — you must poll
checkOperationStatusuntil complete.
Related skills
/sales-social-listening— Social listening strategy — tool comparison, monitoring setup, sentiment analysis, crisis detection, competitive intelligence/sales-octolens— Octolens platform help — developer-first social listening on GitHub, HN, Reddit, X, LinkedIn with MCP server and webhooks/sales-brand24— Brand24 platform help — social listening with MCP server, Storm Alerts, Share of Voice/sales-awario— Awario platform help — budget social listening with Boolean search and Awario Leads/sales-mention— Mention platform help — real-time media monitoring, REST API/sales-do— Not sure which skill to use? The router matches any sales objective to the right skill. Install:npx skills add sales-skills/sales --skill sales-do
Examples
Example 1: Set up MCP server in Claude Code
User says: "How do I connect Xpoz to Claude Code so I can search Twitter mentions?" Skill does:
- Provides the MCP config JSON with streamable-http transport
- Explains OAuth flow — first query triggers Google login
- Shows example natural language query for Twitter mentions
- Lists available Twitter tools (searchTwitterUsers, getTwitterPostsByKeywords, etc.) Result: Working MCP connection with first successful query
Example 2: Build a brand monitoring script with Python SDK
User says: "I want to check Reddit every hour for mentions of my product and send them to Slack" Skill does:
- Shows Python SDK installation and API key setup
- Provides code for Reddit post search with keyword filtering
- Explains pagination and caching to stay within result limits
- Adds Slack webhook integration for notifications Result: Working Python script for Reddit monitoring pipeline
Example 3: Optimize search queries for relevance
User says: "My Xpoz searches return too many irrelevant tweets — how do I filter better?" Skill does:
- Explains available filtering: date ranges, engagement thresholds, language
- Shows how to use specific tools (getTwitterPostsByKeywords vs getTwitterPostsByAuthor)
- Recommends using field selection to reduce noise
- Suggests caching strategy to avoid re-fetching known results Result: Refined query strategy returning relevant results
Troubleshooting
MCP server won't connect
Symptom: Claude Desktop or Cursor shows "connection failed" for Xpoz MCP
Cause: Usually incorrect config format, network issues, or OAuth not completed
Solution: Verify config uses "type": "streamable-http" and URL is exactly https://mcp.xpoz.ai/mcp. On first connection, complete the Google OAuth popup. Check that your firewall/VPN allows outbound HTTPS to mcp.xpoz.ai.
Search returns zero results for known content
Symptom: You know a tweet/post exists but Xpoz returns nothing
Cause: Content may not yet be indexed, or query is too narrow
Solution: Try forceLatest: true to bypass cache. Broaden keyword terms. Check that the platform is supported (TikTok is limited). Xpoz indexes 1.5B+ posts but not every post — very recent or low-engagement content may have indexing delays.
CSV export never completes
Symptom: checkOperationStatus keeps returning "processing" indefinitely
Cause: Export is too large or the operation timed out silently
Solution: Reduce the result set (add date filters, narrow keywords). Exports support up to 500K rows — if your query matches more, add constraints. Try cancelOperation and re-submit with tighter filters. Check your plan's result limit hasn't been exhausted for the month.
Related Skills
sales-skills/sales-upviral
tools
VerifiedTrustedCommunity
UpViral platform help — viral referral marketing and list-building platform (by Emarky) for viral sweepstakes, giveaway/reward campaigns, pre-launch waiting lists, and milestone referral programs, with REST API (app.upviral.com/api/v1/), callback-URL webhooks, PHP SDK, fraud detection (IP-based suspicious-referral flagging), A/B testing, smart leaderboards, unlockable incentives, and 30+ native ESP/CRM integrations (Mailchimp, ActiveCampaign, ConvertKit, AWeber, HubSpot, Klaviyo, Intercom) plus Zapier/Make/Pipedream/Integrately/Pabbly. Use when UpViral campaigns aren't tracking referral points correctly, deciding between Starter $79/mo annual (10K leads, 1 brand, NO API) vs Business $119/mo (25K, 2 brands, API + webhooks unlocked) vs Premium $319/mo (100K, 5 brands, dedicated account manager), the API returns errors because you're on the Starter tier where API/webhooks are gated, building an UpViral→CRM or UpViral→data-warehouse pipeline with add_contact / get_leads / get_leads_points / add_points / get_custom_fields / lists methods (uvapikey + uvmethod form-encoded POST), interpreting fraud flags where same-IP referrals get marked suspicious and you must manually activate/delete/blacklist, setting up the Callback URL (webhook) to fire on reward-unlock events, Zapier New Lead / New Reward Unlocked triggers not firing, ClickFunnels/Shopify/funnel-builder integration breaking, the drag-and-drop page builder showing broken widgets or limited customization, the setup feeling long and complicated for your first campaign, or picking UpViral over Viral Loops / KickoffLabs / Vyper / Prefinery / Gleam / KingSumo / ShortStack for a viral campaign. Do NOT use for general newsletter audience growth strategy across all platforms (use /sales-audience-growth), newsletter monetization (use /sales-newsletter), KickoffLabs-specific help (use /sales-kickofflabs), no-code merge-tag newsletter referrals (use /sales-referralkit), SparkLoop paid recommendations (use /sales-sparkloop), or full-stack multi-level Level-1/2/3 referral/affiliate tracking (use /sales-referralhero).
39SKILL.mdUpdated Jun 4, 2026
sales-skills/sales-referralhero
development
VerifiedTrustedCommunity
ReferralHero platform help — full-stack referral, affiliate, waitlist, contest, and NPS platform with subscriber API, webhooks, Zapier, Mailchimp/Kit/AWeber/Klaviyo/ActiveCampaign/SendLane connectors, coupon codes, multi-level referral tracking (Level 1/2/3), anti-fraud, and 5,000 calls/hour rate limit. Use when ReferralHero campaigns aren't tracking referrals correctly, deciding between PRO $199/mo (10K members, includes API + webhooks) and PREMIUM $399/mo (50K members, adds ReCaptcha + SMS verification), authentication is failing with no_token or X-API-Key header is being ignored, multi-level referral counts (Level 2/3) aren't appearing for downline subscribers, coupon group endpoints return 404 or coupon arrays max out, hitting the 5,000 calls/hour soft limit and getting too_many_calls 429s, the Mailchimp/Kit native integration is double-adding subscribers, webhook payloads aren't firing on confirmation events, importing Stripe customer IDs through transaction tracking, generating reward fulfillment when subscribers cross milestone thresholds (promote/unlock_promoted_reward), comparing ReferralHero against SparkLoop/ReferralKit/Viral Loops/GrowSurf/KickoffLabs for referral marketing, or routing referral data via add_bulk_transactions (500-transaction batch limit). Do NOT use for general newsletter audience growth strategy (use /sales-audience-growth), general newsletter monetization (use /sales-newsletter), no-code newsletter-only referral with merge-tag insertion (use /sales-referralkit), SparkLoop's paid recommendations or partner network (use /sales-sparkloop), or affiliate program strategy across many platforms (use /sales-affiliate-program).
39SKILL.mdUpdated Jun 4, 2026
sales-skills/sales-kickofflabs
tools
VerifiedTrustedCommunity
KickoffLabs platform help — viral marketing platform for pre-launch waitlists, bonus-entry giveaways, milestone-reward referral programs, leaderboard giveaways, and email opt-in bribes with REST API v1 + v2, server-side webhooks (in/out), KOL.js JavaScript library, AnyForm script for custom pages, fraud detection (duplicate_ip / bounced / duplidate_email flags), SMS verification add-on, native ESP integrations (Klaviyo, Mailchimp, ActiveCampaign, Brevo), website builders (Webflow, Wix, Squarespace, Weebly), Shopify, Facebook Audiences, Slack, Zapier. Use when KickoffLabs viral campaigns aren't tracking referrals correctly, deciding between Hobby $13/mo annual (500 leads/mo no A/B no reward emails) vs Premium $48/mo (2.5K + A/B + reward emails + tracking pixels) vs Business $99/mo (10K + custom email templates + custom domains + advanced reporting + 3 team) vs Enterprise $202/mo (25K + 5 team + SMS included), API key getting rejected because you embedded it in client-side JavaScript instead of server-side, can't decide whether to use v1 /subscribe vs v2 /tags/:TAG_ID/lead for lead creation, webhook payloads firing with `__fraudulent` flag and you need to interpret the duplicate_ip/bounced/duplidate_email reason codes (yes, duplidate is spelled that way in their docs), AnyForm script not posting to KickoffLabs vs native API endpoint, leaderboard endpoint returning more than 50 leads is not allowed, social_id (kid in share URLs) attribution chain breaking between v1 and v2, contest score vs lead count metrics in the webhook payload are confusing, SMS Verification only available on Premium+ as $50/mo add-on (Enterprise includes), per-month lead cap auto-upgrades at $8 per 1000 overage leads, picking between KickoffLabs and Viral Loops / UpViral / Prefinery / ReferralCandy / Voucherify for viral campaign type fit, or rate limit per tier (10-100 calls/minute) is hitting on bulk imports. Do NOT use for general newsletter audience growth strategy (use /sales-audience-growth), general newsletter monetization (use /sales-newsletter), no-code merge-tag-only newsletter referrals (use /sales-referralkit), SparkLoop paid recommendations + partner network (use /sales-sparkloop), or full-stack referral/affiliate with multi-level Level-1/2/3 tracking (use /sales-referralhero).
39SKILL.mdUpdated Jun 4, 2026
sales-skills/sales-do
development
VerifiedTrustedCommunity
Routes any sales, marketing, ad, or GTM objective to the right specialized skill and outputs the install command for that skill plus a ready-to-paste prompt packed with the user's context. Asks clarifying questions when the objective is ambiguous, then hands back a copy-paste-runnable next step. Covers prospecting, outbound cadences, deals, proposals, forecasting, deliverability, enrichment, intent, content, coaching, CRO, SEO, launch directories, newsletters, email/SMS/push marketing, chatbots, influencer marketing, social media, employee advocacy, media relations, reviews, data hygiene, B2B advertising, retargeting, affiliate, loyalty, digital products, memberships, webinars, checkout, and platform-specific help. Use when the user has a sales or marketing question and isn't sure which skill to use, or wants a multi-skill sequence with a batch install command. Do NOT use to solve problems directly — this skill only routes.
39SKILL.mdUpdated Apr 24, 2026