# Earnings brief

What each ticker you watch reported since the last run, set against a named consensus.

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/earnings-brief@242f29da8317fbe51d0cce4628bdb5ab61d7ccc9 --trust
```

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

## What it does

For each ticker you watch, the results it reported since the last run, set against expectations. You get revenue and EPS against a named consensus (or "consensus not verified"), guidance changes with the old and new range, exact management quotes with the speaker, the themes of the analyst questions, the stock reaction, and what changed since last quarter. Runs weekly, or set the schedule to the day after a reporting date. Tickers that did not report get a one-line price move with its driver, or "no identified driver". A quarter already covered is never repeated. No buy or sell advice.

- Skill `earnings`: Write the earnings brief for a watchlist. Find which watched companies reported results inside the window, read the release and the transcript, set revenue and EPS against a named consensus, give guidance changes with old and new ranges, quote management word for word, summarize the analyst Q&A themes and the stock reaction, skip quarters an earlier report covered, and give a one-line price move with its driver for the rest. Use for the scheduled run and for "how did Nvidia's quarter go", "who reported this week".
- Rules: `EARNINGS.md`

## What starts it

- On a schedule: Mondays at 07: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 |
| --- | --- | --- | --- |
| `tickers` | list of string | no | Cover these tickers or company names instead of the setup's list. At most 30. |
| `focus` | string, 0 to 300 characters | no | A one-off angle for this run, such as "capex and data-center revenue". |

### Setup, filled in once at install

| Name | Type | Required | What it is |
| --- | --- | --- | --- |
| `tickers` | list of string | yes | The companies to watch, one ticker or name per item ("AAPL", "MSFT", "Nestle"). Add the exchange when a ticker is ambiguous ("SHEL.L"). At most 30 items. |
| `focus` | string | no | Segments, metrics or Q&A threads to put first in every brief ("cloud revenue", "gross margin"). It sets order, not coverage. |
| `compare_against` | string | no | A benchmark to weigh each company against, such as a peer figure or your own target. Leave out to compare with each company's prior quarter, year-ago quarter and prior guidance. |
| `recap` | boolean | no | Also give a one-line price move for each watched ticker that did not report, with its driver. On unless you turn it off. Default: `true`. |
| `lookback_days` | integer | no | How many days back a run looks for new results; 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 07:00 unless you set it. For a run the day after a reporting date, set the cron to that date and lookback\_days to 2. Default: `0 7 * * 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, medium 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 run, fired 2026-11-09T07:00:00Z (Monday). Write the earnings brief for GLOBEX with your earnings skill. There\nis no previous brief.\n\nThe web is not reachable from this run. The page below is what the URL returns today.\n\n--- https://ir.globex.example/news/q3-fy2026 (fetched 2026-11-09, release dated 2026-11-05) ---\nGlobex Inc (NYSE: GLBX) reported third quarter fiscal 2026 results, quarter ended September 30, 2026: revenue $640\nmillion, up 8% year over year; GAAP EPS $0.12; adjusted EPS $0.31. The company maintained its full-year revenue guidance\nof $2.5 to $2.6 billion. No named consensus is published."
}
```

Output:

#### Globex: revenue rose 8%; full-year outlook maintained
**Window:** November 2–9, 2026; releases after November 2 through November 9 included.

#### Globex Inc (NYSE: GLBX) — Q3 FY2026
**Release summary:** For the quarter ended September 30, 2026, reported revenue was **$640 million, up 8% year over year**, and **GAAP EPS was $0.12**. Globex released results on November 5, 2026. FY2026 revenue guidance was maintained: the prior and current ranges are both **$2.5–$2.6 billion**. [Source: supplied investor-relations release](https://ir.globex.example/news/q3-fy2026).

**Expectations:** consensus not verified for revenue or GAAP EPS; no beat or miss is assigned. The release supplies the year-over-year revenue comparison but no comparable prior-year GAAP EPS.

**Verification limits:** The supplied release was the only available source; web access was unavailable, so independent corroboration was not possible. No transcript or replay was available to read, so management quotes and analyst Q&A themes are omitted. Stock reaction was not verified.

**Watched companies without results in the window:** None.

_Repeats checked by date: no previous brief given._

## Tested

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

5 eval cases: injection-in-release, learned-note, no-repeats, nobody-reported, quotes-verbatim.

## Source

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