- name
- ganidhuz-foxx
- description
- >
- license
- MIT
Ganidhuz-FoxX 🦊
Browse X/Twitter through Firefox with your real session cookies. Built because Chromium kept getting bot-blocked by X.
Requirements
- Python 3.7+
- Playwright:
pip install playwright && playwright install firefox - Firefox installed with an active X/Twitter login
- Xvfb display (for headless servers):
Xvfb :1 &
Setup
1. Export your X cookies
Close Firefox first, then:
bash scripts/export-x-cookies.sh
# Cookies saved to secrets/x-cookies.json by default
# Override: FOXX_COOKIES_OUT=/custom/path.json bash scripts/export-x-cookies.shCustom Firefox profile path:
FIREFOX_PROFILE_PATH=/path/to/profile bash scripts/export-x-cookies.sh2. Health check
bash scripts/check-firefox-env.shUsage
Run a plan file:
DISPLAY=:1 python3 scripts/playwright-firefox-control.py --plan /tmp/foxx-plan.jsonPlan Examples
View a profile
{
"needs_gui": true,
"gui_reason": "site_only_action",
"url": "https://x.com/elonmusk",
"cookies_path": "secrets/x-cookies.json",
"steps": [
{"action": "wait", "ms": 4000},
{"action": "screenshot", "path": "/tmp/foxx-profile.png"}
],
"close_delay_ms": 3000
}Search tweets (live)
{
"needs_gui": true,
"gui_reason": "site_only_action",
"url": "https://x.com/search?q=AI+agents&src=typed_query&f=live",
"cookies_path": "secrets/x-cookies.json",
"steps": [
{"action": "wait", "ms": 4000},
{"action": "screenshot", "path": "/tmp/foxx-search.png"}
],
"close_delay_ms": 3000
}Fetch a tweet
{
"needs_gui": true,
"gui_reason": "site_only_action",
"url": "https://x.com/user/status/123456789",
"cookies_path": "secrets/x-cookies.json",
"steps": [
{"action": "wait", "ms": 3000},
{"action": "content", "selector": "article"},
{"action": "screenshot", "path": "/tmp/foxx-tweet.png"}
],
"close_delay_ms": 3000
}Plan Options
| Field | Default | Description |
|---|---|---|
needs_gui | required | Must be true to launch browser |
gui_reason | required | One of: login, captcha, mfa, visual_verification, site_only_action |
url | required | Starting URL |
cookies_path | optional | Path to exported cookies JSON |
close_delay_ms | 3000 | Wait (ms) before closing browser - validate result first |
validation_screenshot | /tmp/firefox-openclaw-validate.png | Auto-taken final screenshot before close |
storage_state_path | optional | Save session state to this path after run |
Supported Step Actions
goto- navigate to URLclick- click element by selectorfill- fill input by selectortype- type text with delaypress- press keyboard keywait- wait mswait_for_selector- wait for elementscreenshot- take screenshotcontent- extract inner text from element
Behaviour Rules
- Always wait for page load (
waitstep, min 3000ms recommended) - A validation screenshot is always taken before closing
- Browser waits
close_delay_msbefore closing - verify result is correct - If cookies expired (redirects to login), re-run
export-x-cookies.sh - Always close browser after task - don't leave it idle