gsc_detect_browsers
Lists installed Chromium browser profiles and recommends one to use with the Google Search Console extension, based on local browser state without network calls.
Instructions
List the Chromium browser profiles on this machine and recommend one.
Local-only: reads the browsers' own state files, makes no network call, spends no quota, and needs no token — safe to call before signing in. Answers "which browser profile should I drive?", nothing else; it opens no browser and changes no setting.
PRIVACY: no email address is returned, in either direction. Not the account signed in to a profile, not the account that authorised this server, and not a profile display name that is itself an address. No filesystem path is returned either — a profile path carries the operator's account name. What identifies a profile here is its browser and its profile directory.
Returns {"ok": True, "profiles": [...], "recommended": <one of them or None>, "reasons": [...]}. profiles is a FLAT list across every
browser, ranked-flag included, not grouped by browser — the question is
which single profile to use, so each entry carries its own brand
context (browser, browser_key, extensions_url) and stands alone.
Each profile is {"browser", "browser_key", "extensions_url", "profile", "display_name", "account_on_disk", "account_discoverable", "matches_authorised_account", "has_extension", "recommended"}.
extensions_url is where that browser's extensions page lives
(chrome://extensions, brave://extensions, ...). Use the value given;
do not build one from the browser key, since Chromium registers no
chromium:// scheme and uses chrome://extensions.
has_extension is TRI-STATE: true means the pairing extension is
installed in that profile, false means every preferences file was read
and it was not among them, and null means the check could not be
PERFORMED — an unreadable preferences file, or no unpacked extension
directory to match against. Read null as "not detected", never as "not
installed"; telling a user with a working install to reinstall it is
the one wrong answer this flag exists to avoid.
account_on_disk says an account address was found in that profile's
files — found, not validated: no token is checked and nobody's live
session is inspected, and on Microsoft Edge the same file records
Microsoft accounts, so treat it as a hint rather than a login check.
account_discoverable is a fact about the BRAND: Brave, Vivaldi, Opera
and plain Chromium record no Google account at all, so account_on_disk: false there means "not discoverable", NOT "nobody is signed in".
matches_authorised_account is true, false, or NULL — null means the
question could not be asked (nothing has authorised yet, or the brand
records nothing), and must not be read as "no". reasons explains the
recommendation in plain sentences.
A machine with no Chromium browser installed returns ok: true with an
empty profiles list, recommended: null, and a note saying what to
install; that is an ordinary state, not a failure. Only an unexpected
fault returns {"ok": False, "error": "unexpected", "detail": <exception type>, "fix": ...}.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||