Playbook · Weekly, Monday morning

A weekly share-of-voice note your assistant writes

Share of voice is a division: your relevant mentions over everyone’s. This playbook counts them per keyword in FishOut for this week and last, works out the shares, and writes the three-paragraph note — what moved and the posts that moved it.

[01] THE PROMPT/ COPY IT

Paste this

Fill in the {{braces}}. Run below: Hermes Agent.

prompt

Using FishOut, list our keywords. For each brand and competitor keyword, count relevant mentions for {{this week}} and {{last week}}. Work out each one’s share of the total, and the change. Then use insights to say which platform drove the biggest change, and name two mentions that explain it. Write it as a short note for {{#marketing}}, with a table.
[02] WHAT IT CALLS/ 4 TOOLS

Tools and arguments

4 of 4 read only.
  • list_keywordsread-only

    Which keywords are brands and which are competitors.

  • count_mentionsread-only

    One count per keyword per week. Relevant mentions only — filtered noise is excluded by default.

    filter: {"keywordIds":["<keyword>"],"from":"<week start>","to":"<week end>"}
  • get_insightsread-only

    Platform and sentiment breakdowns, to explain the change.

    rangeDays: 30
  • list_mentionsread-only

    The two posts that explain the move.

    filter: {"sort":"best"}, limit: 2
[03] A RUN/ FIXTURE

What comes back

Fixture data.
Hermes Agent · scheduledfishout · mcp
Weekly share of voice for #marketing.
list_keywordsread-only
{}
count_mentionsread-only
{
  "filter": {
    "keywordIds": [
      "kw_…"
    ],
    "from": "2026-10-13T00:00:00Z",
    "to": "2026-10-20T00:00:00Z"
  }
}
get_insightsread-only
{
  "rangeDays": 30
}
84
SaaS Heraldnews3d

Three listening tools add AI triage this autumn

WatchComparison

Share of voice: us 31% (up from 24%), Competitor A 44% (down from 52%), Competitor B 25%. The move came from Google News: a SaaS Herald roundup and two follow-ups named us first. Reddit was flat.

[04] GUARDRAILS/ LIMITS

Relevant mentions only

count_mentions leaves out filtered posts unless you pass includeFiltered, so a namesake does not inflate a share.

Same keywords both weeks

Adding a keyword mid-week changes the denominator. The note should say so when it happens.

Read-only

Nothing here writes; posting the note to Slack is the agent’s own connector or your paste.
[05] SCHEDULE IT/ CRON

A prompt runs once

Weekly, Monday morning: Codex, OpenClaw or Hermes Agent.

Hermes Agent · cron expression

hermes cron create "0 9 * * 1" \
  "Using FishOut, list our keywords"

Or let FishOut do the scheduled part

FishOut’s Insights page already charts volume and share by keyword. The prompt turns it into a written note with the reasons.
[06] NO ASSISTANT/ RULES

“Press mentions to #marketing” as a rule

No prompt at all: a FishOut agent rule (from Plus) does the routine half.
Press mentions to #marketing2 runs / 24h

When

Every triaged mention

Platform is Google News

Subject is one of Your brand, A competitor

Then

Post to Slack #marketing

Questions