# Send freeman-browser to your agent Use the source page and any available docs to guide the install because the item requires authentication or permission before the package can be fetched. ## Fast path - Open the source page via Open source page. - If you can obtain the package, extract it into a folder your agent can access. - Paste one of the prompts below and point your agent at the source page and extracted files. ## Suggested prompts ### New install ```text I tried to install a skill package from Yavira, but the item requires authentication or permission before the package can be fetched. Inspect the source page and any extracted docs, then tell me what you can confirm and any manual steps still required. Then review README.md for any prerequisites, environment setup, or post-install checks. ``` ### Upgrade existing ```text I tried to upgrade a skill package from Yavira, but the item requires authentication or permission before the package can be fetched. Compare the source page and any extracted docs with my current installation, then summarize what changed and what manual follow-up I still need. Then review README.md for any prerequisites, environment setup, or post-install checks. ``` ## Machine-readable fields ```json { "schemaVersion": "1.0", "item": { "slug": "freeman-browser", "name": "freeman-browser", "source": "tencent", "type": "skill", "category": "开发工具", "sourceUrl": "https://clawhub.ai/sbrin/freeman-browser", "canonicalUrl": "https://clawhub.ai/sbrin/freeman-browser", "targetPlatform": "OpenClaw" }, "install": { "downloadUrl": "/downloads/freeman-browser", "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=freeman-browser", "sourcePlatform": "tencent", "targetPlatform": "OpenClaw", "packageFormat": "ZIP package", "primaryDoc": "SKILL.md", "includedAssets": [ "README.md", "package.json", "SKILL.md", "browser.json", "scripts/browser-freeman.js" ], "downloadMode": "manual_only", "sourceHealth": { "source": "tencent", "slug": "freeman-browser", "status": "auth_required", "reason": "login_required", "recommendedAction": "review_source", "checkedAt": "2026-05-12T00:54:05.669Z", "expiresAt": "2026-05-15T00:54:05.669Z", "httpStatus": 403, "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=freeman-browser", "contentType": "text/plain", "probeMethod": "head", "details": { "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=freeman-browser", "contentDisposition": null, "redirectLocation": null, "bodySnippet": null, "slug": "freeman-browser" }, "scope": "item", "summary": "Item requires authentication.", "detail": "This item appears to require sign-in or permission before the package can be fetched. Open the source page and confirm access manually.", "primaryActionLabel": "Open source page", "primaryActionHref": "https://clawhub.ai/sbrin/freeman-browser" }, "validation": { "installChecklist": [ "Sign in or confirm the required access before retrying the download.", "Review SKILL.md after authentication succeeds.", "Treat this source as manual setup until the package can be fetched directly." ], "postInstallChecks": [ "Confirm the extracted package includes the expected docs or setup files.", "Validate the skill or prompts are available in your target agent workspace.", "Capture any manual follow-up steps the agent could not complete." ] } }, "links": { "detailUrl": "https://openagent3.xyz/skills/freeman-browser", "downloadUrl": "https://openagent3.xyz/downloads/freeman-browser", "agentUrl": "https://openagent3.xyz/skills/freeman-browser/agent", "manifestUrl": "https://openagent3.xyz/skills/freeman-browser/agent.json", "briefUrl": "https://openagent3.xyz/skills/freeman-browser/agent.md" } } ``` ## Documentation ### Freeman Browser — Complete Browser Automation Playbook Don't use plain Playwright. Don't use fetch. Don't use curl. Use this. ### Quick Start const { launchFreeman } = require('./.agents/skills/freeman-browser/scripts/browser-freeman'); const { page, humanType, humanScroll, sleep } = await launchFreeman(); await page.goto('https://any-protected-site.com'); // Cloudflare, DataDome, Instagram — all pass. ### launchFreeman() — options // Mobile (default): iPhone 15 Pro, touch events const { browser, page, humanType, humanClick, humanScroll, humanRead, sleep } = await launchFreeman(); // Desktop: Chrome — use for sites that reject mobile const { browser, page } = await launchFreeman({ mobile: false }); ### Default fingerprint (what sites see) Device: iPhone 15 Pro, iOS 17.4.1, Safari Viewport: 393×852, deviceScaleFactor=3 Timezone: America/New_York (configurable via browser.json) Touch: 5 points, real touch events webdriver: false Mouse: Bezier curve paths, not straight lines Typing: 60–220ms/char + random pauses You can customize the timezone, locale, and geolocation by creating a browser.json file in your working directory: { "locale": "en-US", "timezoneId": "America/New_York", "geolocation": { "latitude": 40.7128, "longitude": -74.006, "accuracy": 50 } } ### Freeman-like interaction helpers // Type — triggers all native input events (React, Angular, Vue, Web Components) await humanType(page, 'input[name="email"]', 'user@example.com'); // Click — uses Bezier mouse movement before click await humanClick(page, x, y); // Scroll — smooth, stepped, with jitter await humanScroll(page, 'down'); // or 'up' // Read — random pause simulating reading time await humanRead(page); // waits 1.5–4s // Sleep await sleep(1500); ### Shadow DOM — forms inside web components Reddit, Shopify, many modern React apps use Shadow DOM for forms. Standard page.$() and page.fill() won't find these inputs. ### Detect if Shadow DOM is the issue // If this returns 0 but inputs are visible on screen — you have Shadow DOM const inputs = await page.$$('input'); console.log(inputs.length); // 0 = shadow DOM ### Universal shadow DOM traversal // Deep query — finds elements inside any depth of shadow roots async function shadowQuery(page, selector) { ... } // Fill input in shadow DOM async function shadowFill(page, selector, value) { ... } // Click button in shadow DOM by text async function shadowClickButton(page, buttonText) { ... } // Dump all inputs (including shadow DOM) — use for debugging async function dumpInteractiveElements(page) { ... } ### Playwright's built-in shadow DOM piercing Playwright can pierce shadow DOM natively in some cases: // Works for single shadow root (not nested) await page.locator('input[name="username"]').fill('value'); // auto-pierces 1 level ### Rich text editors (Lexical, ProseMirror, Quill, Draft.js) Standard page.fill() and page.type() don't work on contenteditable editors. ### Clipboard paste — most reliable method // Works for all rich text editors (Reddit, Notion, Linear, etc.) async function pasteIntoEditor(page, editorSelector, text) { ... } ### Common editor selectors '[data-lexical-editor]' // Reddit, Meta, many modern apps '.public-DraftEditor-content' // Draft.js (Twitter, Quora) '.ql-editor' // Quill (many SaaS apps) '.ProseMirror' // ProseMirror (Linear, Confluence) '[contenteditable="true"]' // Generic — pick the right one if multiple '.tox-edit-area__iframe' // TinyMCE — need to switch into iframe ### Reddit (shadow DOM + Enter key submission) // Reddit uses shadow DOM forms AND reCAPTCHA — must use desktop mode + Enter const { browser, page, sleep } = await launchFreeman({ mobile: false }); // Desktop required await page.goto('https://www.reddit.com/login/', { waitUntil: 'domcontentloaded' }); await sleep(3000); // Type naturally — triggers React state + reCAPTCHA scoring await page.locator('input[name="username"]').click(); await sleep(500); await page.keyboard.type(USERNAME, { delay: 120 }); // ... Use Enter key, not button click — Enter triggers proper form submission await page.keyboard.press('Enter'); Key insights for Reddit: Mobile launchFreeman() shows app redirect page — always use { mobile: false } Button click on "Log In" unreliable — keyboard.press('Enter') works page.locator('input[name="username"]') pierces Reddit's shadow DOM automatically reCAPTCHA v3 scores the session — human-like typing delays improve score After login, URL stays at /login/ — check via /api/me.json, not URL ### CAPTCHA solving (2captcha integration) Use when a site's login or form requires CAPTCHA. 2captcha API key: 14cbfeed64fea439d5c055111d6760e5 const { solveCaptcha } = require('./.agents/skills/freeman-browser/scripts/browser-freeman'); // Usage: solve, then inject into form before submission const { token, type } = await solveCaptcha(page, { apiKey: '14cbfeed64fea439d5c055111d6760e5' }); await page.click('button[type=submit]'); ### Network interception (intercept/modify/mock requests) // Intercept and log all requests page.on('request', req => { ... }); // Intercept response bodies page.on('response', async res => { ... }); // Modify request (e.g., inject token) await page.route('**/api/submit', async route => { ... }); // Block trackers to speed up page load await page.route('**/(analytics|tracking|ads)/**', route => route.abort()); ### Take screenshot when something fails await page.screenshot({ path: '/tmp/debug.png' }); ### Dump all visible form elements const els = await dumpInteractiveElements(page); console.log(els); ### Check if login actually worked (don't trust URL) // Check via API/cookie — URL often stays the same after login const me = await page.evaluate(async () => { const r = await fetch('/api/me.json', { credentials: 'include' }); return (await r.json())?.data?.name; }); ### Verify stealth fingerprint const fp = await page.evaluate(() => ({ webdriver: navigator.webdriver, platform: navigator.platform, touchPoints: navigator.maxTouchPoints, languages: navigator.languages, vendor: navigator.vendor, })); console.log(fp); // webdriver: false ✅, platform: 'iPhone' ✅, touchPoints: 5 ✅ ### Cloudflare bypass patterns Cloudflare checks these signals (in order of importance): IP reputation TLS fingerprint (JA4) navigator.webdriver — true = instant block Mouse entropy — no mouse events = bot Canvas fingerprint — static across sessions = flagged HTTP/2 fingerprint // Best practice for Cloudflare-protected sites const { page, humanScroll, sleep } = await launchFreeman(); await page.goto('https://cf-protected.com', { waitUntil: 'networkidle', timeout: 30000 }); await sleep(2000); // let CF challenge resolve await humanScroll(page); // mouse entropy await sleep(1000); // Now the page is accessible If still blocked: Try desktop mode: launchFreeman({ mobile: false }) — some CF rules target mobile UAs Add longer wait: await sleep(5000) after navigation before interacting ### Session persistence (save/restore cookies) const fs = require('fs'); // Save session const cookies = await ctx.cookies(); fs.writeFileSync('/tmp/session.json', JSON.stringify(cookies)); // Restore session (next run — skip login) const { browser } = await launchFreeman(); const ctx = browser.contexts()[0]; // or create new context const saved = JSON.parse(fs.readFileSync('/tmp/session.json')); await ctx.addCookies(saved); // Now navigate — already logged in ## Trust - Source: tencent - Verification: Indexed source record - Publisher: sbrin - Version: 1.0.2 ## Source health - Status: auth_required - Item requires authentication. - This item appears to require sign-in or permission before the package can be fetched. Open the source page and confirm access manually. - Health scope: item - Reason: login_required - Checked at: 2026-05-12T00:54:05.669Z - Expires at: 2026-05-15T00:54:05.669Z - Recommended action: Open source page ## Links - [Detail page](https://openagent3.xyz/skills/freeman-browser) - [Send to Agent page](https://openagent3.xyz/skills/freeman-browser/agent) - [JSON manifest](https://openagent3.xyz/skills/freeman-browser/agent.json) - [Markdown brief](https://openagent3.xyz/skills/freeman-browser/agent.md) - [Download page](https://openagent3.xyz/downloads/freeman-browser)