sales-skills/sales-mentionlytics

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.