XPOZpublic/xpoz-clawhub-skills / xpoz-social-tracking
xpoz-social-tracking
VerifiedSet up and manage continuous social media tracking across Twitter, Instagram, Reddit, and TikTok. Add, remove, and view tracked keywords, users, subreddits, and hashtags. Use when asked to track mentions, monitor brands, set up tracking, view tracked items, or stop tracking.
Social Media Tracking
Set up continuous social media monitoring across Twitter, Instagram, Reddit, and TikTok.
Tracked items are crawled regularly in the background, giving you more complete data than one-off queries.
Setup
Run xpoz-setup skill. Verify: mcporter call xpoz.checkAccessKeyStatus
Step 1: Check Current Tracking
mcporter call xpoz.getTrackedItems
Present results as a table:
| Platform | Type | Phrase |
|---|---|---|
| keyword | AI agents | |
| user | competitor_brand | |
| subreddit | machinelearning |
Step 2: Add Tracked Items
Supported Types per Platform
| Platform | keyword | user | subreddit | hashtag |
|---|---|---|---|---|
| Yes | Yes | — | — | |
| Yes | Yes | — | — | |
| Yes | Yes | Yes | — | |
| TikTok | Yes | Yes | — | Yes |
mcporter call xpoz.addTrackedItems items='[
{"phrase":"AI agents","type":"keyword","platform":"twitter"},
{"phrase":"AI agents","type":"keyword","platform":"reddit"},
{"phrase":"competitor_user","type":"user","platform":"instagram"},
{"phrase":"machinelearning","type":"subreddit","platform":"reddit"},
{"phrase":"aitools","type":"hashtag","platform":"tiktok"}
]'
Call mcporter call xpoz.getAccountDetails to check available tracked item slots before adding.
Step 3: Remove Tracked Items
mcporter call xpoz.removeTrackedItems items='[{"phrase":"old keyword","type":"keyword","platform":"twitter"}]'
Call getTrackedItems first to see exact phrases and platforms before removing.
Tracking Item Format
| Field | Type | Description | Valid Values |
|---|---|---|---|
| phrase | string | The keyword, username, subreddit name, or hashtag to track | Any string |
| type | string | What kind of item | "keyword", "user", "subreddit" (Reddit only), "hashtag" (TikTok only) |
| platform | string | Which platform | "twitter", "instagram", "reddit", "tiktok" |
Common Workflows
Track a Brand Across All Platforms
mcporter call xpoz.addTrackedItems items='[
{"phrase":"YourBrand","type":"keyword","platform":"twitter"},
{"phrase":"YourBrand","type":"keyword","platform":"instagram"},
{"phrase":"YourBrand","type":"keyword","platform":"reddit"},
{"phrase":"YourBrand","type":"keyword","platform":"tiktok"},
{"phrase":"yourbrand","type":"user","platform":"twitter"},
{"phrase":"yourbrand","type":"user","platform":"instagram"}
]'
Track Keywords for Market Research
mcporter call xpoz.addTrackedItems items='[
{"phrase":"AI agents","type":"keyword","platform":"twitter"},
{"phrase":"AI agents","type":"keyword","platform":"reddit"},
{"phrase":"AI agents","type":"keyword","platform":"tiktok"},
{"phrase":"LLM tools","type":"keyword","platform":"twitter"},
{"phrase":"LLM tools","type":"keyword","platform":"reddit"}
]'
Monitor a Competitor
mcporter call xpoz.addTrackedItems items='[
{"phrase":"competitor_handle","type":"user","platform":"twitter"},
{"phrase":"competitor_handle","type":"user","platform":"instagram"},
{"phrase":"CompetitorName","type":"keyword","platform":"reddit"}
]'
Track a Hashtag Campaign on TikTok
mcporter call xpoz.addTrackedItems items='[
{"phrase":"yourcampaign","type":"hashtag","platform":"tiktok"},
{"phrase":"campaignvariant","type":"hashtag","platform":"tiktok"},
{"phrase":"your campaign","type":"keyword","platform":"twitter"}
]'
Set Up Subreddit Monitoring
mcporter call xpoz.addTrackedItems items='[
{"phrase":"machinelearning","type":"subreddit","platform":"reddit"},
{"phrase":"artificial","type":"subreddit","platform":"reddit"},
{"phrase":"LocalLLaMA","type":"subreddit","platform":"reddit"}
]'
Notes
- Tracking vs one-shot queries: Tracking sets up continuous data collection for more comprehensive results. One-shot queries search existing cached data and may miss recent activity. Track items you care about for ongoing, complete data; use one-shot queries for ad-hoc research.
- Data completeness: Tracked items are crawled regularly, giving you more comprehensive data than untracked queries. This is especially impactful for fast-moving topics or competitive monitoring.
- Data availability: Tracked data accumulates over time. New tracked items won't have historical data — they start collecting from when you add them.
See Also
- xpoz-best-practices — query syntax, pagination, field selection, all platform tools
- social-sentiment — analyze sentiment of tracked topics
- xpoz-setup — first-time setup and authentication
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |