web-interact

A command-line browser controller that opens websites and performs actions such as filling fields, clicking buttons, reading page data, and taking screenshots.

In plain words
What is it for?
Use it to test web apps, submit forms, log in, collect information from pages, take screenshots, and automate browser workflows.
Why use it?
It removes the need to perform repetitive website tasks by hand or write browser-control code for each action. It also provides a repeatable sequence for inspecting pages and acting on the right controls.

Skill for Claude CodeCodex

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add skills/johnkozaris/web-interact-plugin/web-interact
Any agent
npx skills add johnkozaris/web-interact-plugin --skill web-interact
Clone the repo
git clone --depth 1 https://github.com/johnkozaris/web-interact-plugin

Made for: Claude Code, Codex.

Per session 144 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 5,330 The whole file, excluding the scripts and references it only reads on demand.
Security scan C 2 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.00144 $0.05330
Opus 5 $0.00072 $0.02665
Sonnet 5 $0.00029 $0.01066
Haiku 4.5 $0.00014 $0.00533

Measured 2d ago against content hash 91971c3af82d, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade C, and why

web-interact scanned grade C with 2 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 2d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Downloads and executes remote codehighSupply chain

curl | sh runs whatever the server returns today, which is not necessarily what it returned when this was reviewed.

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/johnkozaris/web-interact/releases/latest/download/web-interact-installer.sh | sh

Makes network callslowCapability

Not a fault in itself. Listed so you know the mod talks to something, and to what.

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/johnkozaris/web-interact/releases/latest/download/web-interact-installer.sh | sh
skills/web-interact/SKILL.md · 493 lines

How it starts

The opening of the file, as written. The whole thing — 493 lines — stays where its author put it; the contents beside it link to each section on GitHub.

web-interact

Browser automation CLI. Each shell command maps to one browser action. Uses Playwright by default (switch to Patchright with web-interact mode assistant). Designed for automating your own web applications — please use responsibly.

Core loop

The workflow is always: opendiscover → act by index → re-discover after changes.

web-interact --headless open "https://example.com"
web-interact --headless discover        # → [1] input "Email" [2] input[password] ...
web-interact --headless fill 1 "[email protected]"
web-interact --headless fill 2 "password"
web-interact --headless click 3         # submit — triggers navigation
web-interact --headless discover        # ALWAYS re-discover after navigation or form submission

Re-discover after: navigation, form submission, AJAX updates, tab switches, or any action that changes the page. Indices auto-refresh when the URL changes, but explicitly re-discover after same-page DOM changes (modals, accordions, dynamic content).

Output contract

  • Actions (click, fill, press, scroll, etc.): no output on success (exit 0). Error text on stderr (exit 1).
  • Getters (get url, get title, eval): raw value on stdout.
  • Data (tab list, cookies get, storage local): JSON on stdout.
  • Screenshots: file path on stdout.
  • Vision (--vision): plain screenshot path on stderr as vision:/path/file.png.
  • Vision + annotate (--vision --annotate): annotated screenshot with element overlays.

Key distinctions

  • fill clears existing value then types. Use for form fields.
  • type appends to existing value. Use for search boxes with autocomplete, or adding to existing text.
  • click by index uses CDP mouse events (works on any element including React/Vue/Canvas).
  • click by CSS selector uses JS DOM click (simpler, works for standard elements).
  • keyboard type "text" types without targeting an element (for canvas apps, active element input).
  • mouse click 100 200 clicks at viewport coordinates (for canvas/WebGL apps where elements aren't in DOM).

Read the full file on GitHub · 493 lines

Files

What ships with it

5 files beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 2d ago First seen · 493 lines · 144 tokens per session scan C 91971c3af82d

Subscribe to this mod's changes

web-interact is a skill published in the GitHub repository johnkozaris/web-interact-plugin (2 stars, last pushed 5mo ago), licensed MIT. It adds 144 tokens to every session and 5,330 once invoked, about $0.0007 per session on Opus 5. A static security scan graded it C with 2 findings (downloads and executes remote code, makes network calls). No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.

Related

Other skills, from other repositories

fanqie-publisher

Publish prepared novel chapters from local Markdown files to the Fanqie Novel writer web backend via browser automation. Use when the user wants to upload chapters, continue publishing unpublished chapters, save or reuse login state, or schedule Fanqie chapter releases from a local directory.

amm10090/fanqie-publisher-skill · 59 tokens

firefox-control

Use when you need to automate Firefox via WebDriver BiDi — tab listing, JS evaluation, screenshots, DOM helpers. TEST TOOL — Firefox sets navigator.webdriver=true.

vre/flow-state · 37 tokens

xiaohongshu-ops

把 Hermes Agent 变成你的小红书运营助手 — 首页分析、账号诊断、选题灵感、内容创作、自动发布、评论回复、爆款复刻、知识库沉淀。全链路 SOP 覆盖,基于浏览器自动化(CDP)。.

pigbiglong/xiaohongshu-ops-skill · 71 tokens

api-skill-builder

根据用户需求,通过逆向网页API生成可复用的API取数Skill。适用于:图表数据(Canvas/ECharts/G2等前端渲染的图表)、需要登录态的平台数据、任何通过浏览器能看到但DOM中无法直接提取的数据。核心方法:鉴权探测决定架构 → 找到API endpoint → 逆向请求参数 → 验证数据 → 生成标准化Skill。.

ClawCap/ManoBrowser · 99 tokens

platform-data-explorer

通用平台探索 Skill。使用 DataSaver Chrome MCP 工具对目标平台(URL/页面/模块)进行系统性探索,发现该平台可以做哪些用户操作类和数据提取类 Skill,输出 Skill 提案清单供用户确认,确认后按类型分流创建:API取数类调用 api-skill-builder,浏览器操作类调用 chrome-workflow-build。.

ClawCap/ManoBrowser · 87 tokens

browser-use

Automates browser interactions for web testing, form filling, screenshots, and data extraction. Use when the user needs to navigate websites, interact with web pages, fill forms, take screenshots, or extract information from web pages.

kyopark2014/agent-plugins · 47 tokens