sales-skills/sales-kwatch

KWatch.io 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 keyword monitoring (choosing keywords, platforms, filters)
   • B) Reducing noise / too many irrelevant alerts
   • C) Configuring notifications (email, Slack, webhooks)
   • D) Using the API to manage alerts programmatically
   • E) Conversation tracking (monitoring specific threads)
   • F) AI sentiment analysis setup or accuracy
   • G) Plan limits and upgrade decision
   • H) Something else — describe it

2. Which plan are you on?

   • A) Free (2 Reddit/HN keywords, email only, no AI)
   • B) Essential ($19/mo — 20 Reddit/HN, 2 X/YouTube, 1 FB/LinkedIn, AI sentiment)
   • C) Business ($79/mo — 100 Reddit/HN, API/webhooks/Slack, bulk import, team management)
   • D) Enterprise ($199/mo — 500 Reddit/HN, advanced support)
   • E) Not sure / haven't signed up yet

3. What's your goal?

   • A) Brand monitoring (track mentions of my product)
   • B) Lead generation (find people asking for solutions)
   • C) Competitor monitoring
   • D) Customer research / market trends

If the user's request already provides context, skip to Step 2.

Step 2 — Route or answer directly

• Social listening strategy or tool comparison → /sales-social-listening [question]
• Reddit monitoring with AI comment generation → /sales-keymentions [question]
• Reddit monitoring with competitive intelligence → /sales-threadlytics [question]
• Developer-first monitoring with MCP server → /sales-octolens [question]
• Community monitoring across 15+ platforms with API → /sales-syften [question]
• Free Reddit monitoring with most keywords → /sales-f5bot [question]
• Cheapest Reddit-only alerts → /sales-redditmentions [question]

Otherwise, answer directly from the platform reference below.

Step 3 — KWatch platform reference

Read references/platform-guide.md for the full platform reference — capabilities, pricing, data model, API endpoints, webhook payload, integration recipes, and code examples.

Answer the user's question using only the relevant section. Don't dump the full reference.

Step 4 — Actionable guidance

Focus on the user's specific situation:

1. Noise reduction — use excluded_keywords to remove false positives, restrict to specific subreddits with included_subreddits, enable whole_words_only, use case_sensitive for acronyms
2. Quota management — monitor monthly_count per alert via API, disable low-value alerts, consolidate overlapping keywords
3. Integration — API and webhooks require Business plan ($79/mo). For cheaper API access, consider Syften (API at EUR 39.95/mo) or RedShip (API at $19/mo) or F5Bot (API at $58.33/mo)
4. LinkedIn coverage — KWatch is one of the few budget tools monitoring LinkedIn posts ($19/mo vs Meltwater/Brandwatch enterprise pricing)

If you discover a gotcha 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 pricing that may change.

• API, webhooks, AND Slack are all Business-only ($79/mo). They share one feature row on the pricing page and unlock together at Business — Free and Essential users have no programmatic access and no Slack. Essential ($19/mo) only adds AI sentiment analysis and filtering over Free. If you need API access at a lower price, F5Bot Ultra ($58.33/mo), Syften (EUR 39.95/mo), or RedShip ($19/mo) all offer REST APIs.
• No dashboard or feed view. KWatch is alerts-only — there is no mention feed, timeline, or analytics dashboard. You see mentions only when they arrive via email, Slack, or webhook.
• LinkedIn monitors posts only, not comments. You will miss conversations happening in comment threads under LinkedIn posts.
• Free plan is severely limited. Only 2 Reddit/HN keywords with no AI analysis, no Slack, and no webhook support. Useful for testing, not production monitoring.
• No Instagram or TikTok coverage. If you need visual platform monitoring, consider YouScan or Buzzabout.
• Keyword alerts match up to 3 independent words that must ALL appear. This is an AND match, not OR. For OR matching, create separate alerts per keyword.
• Email alerts truncate large content. Use Slack or API webhooks to receive full mention content without truncation.
• Bulk import requires Business plan. Essential users must add keywords one by one.

