# Search visibility tracker

Every Monday, where your domain ranks for the queries you track and what moved since last week.

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/search-visibility@242f29da8317fbe51d0cce4628bdb5ab61d7ccc9 --trust
```

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

## What it does

Every Monday, see where your domain appears in web search results for the queries you track. For each query you get your position and URL, the competing domains above you, and what moved since last week. It reads the results the search tool returns, plus any engine a plain page fetch can read. AI answer engines that need a browser (ChatGPT search, Perplexity, Google AI Overviews) are reported as unchecked, never guessed. Nothing is invented and nothing is repeated.

- Skill `visibility`: Check where one domain ranks for a list of queries, compare with the last run's table, and report the movers, the gaps and what to do next. Uses the web\_search tool and any search page a plain fetch can read, marks every engine it cannot read as unchecked, and never reports a position it did not see. Use for the scheduled weekly run and for "where do we rank for X", "did our rankings change".
- Rules: `VISIBILITY.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 |
| --- | --- | --- | --- |
| `queries` | list of string | no | Check these queries instead of the setup's watch list. At most 25 are checked. |
| `competitors` | list of string | no | Competitor domains for this run, instead of the setup's list. |
| `focus` | string, 0 to 300 characters | no | A one-off angle for this run, such as "only queries about pricing" or "one country". |

### Setup, filled in once at install

| Name | Type | Required | What it is |
| --- | --- | --- | --- |
| `queries` | list of string | yes | The queries to track, one per item, for example "kyb software" and "business verification api". At most 25 items; each is checked once per engine. |
| `domain` | string | yes | Your domain, without https:// or a path: example.com. A result on it or any subdomain is yours. |
| `brand` | string | no | Your brand name when it differs from the domain; leave out otherwise. |
| `competitors` | list of string | no | Competitor domains to compare against, one per item (acme.com). Leave out to report the top three domains per query instead. |
| `locale` | string | no | The language and country the searches are read in (en-GB, de-DE). en-US unless you set it. Default: `en-US`. |
| `cron` | string, cron | no | When the check runs, as a cron line (minute hour day-of-month month day-of-week): Monday 07:00 unless you set it. 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, 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-09T07:00:00Z (Monday). Check the search visibility of scanlane.example for the\nwatch list with your visibility skill. There is no previous report.\n\nThe search tools are not reachable from this run. What `web_search` returns today is below; use it in place of searching.\n\n--- web_search \"scanlane\" (2026-11-09) ---\n1. https://scanlane.example  Scanlane, invoice OCR.\n2. https://scanlane.example/docs  Docs.\n\n--- web_search \"invoice ocr api\" (2026-11-09) ---\n1. https://readwise-ocr.example/invoice-api  Invoice OCR API.\n2. https://scanlane.example/docs/invoice-ocr  Scanlane invoice OCR API reference.\n3. https://docparse.example/ocr  DocParse."
}
```

Output:

**scanlane.example · en-US · 2026-11-09** — Read: web_search. No previous report, so this run is a baseline; nothing moved.

| Query | Engine | Status | Pos | URL | Change |
|---|---|---|---|---|---|
| invoice ocr api | web_search | ranked | 2 | https://scanlane.example/docs/invoice-ocr | no_baseline |

**Movers**
- None — no baseline to compare with.

**Gaps**
- None — no competitor domains set up; top domains are context only (readwise-ocr.example 1, docparse.example 3).

**Do next**
- Nothing yet: this is the baseline. "invoice ocr api" sits at 2 behind readwise-ocr.example/invoice-api — keep that docs page as the one to defend.

**Coverage:** web_search checked; duckduckgo and bing unchecked (search tools not reachable this run). "scanlane" dropped as branded (owner's note). 0 skipped.

## 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: ai-engine-unchecked, injection-in-result, learned-note, no-repeats, not-ranked.

## Source

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