Guides

Build a Grok Bot Template for Social Listening That Finds Buyers

Taras Shynkarenko
Taras Shynkarenko
•Updated: •8 min read
A Grok bot template for social listening across Reddit, X and Hacker NewsA Grok bot template for social listening across Reddit, X and Hacker News

TL;DR

8 min read

Install the RedReplier template at x.ai/bot/8aU6ly_uunnMabpybs3hB, paste an API token, and Grok pulls mentions from Reddit, X, Hacker News, Bluesky and Facebook ranked by AI intent score. Keep approve and reject in human hands, and never let it add keywords on its own, because keywords that fit the plan go live at once.

Running a Grok bot template for social listening changes the shape of the job. Instead of opening a monitoring dashboard, you ask a question and get the mentions that matter. The interesting part is not the convenience. It is deciding which parts of triage an agent should be allowed to touch, and this post is mostly about drawing that line.

The short version: install the RedReplier template from x.ai/bot/8aU6ly_uunnMabpybs3hB, paste a RedReplier API token into the credential field, and ask for today's high-intent mentions. Reads are safe to automate. Approvals, rejections and keyword changes are not.

The RedReplier Grok bot template share page on x.ai with the Add to Grok Bot button
The share page for the RedReplier template. Every shared Grok bot gets one of these.

What is a Grok bot template?

A Grok bot template is a share link that copies a configured Grok Bot into someone else's app. SpaceXAI announced the feature on 28 August 2026 in a single sentence from the Grok Bot account: "You can now share templates of your Bots with others." Each template sits at an x.ai/bot/ URL with a 21-character id, and the "Add to Grok Bot" button is a deep link, grokbot://app/v1/bot-template?id=<id>, that only resolves if the desktop or iOS app is installed.

What travels is configuration. The name, the description, the skill text, and any routines. What does not travel is every credential, conversation and connected account belonging to whoever built it. xAI's own note on the share page is worth quoting because it sets the right expectation: "This AI bot was created by a third-party user, not by SpaceXAI. It may act on your behalf."

Grok Bot itself launched on 11 August 2026 in early beta. Each Bot gets its own cloud computer and, in xAI's words, "can sign in and work across apps, tools, and websites, including platforms with no clean API or MCP." Access needs an eligible plan: SuperGrok, SuperGrok Plus or SuperGrok Heavy, or Cursor Pro, Pro+ or Ultra, or Cursor Teams Standard or Premium.

Why does social listening suit an agent better than a dashboard?

Social listening suits an agent because the work is triage, and triage is a sequence of small judgment calls that a dashboard cannot make for you. A monitoring tool hands you a list. Somebody still has to read each item, decide whether the person is a buyer or a bystander, and act. That reading is where the hours go.

RedReplier already scores each mention for intent. The agent's job is to take the top of that list, fetch the reasoning behind each score, and put a short, honest answer in front of you. It compresses the reading, not the deciding.

Where the time actually goes
Keyword matches a post
AI scores it for intent
Someone reads it
Someone judges it
Someone replies
A Grok bot can do steps one to three well. Step four is the one you keep.

What is in the RedReplier Grok bot template?

The RedReplier template contains a bot profile, a skill describing the public REST API, and one daily routine. The skill is plain prose rather than a schema, because that is what a Bot reads best, and because a human reviewing a third-party template needs to be able to read it too.

Purpose: monitor and triage brand mentions through the RedReplier REST API.
 
Auth: every request needs the header "Authorization: Bearer <token>". The owner
creates the token at https://redreplier.com/api-tokens (it starts with
redreplier_ and needs the Editor or Admin role, because every call, reads
included, needs redreplier.write). Keep it in the connector credential field,
never in the conversation.
 
Base URL: https://ai.redreplier.com/ai-app/api/v1
Full spec: GET /openapi.json on the same base URL, no auth needed.
 
Workflow:
1. GET /websites to see monitored websites and their keywords, with statuses
   PENDING, ACTIVE, DISABLED or SUSPENDED.
2. GET /mentions with filters (websiteId, status NEW | APPROVED | REJECTED,
   source, relevance bucket, sort RELEVANCE | RECENT) to pull the inbox.
   GET /mentions/count for totals.
3. POST /mentions/{id}/explain to get the reasoning behind a score before
   judging a borderline mention.
