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