Skip to content

ArtemisAI/Crewright

Repository files navigation

Crewright 👻

The Parasitic Browser Bridge for CrewAI. Control your live, authenticated Chrome session with AI Agents.

Status MCP Stack CrewAI


🧐 What is this?

Crewright is the missing link between CrewAI and your browser. > "Like Playwright, but for CrewAI!"

Unlike Playwright MCP (which launches a clean, empty browser), Crewright connects to your already open Chrome window.

  • Login to nothing: The agent uses your cookies.
  • Bypass everything: Cloudflare sees you, not a bot.
  • Visual Feedback: Watch the agent click and type in real-time.

It is designed to work seamlessly with the CrewAI Framework to give your agents "eyes" and "hands" on the web.

🚀 Key Features

  • Parasitic Stealth: zero-config authentication.
  • Manifest V3: Secure, modern Chrome Extension architecture.
  • Native MCP: Works with CrewAI, Claude Desktop, Cursor, and any MCP client.

📦 Installation

1. The Extension (Chrome)

To give CrewAI access to your browser, you need to load the bridge extension.

  1. Open Chrome and navigate to chrome://extensions.
  2. Enable Developer Mode (toggle in the top right corner).
  3. Click Load Unpacked.
  4. Select the src/bridge/extension folder from this directory.
  5. Verify: You should see the Crewright Bridge card with a 👻 icon.
  6. Check: Ensure the toggle is ON.

Note: This extension runs entirely locally. It communicates only with your local Agent. No data is sent to the cloud.

2. The Server (Node.js)

npx @crew-ai/crewright

(Or run locally during dev):

cd src/bridge
npm install
npm run build

⚙️ Configuration (CrewAI)

Standard Setup

from crewai import Agent
from crewai.mcp import MCPServerStdio

crewright_server = MCPServerStdio(
    command="npx",
    args=["@crew-ai/crewright"] 
    # OR local: args=["node", "./path/to/dist/index.js"]
)

agent = Agent(
    role="Browser Pilot",
    goal="Navigate LinkedIn",
    mcps=[crewright_server],
    ...
)

Other Clients

Claude Desktop

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "crewright": {
      "command": "npx",
      "args": ["@crewai/crewright"]
    }
  }
}
Cursor

Go to Cursor Settings -> MCP -> Add new -> Command: npx @crewai/crewright

🛠️ Tools Available

Note

v1.1.0 (Dev Branch) Update: Tool names have been renamed to match Playwright conventions.

Tool Description Playwright Equivalent
navigate(url) Moves the active tab to a new URL. page.goto(url)
get_page_content() Returns the text content of the page. page.content()
click(selector) Clicks a DOM element. page.click(selector)
fill(selector, value) Fills an input field. page.fill(selector, value)
press(key) Simulates specific key press (e.g. 'Enter'). page.press(selector, key)
evaluate(expression) Executes JavaScript in the page context. page.evaluate(expression)
screenshot() Captures a screenshot (Base64). page.screenshot()
hover(selector) Hovers over an element. page.hover(selector)
scroll(direction) Scrolls the viewport ('up', 'down', 'top', 'bottom'). Custom Helper
ask_human(question) Pauses execution and asks YOU for help. CrewAI Exclusive

📚 Documentation

❤️ Support & Sponsorship

This project is open-source and maintained by Daniel Gonzalez (ArtemisAI). If you find this tool useful for your agents, please consider supporting the development!


Built with ❤️ by the ArtemisAI (Daniel Gonzalez) to help out all the bots 🤖 needing good tools.

About

Awesome Tools for CrewAi

Resources

Contributing

Stars

Watchers

Forks

Releases

No releases published

Sponsor this project

Packages

 
 
 

Contributors