4. PATCH /mentions/{id}/status to mark APPROVED or REJECTED, only on the
   owner's explicit instruction.
5. Keywords: POST /websites/{id}/keywords to add them (those that fit the
   plan go ACTIVE at once, the rest wait as PENDING). GET
   /keywords/billing-preview prices a bigger plan without changing it.
   POST /keywords/activate-pending turns on pending keywords up to the free
   slots and never charges.
   POST /keywords/{id}/disable or /enable, PATCH /keywords/{id} to edit.
6. GET /alert-settings and PUT /alert-settings for email alert cadence.
 
Validation: never add or activate keywords without the owner's explicit
instruction. Mention status changes follow the owner's explicit judgment,
never your own.
 
Failure: on 401 the token is wrong, expired or revoked. On 403 the plan lacks
API access or the token's role lacks redreplier.write. Tell the owner and
stop. Do not retry.

Two rules in that text are the reason the template is safe to hand around.

The keyword rule exists because a keyword the bot adds goes live at once when it fits the plan. An agent that adds keywords enthusiastically fills your plan's slots with its own guesses. No API call charges you: POST /keywords/activate-pending only fills free slots, GET /keywords/billing-preview prices a bigger plan without changing it, and upgrades happen in the RedReplier app.

The judgment rule exists because PATCH /mentions/{id}/status is destructive in a subtler way. A rejected mention leaves the queue. If the bot rejects on its own reading, you never see the lead it misjudged, and you will never know it happened.

What does the bot call, and what does each call cost you?

The bot uses 10 of the 22 operations in RedReplier's public API, and only four of them change anything.

CallWhat it doesRisk if the bot runs it alone
GET /websitesLists monitored sites and keywordsNone
GET /mentionsPulls the inbox with filters and sortingNone
GET /mentions/countTotals by status or sourceNone
POST /mentions/{id}/explainReturns the reasoning behind a scoreNone
GET /keywords/billing-previewPrices a keyword countNone
GET /alert-settingsReads email alert cadenceNone
PATCH /mentions/{id}/statusApproves or rejects a mentionA misjudged lead disappears
POST /websites/{id}/keywordsAdds keywords, ACTIVE if they fitFills plan slots with guesses
POST /keywords/activate-pendingActivates pending keywords that fitFills free slots, no charge
PUT /alert-settingsChanges alert frequencyYou stop getting emails

Reads are free to automate. The last four need a human sentence first, which is exactly what the skill's validation block enforces.

RedReplier API documentation for the list mentions endpoint
The mentions endpoint the skill leans on, documented at redreplier.com/docs.

How do I install and test it?

Installing the RedReplier Grok bot template takes four steps. Open the share link in Grok Bot, create a redreplier_ API token, paste it into the credential field, and ask for today's new mentions as a read-only test.

From share link to first digest
1
Open the link on a device with Grok Bot installed. Press "Add to Grok Bot" on x.ai/bot/8aU6ly_uunnMabpybs3hB. In a plain browser tab the deep link does nothing.
2
Create a RedReplier API token. It starts with redreplier_ and needs the Editor or Admin role. Every call, reads included, needs redreplier.write, so a Viewer token gets a 403 on the first call.
3
Paste it into the credential field, not the chat. A token typed into a message stays in the conversation.
4
Ask: "show me today's NEW mentions sorted by relevance, and explain the top three." That exercises GET /mentions and POST /mentions/{id}/explain in one go, and changes nothing.
Step 4 is deliberately read-only. Test the whole read path before you let it write anything.

Should the bot run on a schedule?

Run the RedReplier bot on a schedule for reading, never for deciding. The template ships with one routine, and its last line is the important one.

RedReplier
RedReplier

Get Started

Reddit, X, Bluesky & HN

Real-time intent alerts

Unlimited AI replies

Ranked by buyer intent

Name:      Morning lead digest
Schedule:  daily at 08:30, owner's timezone
What:      Pull NEW mentions since the last run, sorted by relevance. For
           everything scored HIGH or VERY_HIGH, fetch the explanation and draft
           a short, non-salesy reply I could post. Send one digest: top leads
           with links, scores, explanations and draft replies.
           Mark nothing approved or rejected without me.
If empty:  no notification.

"Mark nothing approved or rejected without me" is doing real work. Without it, a helpful agent will tidy your inbox, and a tidy inbox with silent rejections is worse than a messy one.

