# User voice monitor

Every Monday, the themes users raise about your product in reviews and forums, with linked quotes.

Requires web search, through Exa. Requires web fetch. Runs on a schedule.

## Install

```sh
npx @parcha/agentrun template install github:Parcha-ai/agentrun-templates/templates/user-voice@242f29da8317fbe51d0cce4628bdb5ab61d7ccc9 --trust
```

Or open `<your AgentRun address>/#/templates/install?src=github%3AParcha-ai%2Fagentrun-templates%2Ftemplates%2Fuser-voice%40242f29da8317fbe51d0cce4628bdb5ab61d7ccc9`. Pinned to commit 242f29da8317fbe51d0cce4628bdb5ab61d7ccc9.

## What it does

Every Monday, the themes users are raising about your product, company or category in public reviews, forums and app stores, ranked by volume and severity. Each theme has verbatim quotes linked to the post, an approximate count with its sample basis, and what is new since last week. It reads what a plain fetch can read (Apple App Store reviews, Hacker News, Reddit when it answers, review pages that do not block), says which sources it could not read, and never invents a quote, a rating or a count.

- Skill `voice`: Write the weekly user voice report for one product, company or category. Read first-hand public posts (App Store reviews, Hacker News, Reddit, review pages that a plain fetch can read), cluster them into themes, rank by volume then severity, quote users verbatim with links, give approximate counts with their basis, and mark what is new since the last report. Use for the scheduled weekly run and for "what are users saying about X", "any complaints after the last release".
- Rules: `VOICE.md`

## What starts it

- On a schedule: Mondays at 08:00 (UTC), unless you pick another time when you install it.
- By hand, any time: from the console, the API or the CLI.

## Inputs

| Name | Type | Required | What it is |
| --- | --- | --- | --- |
| `subject` | string, 0 to 200 characters | no | Cover this product, company or category instead of the setup's. |
| `sources` | list of string | no | Where to look first this run, instead of the setup's. |
| `competitors` | list of string | no | Products to compare against this run, instead of the setup's. |
| `focus` | string, 0 to 300 characters | no | A one-off question for this run, such as "reactions to the new pricing". Only posts that bear on it count. |

### Setup, filled in once at install

| Name | Type | Required | What it is |
| --- | --- | --- | --- |
| `subject` | string | yes | The product, company or category to listen to: "Notion", "Acme Payments", "password managers". A category covers its four to six leading products. |
| `sources` | list of string | no | Where to look first, one per item ("app store", "r/notion", "Hacker News"). Leave out for every first-hand source that fits. |
| `competitors` | list of string | no | Products to compare against, one per item. At most 5 items. Leave out for no comparison. |
| `app_store_id` | string | no | The product's Apple App Store id (the digits after id in its store URL), when it has an app: recent reviews are read from Apple's public feed. |
| `lookback_days` | integer | no | How many days back a run looks; leave it out for 7. Keep it equal to the gap between runs. |
| `cron` | string, cron | no | When the run starts, as a cron line (minute hour day-of-month month day-of-week): Monday 08:00 unless you set it; set lookback\_days to its gap. Default: `0 8 * * 1`. |
| `timezone` | string, timezone | no | The IANA time zone the cron line is read in (Europe/Madrid, America/New\_York): UTC unless you set it. Default: `UTC`. |

## What it needs

- Harness: pi, claude-agent, codex
- Model: balanced tier, low effort
- Tools: web_search, web_fetch, read
- Computer: Wherever your AgentRun puts a new agent
- Keys: A model key
- Learning: on

## Sample output

Input:

```json
{
  "content": "Scheduled weekly run, fired 2026-11-16T08:00:00Z (Monday). Write this week's user voice report for Quillforge with\nyour voice skill.\n\nThe web is not reachable from this run. The App Store feed returns the reviews below, all inside the window; use them in\nplace of fetching. The previous report is below.\n\n--- The result of this trigger's last completed run ---\n```json\n{\"window\":{\"from\":\"2026-11-02\",\"to\":\"2026-11-09\"},\"subject\":\"Quillforge\",\"quiet\":false,\"themes\":[{\"theme\":\"Notes lost after sync since 4.2\",\"kind\":\"complaint\",\"status\":\"new\",\"volume\":\"about 3 of 8 App Store reviews read, Nov 2 to 9\",\"severity\":\"high\",\"quotes\":[{\"text\":\"Notes keep disappearing after sync since 4.2.\",\"url\":\"https://apps.apple.example/review/9002\",\"source\":\"app store\"},{\"text\":\"Update 4.2 broke sync, half my notebook is gone.\",\"url\":\"https://apps.apple.example/review/9003\",\"source\":\"app store\"}]}],\"sources\":[{\"source\":\"app store\",\"status\":\"read\"}],\"report_markdown\":\"Sync loss.\"}\n```\n\n--- App Store feed (fetched 2026-11-16) ---\n1. 2026-11-14, 1 star, https://apps.apple.example/review/9201: \"Still losing notes on sync. 4.2.1 did not fix it.\"\n2. 2026-11-13, 2 stars, https://apps.apple.example/review/9202: \"Subscription price went from $4 to $6 with no notice.\"\n3. 2026-11-12, 1 star, https://apps.apple.example/review/9203: \"Charged $6 after the $4 plan I signed up for. Where is the notice?\"\n4. 2026-11-11, 2 stars, https://apps.apple.example/review/9204: \"Price hike without warning. Cancelling.\"\n5. 2026-11-10, 5 stars, https://apps.apple.example/review/9205: \"Love the widgets.\""
}
```

Output:

**Quillforge — week of Nov 10 to 16, 2026.** 5 first-hand App Store reviews read (the feed was supplied in place of a fetch; the web was unreachable this run, so HN and Reddit were not read). Ranked by volume first: billing 3 posts against sync 1, with sync kept high on severity because it describes data loss.

**1. Unannounced price rise from $4 to $6 — new, high severity, 3 of 5 reviews (Nov 10–14).** Users say they were charged the higher rate with no notice; one is cancelling. "Subscription price went from $4 to $6 with no notice." (Nov 13) · "Charged $6 after the $4 plan I signed up for. Where is the notice?" (Nov 12) · "Price hike without warning. Cancelling." (Nov 11). No vendor response seen. No release tie: version link unconfirmed.

**2. Notes still lost on sync after 4.2.1 — continuing, high severity, 1 of 5 reviews.** A single post, counted on the data-loss rule rather than volume. "Still losing notes on sync. 4.2.1 did not fix it." (Nov 14). This is the same problem reported last week against 4.2; the fix update did not resolve it for this user.

**What is new:** the billing complaint is this week's largest theme and did not appear last week. Sync loss continues. One 5-star review praising widgets was the week's only praise and is too few to form a theme.

**Not read:** Hacker News and Reddit were not reachable from this run.

## Tested

Passes 5 of 5 eval cases on pi, 2 of 5 on Claude Code and 4 of 5 on Codex. Not yet tried on the live web.

5 eval cases: injection-in-review, learned-note, no-repeats, too-thin, unreadable-source.

## Source

- Package: https://github.com/Parcha-ai/agentrun-templates/tree/242f29da8317fbe51d0cce4628bdb5ab61d7ccc9/templates/user-voice
- Publisher: Parcha-ai
- Author: Parcha Labs
- Version: 0.1.0
- License: Apache-2.0
- Category: Marketing
- Page: https://marketplace.agentrun.ai/templates/user-voice/
