Panniantong/Agent-Reach · error · RuntimeError

Could not read cookies via rookiepy: Make sure is closed…

Error message

Could not read {browser} cookies via rookiepy: {scrub_url_credentials(e)}
Make sure {browser} is closed and you have permission.

What it means

Raised by extract_all() in agent_reach/cookie_extract.py when the rookiepy backend throws while loading cookies for the requested browser. Any exception from browser_funcs[browser](domains) — locked SQLite cookie stores, permission errors, or rookiepy internals — is wrapped in this RuntimeError with the underlying message scrubbed of credentials. rookiepy is only used when no profile is selected.

Solutions

Close the target browser completely (including background processes) and retry
Verify the browser has been used and has a cookie store on this machine
If it keeps failing, install browser-cookie3 and/or fall back to a manual Cookie-Editor export

Example fix

# before
cookies = extract_all(browser='chrome', platform='bilibili')  # RuntimeError while Chrome open

# after: ensure Chrome is closed first
import subprocess; subprocess.run(['pkill', '-f', 'Google Chrome'])
cookies = extract_all(browser='chrome', platform='bilibili')

Defensive patterns

Strategy: retry

Validate before calling

def browser_running(name: str) -> bool:
    out = subprocess.run(['pgrep', '-fl', {'chrome': 'Chrome', 'edge': 'msedge', 'brave': 'brave', 'opera': 'opera'}[name]], capture_output=True)
    return out.returncode == 0

Try / catch

for attempt in range(2):
    try:
        cookies = extract_all(browser='chrome', platform='bilibili')
        break
    except RuntimeError as e:
        if 'rookiepy' in str(e) and attempt == 0:
            close_browser('chrome'); continue
        raise

Prevention

Close the browser before extraction runs
Retry once after the user closes the browser rather than failing immediately
Surface the scrubbed backend message — it usually names the lock or permission cause

When it happens

Trigger: extract_all(browser='chrome', platform='xueqiu') while Chrome is running (cookie DB locked), on Linux with an encrypted keyring rookiepy cannot unlock, or when the browser has never created a cookie store.

Common situations: Running extraction with the browser open; headless CI boxes with no Chrome profile ever initialized; snap-packaged Chromium storing cookies where rookiepy does not look.

Related errors

AI-assisted analysis of Panniantong/Agent-Reach@93ae1d18c3 (2026-08-14). Data as JSON: /api/errors/9a64ca5320a6bec7. Report an issue: GitHub.

Appendix: source

Thrown at agent_reach/cookie_extract.py:281

        # rookiepy returns list of dicts with name/value/domain/path keys
        try:
            browser_funcs = {
                "chrome": rookiepy.chrome,
                "firefox": rookiepy.firefox,
                "edge": rookiepy.edge,
                "brave": rookiepy.brave,
                "opera": rookiepy.opera,
            }
            raw_cookies = browser_funcs[browser](list(spec["domains"]))
            # Wrap into objects with .name, .value, .domain for compatibility
            class _Cookie:
                def __init__(self, d):
                    self.name = d.get("name", "")
                    self.value = d.get("value", "")
                    self.domain = d.get("domain", "")
            cookie_jar = [_Cookie(c) for c in raw_cookies]
        except Exception as e:
            raise RuntimeError(
                f"Could not read {browser} cookies via rookiepy: "
                f"{scrub_url_credentials(e)}\n"
                f"Make sure {browser} is closed and you have permission."
            )
    else:
        browser_funcs = {
            "chrome": browser_cookie3.chrome,
            "firefox": browser_cookie3.firefox,
            "edge": browser_cookie3.edge,
            "brave": browser_cookie3.brave,
            "opera": browser_cookie3.opera,
        }
        try:
            cookie_jar = []
            seen = set()
            for domain in spec["domains"]:
                kwargs = {"domain_name": domain}
                if cookie_file is not None:

View on GitHub (pinned to 93ae1d18c3)