The "if empty, no notification" line is the other half. A daily digest that fires on quiet days trains you to ignore it, and the day it matters you will swipe it away with the rest.

Grok Bot routines are more often taught by demonstration. xAI describes it as asking a Bot "to follow along as you complete a workflow once. It saves it as a routine and runs it on its own next time." For API work a written routine is more precise, because you can name the exact filter and the exact sort instead of hoping it inferred them.

Do I need a Grok bot template at all, or is MCP enough?

If your client speaks MCP, use MCP. RedReplier runs a hosted MCP server at https://mcp.redreplier.com/mcp that wraps the same REST API, and Claude, Cursor and Codex connect to it with a config block and the same bearer token. The MCP server docs cover the setup.

The Grok bot template exists because Grok Bot is not primarily an MCP client. It is an app with its own computer that reads skills written in prose. Same API underneath, different way of handing it over.

Same API, three front doors
REST
  • Any language
  • 22 operations
  • Public OpenAPI spec
MCP
  • Claude, Cursor, Codex
  • Config block plus token
  • Hosted, nothing to run
Grok bot template
  • Grok Bot desktop and iOS
  • One tap, then a token
  • Skill written in prose
Pick by client, not by preference. The endpoints and the permissions are identical.

Frequently asked questions

What sources does the RedReplier Grok bot monitor?

The bot reads mentions from Reddit, X, Bluesky, Hacker News and Facebook, which are the sources RedReplier's public API covers. You filter by source in GET /mentions, so you can ask a bot for Reddit-only results in a sentence.

Can the bot reply to a mention for me?

No. RedReplier's public API has no endpoint that posts a reply, so the bot drafts text and hands it to you. Posting stays manual on purpose, because a reply written in your name is a decision, not a task.

Will the bot spend money without asking?

No. No RedReplier API call charges you or changes the plan. POST /keywords/activate-pending only turns on pending keywords up to the free slots on your plan, and GET /keywords/billing-preview prices a bigger plan without changing it. Upgrades happen in the RedReplier app. The shipped skill still makes the bot ask before it adds keywords, because those go live at once; if you rewrite the skill, keep that rule.

Why does the bot get a 401 when my token looks right?

A 401 means RedReplier did not accept the token: it is missing, malformed, expired or revoked, or the member who created it left the workspace. A plan or role problem returns 403 instead: subscription_required for the plan, and permission_denied for a Viewer token, since every call, reads included, needs redreplier.write. The skill tells the bot to report the error and stop rather than retry, which keeps a bad token from hammering the endpoint.

Does the template include the creator's keywords or mentions?

No. A Grok bot template carries the profile, the skill text and the routines. Monitored websites, keywords, mention history and API tokens all stay with the creator's account. Your copy starts empty and reads only your data.

Is a shared Grok bot template safe to install?

A template is safe to the extent that its skill text is safe, and the skill text is readable English you can check before installing. Read what endpoints it names and what it is allowed to do without asking. xAI's own share-page disclaimer says a third-party bot "may act on your behalf", which is the right way to think about every one of them.

Which listening job should I set up first?

Pick the source your buyers actually use, because the same template covers all six. There are guides for Reddit monitoring, X social listening and lead finder runs. For templates beyond RedReplier, groktemplates.dev indexes them by use case.

Install the RedReplier Grok bot template and triage mentions from a chat, or read the API docs first.

Sources: x.ai/bot, Introducing Grok Bot (11 August 2026), @bot on X (28 August 2026), and the RedReplier OpenAPI spec. Checked 30 August 2026.

Meta's agent takes a different route into the same API: the Meta Muse connector guide.

RedReplier
RedReplier

Get Started

Reddit, X, Bluesky & HN

Real-time intent alerts

Unlimited AI replies

Ranked by buyer intent

See us more often in Google

One click marks RedReplier as a preferred source, so our articles sit higher in your Top Stories, AI Mode, and AI Overviews.

Before you go...

RedReplier

RedReplier

Catch every buyer asking for what you sell

RedReplier watches Reddit, X, Bluesky and Hacker News in real time, ranks every thread by buyer intent, and drafts your reply, so you get there first.

Reddit, X, Bluesky & HN

Real-time intent alerts

Unlimited AI replies

Ranked by buyer intent

Related Articles