sales-mentionlytics

What this skill does

# Mentionlytics Platform Help

## Step 1 — Gather context

If `references/learnings.md` exists, read it first for accumulated platform knowledge.

Ask the user:

1. **What do you need help with?**
   - A) Setting up monitoring (keywords, sources, alerts)
   - B) Reducing noise / tightening mention quality
   - C) Competitor tracking / Share of Voice
   - D) Sentiment analysis and brand health
   - E) SIA (Social Intelligence Advisor) recommendations
   - F) API integration or data export
   - G) Reporting (PDF, white-label, email reports)
   - H) Something else — describe it

2. **Which Mentionlytics plan are you on?**
   - A) Basic ($69/mo)
   - B) Essential ($139/mo)
   - C) Advanced ($249/mo)
   - D) Pro ($399/mo — API access)
   - E) Agency ($599/mo)
   - F) Enterprise ($950/mo)
   - G) Free trial / not sure

3. **What are you monitoring?**
   - A) My own brand
   - B) Competitors
   - C) Industry keywords / trends
   - D) Multiple of the above

**If the user's request already provides most of this context, skip directly to Step 2.**

## Step 2 — Route or answer directly

If the request maps to a strategy skill, route:
- Social listening strategy or tool comparison → `/sales-social-listening [question]`
- Influencer discovery → `/sales-influencer-marketing [question]`
- Intent signals from social → `/sales-intent [question]`
- Social media publishing/scheduling → `/sales-social-media-management [question]`

Otherwise, answer directly from the platform reference below.

## Step 3 — Mentionlytics platform reference

**Read `references/platform-guide.md`** for the full platform reference — capabilities, pricing, data model, API details, 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 question:

1. **Monitoring setup** — design keyword strategy, configure sources, set up email alerts
2. **Noise reduction** — audit top mentions, add Boolean exclusions, narrow channel/language/country filters
3. **Competitive intel** — build competitor keyword trackers, configure Share of Voice, track sentiment trends
4. **API/data export** — guide integration using Pro+ API (read-only), Looker Studio, or Hootsuite
5. **Reporting** — configure automated reports, white-label for clients, stakeholder dashboards

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.*

- **API is read-only.** You can pull data out but cannot create keywords, update mentions, or write back. All setup must happen in the dashboard UI.
- **API access requires Pro plan ($399/mo) or higher.** Basic through Advanced plans have no API access. Verify your plan before building integrations.
- **Mentions can take up to 24 hours to appear.** Mentionlytics is not truly real-time for all sources. Web mentions especially can be delayed. Higher plans reportedly get faster scanning.
- **No Zapier or Make integration.** Unlike competitors (Brand24, Mention, Awario), Mentionlytics has no native iPaaS connector. Your only automation options are the REST API (Pro+) or Hootsuite.
- **X/Twitter and LinkedIn data may differ from dashboard.** Platform-imposed API restrictions mean some social mentions accessible in the UI may not appear in API responses.
- **All features are available on all plans.** Unlike competitors that lock sentiment or Boolean behind premium tiers, Mentionlytics gives full features on every plan — the difference is keyword count and mention volume.
- **Bearer tokens expire every hour.** Your integration must handle token refresh automatically or API calls will start failing after 60 minutes.

- **Self-improving**: If you discover something not covered here, append it to `references/learnings.md` with today's date.

## Related skills

- `/sales-social-listening` — Social listening strategy — tool comparison, monitoring setup, sentiment analysis, competitive intelligence, crisis detection
- `/sales-brand24` — Brand24 platform help — affordable alternative with Storm Alerts and MCP server
- `/sales-awario` — Awario platform help — budget social listening with Boolean search and Awario Leads
- `/sales-mention` — Mention platform help — simple affordable monitoring (acquired by Agorapulse)
- `/sales-talkwalker` — Talkwalker platform help — enterprise social listening with image recognition
- `/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: Reduce mention noise
**User says**: "I'm getting thousands of irrelevant mentions for my brand name which is a common word"
**Skill does**:
1. Reads platform-guide.md for Boolean query guidance
2. Suggests adding NOT exclusions for common false-positive contexts
3. Recommends using channel, language, and country filters to narrow results
4. Shows how to use the `commtracks` parameter to separate brand vs competitor mentions
**Result**: Refined keyword setup that cuts noise significantly

### Example 2: Pull mention data into a custom dashboard via the API
**User says**: "I want to build a brand health dashboard that shows mention volume and sentiment over time"
**Skill does**:
1. Confirms Pro plan required for API access
2. Walks through Bearer token generation and refresh flow
3. Shows `/api/aggregation` endpoint for sentiment and reach time-series data
4. Provides cURL + Python code for fetching and visualizing data
**Result**: Working API integration feeding a custom dashboard

### Example 3: Set up competitor Share of Voice tracking
**User says**: "I want to compare how often my brand gets mentioned vs three competitors"
**Skill does**:
1. Guides creating separate keyword trackers for each competitor
2. Shows how to use the `commtracks=competitors` filter in the API
3. Configures Share of Voice comparison in the dashboard
4. Sets up weekly email report for stakeholders
**Result**: Competitive monitoring with automated Share of Voice reporting

## Troubleshooting

### Mentions not appearing for known brand conversations
**Symptom**: You see people discussing your brand on social media, but Mentionlytics isn't picking it up
**Cause**: Source coverage gaps (some platforms limit API access), keyword tracking setup too narrow, or 24hr delay hasn't elapsed
**Solution**: Check which channels are enabled for your keyword tracker. Verify exact brand name spelling and variations. Wait 24 hours for web sources. If mentions consistently miss a specific platform, check Mentionlytics' current source coverage for that channel.

### Sentiment analysis marking neutral mentions as negative
**Symptom**: Many mentions flagged negative that are clearly neutral or mixed
**Cause**: Mentionlytics' AI sentiment struggles with sarcasm, industry jargon, and mixed-sentiment posts
**Solution**: Use manual sentiment correction for high-priority mentions. Filter reports by confidence level if available. For reporting, acknowledge ~85% accuracy ceiling and note that manual review is required for borderline cases.

### API token expires and integration stops working
**Symptom**: API calls return 401 Unauthorized after working for about an hour
**Cause**: Bearer tokens expire after 1 hour — integration isn't handling token refresh
**Solution**: Implement automatic token refresh using the Refresh Token endpoint. Store both Bearer and Refresh tokens, check for 401 responses, and automatically request a new Bearer token before retrying the failed request.