juicer-brand-mentions

Daily alerts when people mention your brand on Reddit, X and TikTok, plus your hashtags on Instagram, Facebook, LinkedIn and YouTube. Filters out posts that only share the name and sends a short digest to WhatsApp, Slack or Telegram.

Brand mentions with Juicer

Goal: every morning (or on demand) the user gets a short message with the new posts that are really about their brand, with links.

Before the first run

1. Make sure Juicer is connected (see the juicer skill: MCP server with sign-in is best for daily runs).
2. Ask the user, in one message:
   • Brand name and any spellings (e.g. "Juicer", "Juicer.io").
   • Their own handles per network (e.g. X @juicerio, TikTok @juicersocial).
   • Branded hashtags, if any.
   • What the brand does, in a few words (e.g. "social media feed widget for websites"). This is how you tell real mentions from noise.
   • Where to send the digest (this chat, WhatsApp, Slack, Telegram) and what time.
3. Confirm each handle with get_data_profiles before using it. Read the returned display_name, description and url: an exact handle match can belong to someone else (the X account @juicer is an architect, not the company). Only keep handles whose description or website matches the brand.
4. Check credits with get_account and tell the user what one run costs (see below).

Searches per run

Network	Call	Credits
Reddit	get_data_posts term = brand name, term_type: mentions	1
X	get_data_posts term = @handle, term_type: mentions	1
TikTok	get_data_posts term = brand name, term_type: mentions	3
Instagram, Facebook, LinkedIn, YouTube, Bluesky	get_data_posts term = #brandhashtag	3, 6, 3, 1, 1

X mentions work with a handle only, not a free keyword. Instagram, Facebook and LinkedIn have no keyword search: say so once in the first digest so the user is not surprised.

If the brand name is also a common word (Juicer, Apple, Notion), a keyword search on TikTok mostly returns the common meaning. Search the brand's own hashtag on TikTok instead (#brandname, term_type: hashtag), or a phrase that pairs the name with what the brand does.

X mentions can come back as older popular posts rather than the newest ones. Sort what you get by post_created_at. If nothing on the first page is newer than the last run, say "X returned only older posts, so this week's X mentions may be missing" instead of "no mentions on X". Do not keep paging to look for recent ones; it costs credits and rarely helps.

Fetch one page per network per run. Only page further (cursor from meta.platforms[].next_cursor) if the first page is full of relevant posts.

Filter before reporting (the important part)

Keyword search matches the word, not the company. A real test for "juicer.io" on Reddit returned 114 posts and comments; only about 1 in 5 were about the company. The rest were kitchen juicers, Amazon deal lists and vintage ads.

For every post:

1. Drop posts older than the previous run (compare post_created_at). On the first run keep the last 7 days.
2. Drop posts from the brand's own handles; list them separately as "Our posts" only if the user asks.
3. Keep a post only if it is about this brand: it names the company in a way that fits what the brand does, links to its website or tags its handle. When unsure, drop it.
4. Drop duplicates (the same text cross-posted to several subreddits counts once; mention the extra places).
5. Keep a count of what was dropped and why.

Digest format

Short, scannable, plain text that works in WhatsApp:

Template (fill every [ ] from the run, never from this example):

text

[Brand] mentions, [date] (since [last run time])
[N] new · [Network] [n] · [Network] [n]

1. [where, e.g. r/subreddit or @poster] · "[first line of the post]" · [n] comments
   [link]
2. ...

Needs a reply: #[n] ([why: question, complaint])
Skipped [n] posts that were about [what the noise was].
Searched: [each network and term]. Used [n] credits, [n] left.

• Lead with posts that ask a question or complain: those need a human reply.
• Always end with what was searched and what it cost.
• If nothing new: one line, "No new mentions since [time]", plus the searched line. Do not stay silent.

Scheduling

Offer to make it daily with an OpenClaw Automation (scheduled job) that runs this skill at the user's chosen time and delivers to their chosen chat. Remember the last run time so the next digest only shows new posts.

Errors

• 402 insufficient_credits: tell the user the run was skipped, show the checkout link from the error and how many credits a run needs.
• invalid_term on a handle: the account was not found; ask the user to check it, do not guess another one.
• A network timing out: report it in the searched line and carry on with the others.
• Reddit returning fetch_timeout ("Reddit request timed out"): Reddit is slow at times. Retry it once at the end of the run (1 credit). If it fails again, say "Reddit could not be reached, so Reddit is not covered" and never report it as "no mentions on Reddit".