skills.rest
GregM1991
GregM1991COMMUNITY
Explore all skills by this author →
WebsiteGitHub

capture-agent-browser-auth-state

Capture headed browser login state and transfer it to headless servers for gated sites.

Updated Apr 28, 2026
Search Tags:#authentication#browser automation#web scraping#ssh#session state#agent-browser#headless browser
One-click install
npx skills add https://github.com/GregM1991/skills --skill capture-agent-browser-auth-state-gregm1991
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: capture-agent-browser-auth-state
Source: https://github.com/GregM1991/skills/tree/main/skills/capture-agent-browser-auth-state
Command: npx skills add https://github.com/GregM1991/skills --skill capture-agent-browser-auth-state-gregm1991

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires agent-browser, and includes scripts (resource) components.

What problem does it solve? Automating access to login-gated websites (like D&D Beyond) from a headless server is blocked when the site requires interactive login, MFA, CAPTCHA, or SSO. This Skill captures the authenticated browser state once on a GUI machine and transfers it to a server, avoiding the need to install VNC or desktop environments on the server. ## Core Features & Use Cases - Headed Login Capture: Runs a bundled bash script that opens a headed agent-browser session so the user can complete login manually, including MFA and CAPTCHA flows. - Auth Verification Before Saving: Opens a gated verify URL and asks the user to confirm access before saving the state, preventing useless state files. - Secure State Transfer: Saves the state JSON with mode 600 and optionally copies it over SSH/SCP to a private remote directory with mode 700. - Use Case: You run a D&D Beyond campaign automation on a headless home server. Run the script on your laptop, log in once, and the authenticated session state is copied to the server for headless agent-browser runs. ## Quick Start Run the bundled capture script on a GUI machine with your login URL, verify URL, and server target to save and transfer the authenticated browser state.

Frequently Asked Questions about capture-agent-browser-auth-state

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate login to a website that requires MFA or CAPTCHA on a headless server?▼

Perform the interactive login once on a GUI machine using a headed browser, save the authenticated session state to a JSON file, and copy it to the server. The headless browser then loads that state file to access gated pages without repeating the login.

How do I transfer browser session state to a server over SSH?▼

Run the capture script with the --server and --remote-dir options. It creates the remote directory with mode 700 via SSH and copies the state file with SCP, keeping the session data in a private location.

Is it safe to store browser session state files?▼

State files contain cookies and session tokens, so treat them like passwords. The script saves them with mode 600, and you should never print, commit, or index their contents. Prefer state JSON over copying full browser profiles.

What happens when the captured browser session expires?▼

When auth expires, headless requests will redirect to the login page. Recapture the state on the GUI machine by rerunning the script and replace the old state file on the server with the new copy.

Should I install VNC or a desktop environment on my server for browser logins?▼

No. Capturing state on a separate GUI machine and transferring the state file avoids installing and maintaining VNC or desktop stacks on servers, reducing attack surface and maintenance burden.

Related Skills

Explore More Software Engineering Skills→
tribes-protocoltribes-protocol
1

tribes-login

Runs tribes-cli login in the background and surfaces the browser approval URL until the token persists.

Official
Intermediate
wangfeivwangfeiv

setup-browser-cookies

Transfer login session cookies from browsers to headless browsing environments.

Community
Intermediate
wecode-aiwecode-ai
772

subscription-manager

Create and manage scheduled subscription tasks using cron expressions, intervals, or one-time triggers.

Official
Intermediate
bifrost-proxybifrost-proxy
112

site-cookie-login

Automate website logins with Puppeteer and save cookies to an environment variable file.

Community
Advanced