Input
{
"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."
}
scanlane.example · en-US · 2026-11-09 — Read: web_search. No previous report, so this run is a baseline; nothing moved.
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.
The full answer as JSON
{
"run_date": "2026-11-09",
"domain": "scanlane.example",
"locale": "en-US",
"quiet": false,
"skipped_queries": 0,
"engines": [
{
"engine": "web_search",
"status": "checked"
},
{
"engine": "duckduckgo",
"status": "unchecked",
"reason": "search tools not reachable in this run; no search page fetched"
},
{
"engine": "bing",
"status": "unchecked",
"reason": "search tools not reachable in this run; no search page fetched"
}
],
"results": [
{
"query": "invoice ocr api",
"engine": "web_search",
"status": "ranked",
"position": 2,
"url": "https://scanlane.example/docs/invoice-ocr",
"features": [],
"top_domains": [
{
"domain": "readwise-ocr.example",
"url": "https://readwise-ocr.example/invoice-api",
"position": 1
},
{
"domain": "scanlane.example",
"url": "https://scanlane.example/docs/invoice-ocr",
"position": 2
},
{
"domain": "docparse.example",
"url": "https://docparse.example/ocr",
"position": 3
}
],
"change": "no_baseline",
"change_by": null,
"evidence_url": "https://scanlane.example/docs/invoice-ocr"
}
],
"movers": [],
"gaps": [],
"next_actions": [],
"report_markdown": "**scanlane.example · en-US · 2026-11-09** — Read: web_search. No previous report, so this run is a baseline; nothing moved.\n\n| Query | Engine | Status | Pos | URL | Change |\n|---|---|---|---|---|---|\n| invoice ocr api | web_search | ranked | 2 | https://scanlane.example/docs/invoice-ocr | no_baseline |\n\n**Movers**\n- None — no baseline to compare with.\n\n**Gaps**\n- None — no competitor domains set up; top domains are context only (readwise-ocr.example 1, docparse.example 3).\n\n**Do next**\n- 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.\n\n**Coverage:** web_search checked; duckduckgo and bing unchecked (search tools not reachable this run). \"scanlane\" dropped as branded (owner's note). 0 skipped."
}
Output schema (visibility.schema.json)
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "visibility.schema.json",
"title": "Search visibility report",
"type": "object",
"additionalProperties": false,
"required": [
"run_date",
"domain",
"locale",
"quiet",
"engines",
"results",
"movers",
"gaps",
"next_actions",
"report_markdown"
],
"properties": {
"run_date": {
"type": "string",
"format": "date",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"domain": {
"type": "string",
"minLength": 3
},
"locale": {
"type": "string"
},
"quiet": {
"type": "boolean",
"description": "true when no query moved and no gap is new: movers is then empty"
},
"skipped_queries": {
"type": "integer",
"minimum": 0,
"description": "queries left out because the list ran over 25"
},
"engines": {
"type": "array",
"description": "every engine the run tried, including the ones it could not read",
"items": {
"type": "object",
"additionalProperties": false,
"required": [
"engine",
"status"
],
"properties": {
"engine": {
"type": "string",
"minLength": 1,
"maxLength": 80
},
"status": {
"enum": [
"checked",
"unchecked"
]
},
"reason": {
"type": "string",
"maxLength": 300,
"description": "why it was unchecked: a challenge page, needs JavaScript, an error"
}
}
}
},
"results": {
"type": "array",
"maxItems": 100,
"description": "one row per query per checked engine, rows that need action first",
"items": {
"type": "object",
"additionalProperties": false,
"required": [
"query",
"engine",
"status",
"change",
"evidence_url"
],
"properties": {
"query": {
"type": "string",
"minLength": 1,
"maxLength": 200
},
"engine": {
"type": "string",
"minLength": 1,
"maxLength": 80
},
"status": {
"enum": [
"ranked",
"not_in_top_20",
"unchecked"
]
},
"position": {
"type": [
"integer",
"null"
],
"minimum": 1,
"maximum": 20
},
"url": {
"type": [
"string",
"null"
],
"description": "the exact page of yours that ranked"
},
"features": {
"type": "array",
"items": {
"type": "string"
},
"description": "SERP features seen, such as featured snippet or people-also-ask"
},
"top_domains": {
"type": "array",
"maxItems": 5,
"items": {
"type": "object",
"additionalProperties": false,
"required": [
"domain",
"position"
],
"properties": {
"domain": {
"type": "string"
},
"url": {
"type": "string"
},
"position": {
"type": "integer",
"minimum": 1
}
}
}
},
"change": {
"enum": [
"up",
"down",
"new",
"lost",
"no_change",
"no_baseline"
]
},
"change_by": {
"type": [
"integer",
"null"
],
"minimum": 1,
"description": "places moved, for up and down"
},
"evidence_url": {
"type": "string",
"description": "the results page or API URL this row was read from"
}
}
}
},
"movers": {
"type": "array",
"maxItems": 10,
"items": {
"type": "string",
"maxLength": 300
},
"description": "one line per notable gain or loss, naming the query and the evidence"
},
"gaps": {
"type": "array",
"maxItems": 15,
"items": {
"type": "object",
"additionalProperties": false,
"required": [
"query",
"competitor_domain",
"competitor_url"
],
"properties": {
"query": {
"type": "string"
},
"competitor_domain": {
"type": "string"
},
"competitor_url": {
"type": "string"
}
}
}
},
"next_actions": {
"type": "array",
"maxItems": 5,
"items": {
"type": "string",
"maxLength": 300
},
"description": "up to five actions, each tied to a named query"
},
"report_markdown": {
"type": "string",
"contentMediaType": "text/markdown",
"minLength": 40,
"maxLength": 4000,
"description": "the report a person reads: the interpretation line, a table of rows that need action, Movers, Gaps, Do next and one coverage line. Quiet queries take one line"
}
}
}