{"name":"io.github.apireno/domshell","slug":"apireno-domshell","title":"DOMShell","description":"Drive Chrome with filesystem commands (ls, cd, grep, click, type). One MCP tool, multi-agent.","url":"https://mcp.market/server/apireno-domshell","rating":null,"grade":"A","score":88,"certified":false,"status":"active","category":"productivity","tags":["productivity","ai"],"presence":{"score":41,"stars":53,"forks":6,"downloads_week":176,"last_push_at":"2026-08-14T21:23:42.000Z","license":"MIT"},"uptime":null,"claimed":false,"transport":"npm","callable_via_gateway":false,"default_price_micros":0,"repository":"https://github.com/apireno/DOMShell","website":"https://pireno.com/domshell","version":"2.0.10","remotes":[],"packages":[{"registryType":"npm","identifier":"@apireno/domshell","version":"2.0.10","transport":{"type":"stdio"}},{"registryType":"npm","identifier":"@apireno/domshell","version":"2.0.10","transport":{"type":"streamable-http","url":"http://localhost:3001/mcp"}}],"tools":[{"name":"domshell_about","description":"Report DOMShell runtime identity: MCP server version, bridged extension version (from HELLO handshake), whether an extension is currently connected, and connection timestamp. Use this at drive startup to pin-verify what you're actually talking to, and again on any surprising failure (silent shared-fallback, unexpected DOM, missing lane marker) to disambiguate stale-log/wrong-extension issues from ","write_action":false,"price_micros":0,"input_schema":null},{"name":"domshell_back","description":"Navigate back in browser history. Equivalent to the browser back button. Automatically refreshes the AX tree after navigation. Use this instead of domshell_navigate when returning to a previously visited page — it's faster (uses browser cache) and doesn't require remembering the URL.","write_action":false,"price_micros":0,"input_schema":null},{"name":"domshell_call","description":"Call a global JavaScript function by name. Arguments are auto-parsed as JSON if valid, otherwise passed as strings. Write-tier — requires --allow-write. Examples: call getCount call getMessage Agent call resetCount call setConfig {\"key\": \"value\"}","write_action":false,"price_micros":0,"input_schema":null},{"name":"domshell_cat","description":"Read detailed metadata about a DOM element: role, type, AX ID, DOM backend ID, value, child count, text content (textContent), visible text (innerText — only rendered text, respects CSS visibility), and outerHTML snippet.","write_action":false,"price_micros":0,"input_schema":null},{"name":"domshell_cd","description":"Change directory — sets your scope for all subsequent commands (ls, find, grep, text all operate relative to current directory). Paths: 'main/form', '..', '~' (browser root), '~/tabs/<id>', '~/tabs/<pattern>', '%here%' (focused tab). When to cd: - cd into a SECTION (article, main, sidebar) to scope find/grep/ls to that area - cd into ~/tabs/<id> to switch between tabs - cd .. to go up when done wi","write_action":false,"price_micros":0,"input_schema":null},{"name":"domshell_click","description":"Click a DOM element. May trigger navigation, form submission, or page changes. The DOM tree auto-refreshes on the next command. After clicking: use domshell_ls or domshell_pwd to verify the page actually changed. Some clicks (like search buttons) may need a domshell_refresh to see updated content. If clicking a search/submit button doesn't navigate, try using domshell_navigate as a fallback.","write_action":false,"price_micros":0,"input_schema":null},{"name":"domshell_close","description":"Close a tab. With no arguments, closes the current tab and returns to browser root. With a tab ID, closes that specific tab. Use after extracting data from a page to keep the tab count manageable.","write_action":false,"price_micros":0,"input_schema":null},{"name":"domshell_diff","description":"Compare the current AX tree against the snapshot taken before the last write/navigate action (click, type, submit, select, navigate, open, back, forward, scroll). Shows added, removed, and changed elements. Use after a click or form submission to see exactly what changed on the page instead of re-exploring with ls/find.","write_action":false,"price_micros":0,"input_schema":null},{"name":"domshell_each","description":"Run a command across multiple open tabs. Iterates over all non-chrome tabs (optionally filtered by title/URL pattern), switches into each, runs the command, and collects results. Restores the original tab when done. Options: --pattern FILTER Only tabs whose title or URL contains FILTER --limit N Process at most N matching tabs Examples: each eval document.title Title from every tab each --pattern ","write_action":true,"price_micros":0,"input_schema":null},{"name":"domshell_eval","description":"Evaluate a JavaScript expression in the tab context. Returns the result. WRITE TIER as of 2.0.8 — the expression runs via CDP Runtime.evaluate with no side-effect gate, so any JavaScript can mutate DOM/window/global state. Requires --allow-write, same as domshell_js. Use for one-off expressions (property reads, single-value extractions); prefer domshell_js for multi-statement scripts. Examples: ev","write_action":false,"price_micros":0,"input_schema":null},{"name":"domshell_execute","description":"Run DOMShell commands to browse and read web pages — the primary DOMShell interface. DOMShell maps a page's accessibility tree to a filesystem: containers are directories, interactive elements are files; browser windows and tabs are part of the same hierarchy. Send ONE command, or MULTIPLE commands separated by newlines to run a whole workflow in a single call: open https://example.com cd main tex","write_action":true,"price_micros":0,"input_schema":null},{"name":"domshell_extract_links","description":"Extract all links under the current directory or a named child as a clean numbered list in [text](url) format. Purpose-built for link extraction — returns display text and URLs in one call. Examples: extract_links All links under current directory extract_links main -n 20 First 20 links in 'main' section","write_action":false,"price_micros":0,"input_schema":null},{"name":"domshell_extract_table","description":"Extract a table element as structured markdown or CSV. Reads all rows and cells, returns formatted output. First row is treated as the header. Examples: extract_table table_1234 Markdown table extract_table table_1234 --format csv CSV format extract_table table_1234 -n 10 First 10 rows only","write_action":false,"price_micros":0,"input_schema":null},{"name":"domshell_find","description":"Deep recursive search from the CURRENT DIRECTORY downward. Scope matters: cd into a section first, then find, to get only that section's elements (fewer, more relevant results). Returns full paths to matching elements. Key flags: --type ROLE Filter by AX role. Accepts exact roles (link, button, heading, textbox, table, list) AND natural aliases: input→textbox/searchbox/combobox, dropdown→combobox/","write_action":false,"price_micros":0,"input_schema":null},{"name":"domshell_focus","description":"Focus an input element. Use before 'domshell_type' to direct keyboard input to the right field.","write_action":false,"price_micros":0,"input_schema":null},{"name":"domshell_for","description":"Iterate over command output lines. Runs a source command, splits output into lines, and for each line replaces {} in the action template and executes it. Capped at 50 items and 120 seconds. Separator is ' : ' (space-colon-space) to avoid conflicts with URL colons. Examples: for \"find --type heading -n 3\" : text {} for \"eval [...urls].join('\\\\ ')\" : open {}","write_action":false,"price_micros":0,"input_schema":null},{"name":"domshell_forward","description":"Navigate forward in browser history. Only works after a 'back' command. Automatically refreshes the AX tree after navigation.","write_action":false,"price_micros":0,"input_schema":null},{"name":"domshell_functions","description":"List callable global JavaScript functions on the current page. Shows function name, arity (parameter count), and parameter names. Useful for discovering page APIs (e.g. MediaWiki's mw.config.get on Wikipedia). Examples: functions All non-standard window functions functions mw Functions matching 'mw' functions --json Machine-parseable output","write_action":false,"price_micros":0,"input_schema":null},{"name":"domshell_grep","description":"Search for elements matching a pattern. Matches against name, role, and value. Case-insensitive. By default, searches only IMMEDIATE children. Use recursive: true to search all descendants — this is almost always what you want for finding sections or elements by name. grep is the primary section-discovery tool. Its output gives you element names and paths that you then use with cd, text, find, and","write_action":false,"price_micros":0,"input_schema":null},{"name":"domshell_here","description":"Jump to the active tab in the last focused Chrome window. Use this to quickly enter whichever tab the user is currently looking at, without needing to know the tab ID.","write_action":false,"price_micros":0,"input_schema":null},{"name":"domshell_js","description":"Execute arbitrary JavaScript in the current tab and return the result. Use this for complex DOM queries, CSS selector extraction, or any operation that would take multiple DOMShell commands. The code runs in the page context with full DOM access. Promises are automatically awaited. Results are JSON-serialized (truncated at 10000 chars). Common patterns: js document.title js document.querySelectorA","write_action":true,"price_micros":0,"input_schema":null},{"name":"domshell_ls","description":"List children of the current directory. In the DOM tree: shows elements as files and directories. At the browser level (~): shows tabs/windows. Flags: -l Long format (more detail per element) --meta Show DOM properties (href, src, id) inline — great for extracting links --text Show visible text preview per element -r Recursive listing -n N Limit to N results --offset N Skip first N children (pagin","write_action":false,"price_micros":0,"input_schema":null},{"name":"domshell_navigate","description":"Navigate the current tab to a URL. Automatically rebuilds the accessibility tree after navigation completes. Requires a tab context (cd into a tab first). Use this to go to a specific website without opening a new tab.","write_action":false,"price_micros":0,"input_schema":null},{"name":"domshell_open","description":"Open a URL in a new tab and enter it (path becomes ~/tabs/<id>). Automatically builds the accessibility tree after page loads. Works from any location. After opening a page, a typical extraction workflow is: 1. open URL 2. find the section you need (find --type heading, or grep section_name with recursive: true) 3. cd into the container 4. text (for content) or find --type link --meta (for links)","write_action":false,"price_micros":0,"input_schema":null},{"name":"domshell_pwd","description":"Print the current working directory path in the DOM tree.","write_action":false,"price_micros":0,"input_schema":null},{"name":"domshell_read","description":"Structured subtree extraction — returns the hierarchy of elements under the current directory or a named child, with roles, names, and values in one call. Think of it as 'tree' + 'cat' combined: you get the structure AND the content. Excellent for tables, lists, and nested sections. A single read on a table returns all rows and cells with their roles and values, replacing N separate text calls. Fl","write_action":false,"price_micros":0,"input_schema":null},{"name":"domshell_refresh","description":"Force re-fetch the Accessibility Tree. Use after page navigation or significant DOM changes. Note: the tree also auto-refreshes when changes are detected.","write_action":false,"price_micros":0,"input_schema":null},{"name":"domshell_screenshot","description":"Capture a PNG screenshot of the current tab. Returns the image for visual inspection. Useful for understanding page layout on unfamiliar sites — one screenshot can replace multiple exploration calls (tree, ls, find) by showing you exactly what the page looks like.","write_action":false,"price_micros":0,"input_schema":null},{"name":"domshell_script","description":"Save and run multi-command scripts. Scripts persist across service worker restarts. Subcommands: script list List saved scripts script save <name> cmd1 ; cmd2 Save commands (separated by ' ; ') script show <name> Show commands in a script script run <name> [args...] Execute with $1, $2 variable substitution script delete <name> Delete a script IMPORTANT: Multi-word arguments for 'script run' MUST ","write_action":false,"price_micros":0,"input_schema":null},{"name":"domshell_scroll","description":"Scroll the page or scroll a specific element into view. Use this when content is below the fold or when you need to reach elements not currently visible. Modes: scroll down [N] Scroll page down by N viewport heights (default: 1) scroll up [N] Scroll page up by N viewport heights (default: 1) scroll element_name Scroll a specific element into the center of the viewport Returns current scroll positi","write_action":false,"price_micros":0,"input_schema":null},{"name":"domshell_select","description":"Select an option from a <select> dropdown element. Matches by option value first, then by visible text (case-insensitive). Dispatches change and input events to trigger form updates. Examples: select language_dropdown en select country_select United States","write_action":false,"price_micros":0,"input_schema":null},{"name":"domshell_submit","description":"Atomic form submission — focuses input, clears existing value, types new value, then submits (clicks button or presses Enter). Replaces the 3-step focus → type → click pattern in one reliable call. Examples: submit search_input 'machine learning' Type and press Enter submit search_input 'machine learning' --submit search_btn Type and click button","write_action":true,"price_micros":0,"input_schema":null},{"name":"domshell_tabs","description":"List all open browser tabs with their IDs, titles, URLs, and window info. Use this to find the right tab before switching. Equivalent to 'ls ~/tabs/'.","write_action":false,"price_micros":0,"input_schema":null},{"name":"domshell_text","description":"Extract ALL text content from the current directory or a named child, including every descendant. Returns full textContent in a single call. The name parameter lets you read any child without cd'ing into it first: text paragraph_2994 Read a paragraph's text without cd'ing into it text table_1234 Read an ENTIRE table (all rows, all cells) in one call text list_5678 Read all list items at once text ","write_action":false,"price_micros":0,"input_schema":null},{"name":"domshell_tree","description":"Show a tree view of the current directory in the DOM, displaying the hierarchy of elements with type prefixes [d]=directory, [x]=interactive, [-]=static.","write_action":false,"price_micros":0,"input_schema":null},{"name":"domshell_type","description":"Type text into the currently focused element. Use domshell_focus first to target an input field. For search forms: after typing, you may need to either: 1. click the submit/search button, OR 2. type '\\ ' to simulate pressing Enter If the page doesn't navigate after form submission, use domshell_navigate as a fallback to go to the expected URL directly.","write_action":false,"price_micros":0,"input_schema":null},{"name":"domshell_wait","description":"Wait for an element to appear in the AX tree. Polls the tree every 500ms until the element is found or timeout is reached. Use after clicks or navigation that trigger async content loading (SPAs, AJAX). Examples: wait results_list Wait for search results wait submit_btn --type button Wait for a button to appear wait loading_spinner --timeout 10 Wait up to 10 seconds","write_action":false,"price_micros":0,"input_schema":null},{"name":"domshell_watch","description":"Re-run a command periodically and collect results. Useful for monitoring dynamic content changes within a single tool call instead of making N separate calls. Options: --interval N Seconds between runs (default: 2, min: 0.5) --times N Number of iterations (default: 5, max: 100) --until-change Stop early when output differs from previous iteration Total runtime capped at 120 seconds. Examples: watc","write_action":false,"price_micros":0,"input_schema":null},{"name":"domshell_whoami","description":"Check authentication status by examining cookies for the current page. Shows session cookies and expiry.","write_action":false,"price_micros":0,"input_schema":null}],"scan":{"score":88,"grade":"A","scanned_at":"2026-09-23T11:54:05.086Z","report":{"scannerVersion":"0.1.9","scannedAt":"2026-09-23T11:54:05.066Z","components":{"code":{"score":25,"max":25,"notes":["9 source files scanned","9 source files scanned"]},"reliability":{"score":-1,"max":20,"notes":["no gateway calls yet and no remote to probe"]},"poisoning":{"score":-1,"max":15,"notes":["tools not inspected (local package is not executed); not counted"]},"auth":{"score":12,"max":15,"notes":["local package, no credentials required"]},"maintenance":{"score":12,"max":15,"notes":["last push 40 days ago"]},"identity":{"score":8,"max":10,"notes":["registry namespace matches repository owner","GitHub account older than a year"]}},"findings":[],"inputs":{"packages":[{"registryType":"npm","identifier":"@apireno/domshell","version":"2.0.10","found":true,"license":"MIT","hasInstallScripts":false,"dependencyCount":4,"publishedAt":"2026-08-14T21:39:44.245Z","repositoryUrl":"git+https://github.com/apireno/DOMShell.git","weeklyDownloads":88},{"registryType":"npm","identifier":"@apireno/domshell","version":"2.0.10","found":true,"license":"MIT","hasInstallScripts":false,"dependencyCount":4,"publishedAt":"2026-08-14T21:39:44.245Z","repositoryUrl":"git+https://github.com/apireno/DOMShell.git","weeklyDownloads":88}],"repo":{"found":true,"owner":"apireno","repo":"DOMShell","archived":false,"pushedAt":"2026-08-14T21:23:42Z","stars":53,"forks":6,"openIssues":39,"ownerType":"User","ownerAvatarUrl":"https://avatars.githubusercontent.com/u/139802728?v=4","ownerCreatedAt":"2023-07-17T17:59:15Z","license":"MIT"},"icon":{"url":"https://pireno.com/apple-touch-icon.png","source":"site","width":180,"height":180},"presence":{"stars":53,"forks":6,"downloadsWeek":176,"license":"MIT","lastPushAt":"2026-08-14T21:23:42.000Z","score":41}}}},"grade_history":[],"reviews":[]}