| name | browse-geo |
| version | 1.0.0 |
| description | Track brand and domain VISIBILITY across AI search engines over a whole query set — Generative
Engine Optimization monitoring, not a one-page audit — sweeping each query through Google AI
Overviews, Perplexity, and authenticated ChatGPT Search via the `browse` CLI (camoufox for Google),
recording each citation into a cross-engine visibility matrix with rates, average position, and
competing domains. Reports point-in-time truth: ambiguous citations flagged uncertain, nothing
fabricated. Use to monitor a brand's AI-answer presence across engines and queries.
|
| allowed-tools | ["Bash","Read","AskUserQuestion"] |
| argument-hint | [brand queries or domain to monitor] |
| arguments | ["request"] |
| when_to_use | Use when the user wants GEO monitoring, AI-visibility tracking, or brand monitoring across AI search
— "does my domain appear in AI Overviews for these queries", "monitor brand visibility across
Perplexity and ChatGPT". Do NOT use for traditional SEO — rankings, meta, crawlability (browse-seo)
— or a one-page answerability audit (browse-aeo); this is a repeatable multi-query, multi-engine
presence sweep, not a single-page check.
|
| effort | high |
browse-geo: Generative Engine Optimization Monitoring
Goal
Monitor how a brand or domain appears in AI-generated search results across three engines:
Google AI Overviews, Perplexity, and ChatGPT Search. Produce a visibility matrix showing
which queries surface the target domain, in what position, and with what context.
Prerequisites
Camoufox is required for Google (bot detection). Check availability:
browse --runtime camoufox doctor
If camoufox is not installed, stop and tell the user to install it manually:
Install it with: npm install camoufox-js && npx camoufox-js fetch
Do NOT install anything automatically.
For ChatGPT Search, a persistent browser profile with an authenticated ChatGPT session is
required. If one does not exist, ask the user to authenticate:
browse --profile chatgpt --headed goto https://chatgpt.com
Step 0: Gather inputs
Before running any queries, collect from the user:
- Target domain — the domain to track (e.g.,
example.com)
- Query list — 3-10 brand-relevant search queries
- Engines — which engines to check (default: all three)
If the user provides only a domain, suggest relevant queries based on the domain's likely
industry and product category. Use AskUserQuestion to confirm the query list.
Step 1: Google AI Overviews
Google AI Overviews appear at the top of search results for informational queries.
Use camoufox with consent dismissal to avoid bot detection and cookie banners.
Navigate and extract
For each query:
BROWSE_CONSENT_DISMISS=1 browse --runtime camoufox --headed goto "https://www.google.com/search?q=<url-encoded-query>"
browse --runtime camoufox --headed wait --network-idle
browse --runtime camoufox --headed snapshot -i
Analyze results
Read the snapshot output. The AI Overview section typically has an "AI Overview" label,
expandable summary text with inline citations, and source links. If present, use
browse --runtime camoufox --headed text to extract full content.
For each query, record: ai_overview_present (yes/no), domain_cited (yes/no),
citation_position (number or null), citation_context (the claim it supports),
and competing_domains (other cited domains).
Step 2: Perplexity
Perplexity shows AI-generated answers with numbered source citations.
Navigate and extract
For each query:
browse goto "https://www.perplexity.ai/search?q=<url-encoded-query>"
browse wait --network-idle
browse snapshot -i
Analyze results
Perplexity shows numbered footnote-style citations (e.g., [1], [2]) within the answer
and a "Sources" section with URLs. Use browse text for full content if needed.
For each query, record: answer_generated (yes/no), domain_cited (yes/no),
citation_numbers (positions referencing the target domain), citation_context,
total_citations, and competing_domains.
Step 3: ChatGPT Search (authenticated)
ChatGPT Search requires an authenticated session. Use a persistent profile.
Navigate and query
For each query:
browse --profile chatgpt goto https://chatgpt.com
browse --profile chatgpt snapshot -i
Find the input field from the snapshot, then:
browse --profile chatgpt fill <input-ref> "<query>"
browse --profile chatgpt press Enter
browse --profile chatgpt wait --network-idle
ChatGPT streams responses. Wait for output to stabilize, then snapshot:
browse --profile chatgpt wait --network-idle
browse --profile chatgpt snapshot -i
If a stop/regenerate button is visible, the response is still streaming — wait and
re-snapshot. Use browse --profile chatgpt text for full content extraction.
Analyze results
ChatGPT Search shows inline numbered citation links and a "Sources" panel with URLs.
For each query, record: response_generated (yes/no), search_used (yes/no --
ChatGPT may answer from training data without search), domain_cited (yes/no),
citation_position (number or null), citation_context, and competing_domains.
Step 4: Generate visibility report
After running all queries across selected engines, compile the results into a
structured report.
Visibility matrix
Create a table with queries as rows and engines as columns:
| Query | Google AI Overview | Perplexity | ChatGPT Search |
|------------------------|--------------------|------------|----------------|
| "best <product>" | Cited (#2) | Cited (#1) | Not cited |
| "<brand> vs competitor"| No AI Overview | Cited (#3) | Cited (#2) |
| "how to <task>" | Cited (#1) | Not cited | Not cited |
Summary metrics
Calculate and report:
- Visibility rate: percentage of queries where the domain appears, per engine
- Average citation position: mean position when cited, per engine
- Best-performing queries: queries where the domain appears across multiple engines
- Gap queries: queries where the domain is absent from all engines
- Top competing domains: domains that appear most frequently across all queries
Recommendations
Based on the findings, suggest:
- Which queries have the highest AI visibility potential
- Where competitors are cited but the target domain is not
- Content gaps that could improve citation likelihood
- Which engines favor the domain (focus optimization there)
Multi-query workflow
When running many queries, batch by engine to minimize context switching:
- Run all queries on Google AI Overviews first (camoufox session stays warm)
- Run all queries on Perplexity second (no special runtime needed)
- Run all queries on ChatGPT Search last (authenticated profile session)
Between queries on the same engine, no need to restart the browser. Navigate directly
to the next search URL.
Important rules
- Camoufox for Google — Google blocks regular Chromium for automated searches. Always
use
--runtime camoufox --headed for Google queries.
- Rate limiting — Add natural pauses between queries on the same engine. Do not run
more than one query every 5-10 seconds on Google. Perplexity and ChatGPT are more lenient.
- AI Overviews are not always present — Google shows AI Overviews for informational
queries, not navigational or transactional ones. Record absence as a data point.
- ChatGPT may not use search — ChatGPT sometimes answers from training data without
invoking web search. When no sources panel appears, record
search_used: no.
- Snapshot before text — always take a snapshot first to understand page structure,
then use text extraction for full content if needed.
- Do not fabricate results — if a citation is ambiguous or unclear, note it as
uncertain rather than asserting presence or absence.
- Profile persistence — the
--profile chatgpt flag reuses cookies across sessions.
If the session expires, ask the user to re-authenticate via headed mode.
Limitations
- Google AI Overviews availability — not all queries trigger AI Overviews; availability
varies by region and query type
- ChatGPT Search access — requires a ChatGPT Plus or Team subscription with search enabled
- Rate limits — aggressive querying may trigger temporary blocks on any engine
- Dynamic content — AI-generated answers change over time; results represent a
point-in-time snapshot
- Image/video citations — this workflow tracks text citations only; rich media
citations in AI answers are not captured
