Metadata-Version: 2.5
Name: kitsune-browser-mcp
Version: 0.1.0
Summary: MCP server that lets AI agents drive your running Firefox or Zen browser through an extension.
Project-URL: Homepage, https://github.com/junyeong-nero/kitsune
Project-URL: Documentation, https://github.com/junyeong-nero/kitsune/blob/main/docs/guide.md
Project-URL: Issues, https://github.com/junyeong-nero/kitsune/issues
Project-URL: Changelog, https://github.com/junyeong-nero/kitsune/releases
Author: junyeong-nero
License-Expression: MIT
License-File: LICENSE
Keywords: ai-agents,browser-automation,firefox,mcp,zen-browser
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Operating System :: MacOS
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Topic :: Internet :: WWW/HTTP :: Browsers
Classifier: Topic :: Software Development :: Testing
Requires-Python: >=3.10
Requires-Dist: httpx>=0.27.0
Requires-Dist: mcp[cli]<2,>=1.2.0
Requires-Dist: websockets>=12
Description-Content-Type: text/markdown

# Kitsune

![Kitsune: an orange fox in a browser window, connecting your browser and your AI agent](https://raw.githubusercontent.com/junyeong-nero/kitsune/main/docs/kitsune-hero.svg)

**Your browser. Your agent. One clever bridge.**

Kitsune lets AI agents like Claude Code, Codex, and Pi use the **Firefox, Zen,
or LibreWolf browser you already have open**. Your sessions, cookies, and
extensions stay in place. No Playwright, Chromium, or WebDriver required.

## What can it do?

- **Research the web.** Search, read pages, and summarize findings with links.
- **Interact with websites.** Click, type, select options, and fill forms—even
  on sites you're already signed into.
- **Capture and extract.** Take screenshots or turn page content into text
  and Markdown.
- **Work across tabs.** Keep research and tasks in separate tabs without
  replacing the page you're using.

![Claude Code uses Kitsune to open Hacker News and summarize the top three stories](https://raw.githubusercontent.com/junyeong-nero/kitsune/main/docs/demo.gif)

<sub>A real browser session, captured with Kitsune and sped up.</sub>

## How do I use it?

1. **Connect once.** Register Kitsune with your agent—for Claude Code, one line:

   ```bash
   claude mcp add --scope user kitsune -- uvx --from git+https://github.com/junyeong-nero/kitsune.git kitsune
   ```

   Then [load the browser extension](https://github.com/junyeong-nero/kitsune/blob/main/docs/installation.md#2-install-the-browser-extension).
   You'll need a supported Firefox-family browser, uv, and Git. For other
   agents, version pinning, and upgrades, see [Installation](https://github.com/junyeong-nero/kitsune/blob/main/docs/installation.md).
2. **Keep your browser open.** Kitsune starts its shared bridge automatically.
   Ask your agent to check the connection before your first task.
3. **Ask in plain language.** For example:

   > Open a new tab, search for today's weather near Suseong Lake in Daegu,
   > and summarize the forecast with a link to the source.

   > Inspect this page's form and fill a draft. Don't submit it yet.

   > Open Hacker News and summarize the top three stories with links.

Use a dedicated browser profile and only give access to accounts the agent
needs. Ask for confirmation before sending, purchasing, or deleting anything.
Read the [security guidance](https://github.com/junyeong-nero/kitsune/blob/main/docs/guide.md#security) before using sensitive accounts.

For the details: [Tools](https://github.com/junyeong-nero/kitsune/blob/main/docs/guide.md#tools) ·
[Configuration](https://github.com/junyeong-nero/kitsune/blob/main/docs/guide.md#configuration) ·
[Troubleshooting](https://github.com/junyeong-nero/kitsune/blob/main/docs/guide.md#troubleshooting) ·
[Updating](https://github.com/junyeong-nero/kitsune/blob/main/docs/guide.md#updating-kitsune) ·
[API reference](https://github.com/junyeong-nero/kitsune/blob/main/docs/api-reference.md) ·
[Development](https://github.com/junyeong-nero/kitsune/blob/main/docs/guide.md#development)

---

MIT · Based on ZenLink and ZenLink-MCP by Jay-Quan.
[Credits](https://github.com/junyeong-nero/kitsune/blob/main/docs/guide.md#credits) · [License](https://github.com/junyeong-nero/kitsune/blob/main/LICENSE)