Related skills

• /sales-social-listening — Social listening strategy across all platforms — tool comparison, monitoring setup, competitive intel, crisis detection
• /sales-syften — Syften platform help — fast community monitoring across 15+ platforms with API/webhooks
• /sales-f5bot — F5Bot — free Reddit/HN/Lobsters keyword monitoring, 200 free keywords, REST API + webhooks (Ultra)
• /sales-redditmentions — RedditMentions — cheapest paid Reddit monitoring at EUR 4.49/mo
• /sales-octolens — Octolens — developer-first social listening with API/MCP on all plans
• /sales-brand24 — Brand24 — affordable social listening with Storm Alerts and MCP server
• /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 multi-platform brand monitoring on Essential

User says: "I want to monitor my SaaS product name across Reddit, LinkedIn, and X — I'm on the Essential plan" Skill does:

1. Reads platform guide for keyword strategy and platform quotas
2. Creates keyword alerts: product name on Reddit (uses 1 of 20 slots), X (1 of 2), LinkedIn (1 of 1)
3. Adds competitor names on Reddit with remaining quota
4. Sets excluded_keywords for common false positive words
5. Notes that Slack and webhooks are Business-only — on Essential, alerts arrive by email; recommend upgrading to Business ($79/mo) if real-time Slack/team notifications are needed Result: Multi-platform monitoring set up within Essential plan limits (email alerts only)

Example 2: Push KWatch alerts to a CRM via API webhook

User says: "How do I automatically send KWatch mentions to my Notion database?" Skill does:

1. Confirms Business plan required for webhooks
2. Reads API reference for webhook payload format
3. Shows webhook setup: set api_webhook_url on each alert via API or dashboard
4. Provides example payload with platform, query, content, sentiment, link fields
5. Suggests using a middleware (Make/n8n) to receive the webhook POST and write to Notion Result: Working webhook pipeline from KWatch to Notion

Example 3: Too many irrelevant Reddit alerts

User says: "I'm tracking 'CRM' on KWatch but getting flooded with irrelevant mentions from gaming subreddits" Skill does:

1. Explains that single common words generate high volume
2. Suggests multi-word keywords: "best CRM for", "CRM recommendation", "looking for CRM"
3. Adds excluded_subreddits for gaming/unrelated communities
4. Enables whole_words_only to avoid partial matches
5. Adds excluded_keywords for recurring false positives like "game", "mod" Result: Noise reduced, relevant mentions surfaced

Troubleshooting

Alerts not arriving

Symptom: Set up keywords but no alerts received via email or Slack Cause: No matches yet (KWatch only sends alerts when matches occur), keyword is too specific, or email going to spam Solution: Test with a very common keyword temporarily to confirm alerts work. Check spam/promotions folder for email alerts. If using Slack, verify the webhook URL is correct and the channel exists. Check that the alert is enabled (enabled: true).

Keyword quota filling up too fast

Symptom: Hit the 20 Reddit/HN keyword limit on Essential and still need to track more terms Cause: Monitoring too many variations separately or tracking competitors individually Solution: Consolidate keywords — KWatch matches up to 3 words per alert that must ALL appear. Use broader terms with excluded_keywords to filter noise instead of creating narrow separate alerts. If legitimately need more, upgrade to Business (100 Reddit/HN keywords).

Webhook not receiving payloads

Symptom: API webhook URL configured but your endpoint never receives POST requests Cause: Endpoint returning non-2xx, SSL issues, or per-alert webhook overriding global webhook Solution: Verify endpoint accepts POST with JSON body and returns 200. Check if you have both a global webhook and per-alert webhook set — per-alert takes priority. Test with a simple endpoint (webhook.site) first. Ensure you're on Business plan or above (webhooks are plan-gated).