projectdiscovery /katana
A next-generation crawling and spidering framework.
★ 17,849⑂ 1,230👁 97⑃ 1,423● 454▤ 23
More from this author
+6
Daily
17,849
stars
1,230
forks
97
watchers
1,423
prs
454
issues
23
releases
README
A next-generation crawling and spidering framework
Features •
Installation •
Usage •
Scope •
Config •
Filters •
Join Discord
Features
!image
- Fast And fully configurable web crawling
- Standard and Headless mode
- JavaScript parsing / crawling
- Customizable automatic form filling
- Scope control - Preconfigured field / Regex
- Knowledge base - ML page-type / form classification (auto-downloaded model)
- Customizable output - Preconfigured fields
- INPUT - STDIN, URL and LIST
- OUTPUT - STDOUT, FILE and JSON
Installation
katana requires Go 1.26.10+ to install successfully. If you encounter any installation issues, we recommend trying with the latest available version of Go, as the minimum required version may have changed. Run the command below or download a pre-compiled binary from the release page.
console
CGO_ENABLED=1 go install github.com/projectdiscovery/katana/cmd/katana@latest
More options to install / run katana-
Docker
To install / update docker to latest tag -
sh
docker pull projectdiscovery/katana:latest
To run katana in standard mode using docker -
sh
docker run projectdiscovery/katana:latest -u https://books.toscrape.com
To run katana in headless mode using docker -
sh
docker run projectdiscovery/katana:latest -u https://books.toscrape.com -system-chrome -headless
Ubuntu
It's recommended to install the following prerequisites -
sh
sudo apt update
sudo apt install zip curl wget git snapd
sudo snap refresh
sudo snap install golang --classic
sudo install -d -m 0755 /etc/apt/keyrings
curl -fsSL https://dl.google.com/linux/linux_signing_key.pub \
| sudo gpg --dearmor -o /etc/apt/keyrings/google-chrome.gpg
echo "deb [arch=amd64 signed-by=/etc/apt/keyrings/google-chrome.gpg] \
http://dl.google.com/linux/chrome/deb/ stable main" \
| sudo tee /etc/apt/sources.list.d/google-chrome.list /dev/null
sudo apt update
sudo apt install google-chrome-stable
install katana -
sh
go install github.com/projectdiscovery/katana/cmd/katana@latest
Usage
console
katana -h
This will display help for the tool. Here are all the switches it supports.
console
Katana is a fast crawler focused on execution in automation
pipelines offering both headless and non-headless crawling.
Usage:
./katana [flags]
Flags:
INPUT:
-u, -list string[] target url / list to crawl
-resume string resume scan using resume.cfg
-e, -exclude string[] exclude host matching specified filter ('cdn', 'private-ips', cidr, ip, regex)
CONFIGURATION:
-r, -resolvers string[] list of custom resolver (file or comma separated)
-d, -depth int maximum depth to crawl (default 3)
-jc, -js-crawl enable endpoint parsing / crawling in javascript file
-jsl, -jsluice enable jsluice parsing in javascript file (memory intensive)
-ct, -crawl-duration value maximum duration to crawl the target for (s, m, h, d) (default s)
Top issues
#2010Crawl waits -timeout after its last request0 comments · 2026-11-11#2009Idle keep-alive connections stay open after each crawl when used as a library0 comments · 2026-11-11#1942stop crawling when new pages stop adding surface0 comments · 2026-10-27#1935Headless crawl strategy presets0 comments · 2026-10-26#1929task based exploration in headless0 comments · 2026-10-26#1928verify login and re-authenticate in headless0 comments · 2026-10-26#1927skip destructive actions in headless0 comments · 2026-10-26#1926tag endpoints by function in output0 comments · 2026-10-26
Discussions
#1907`<img>` srcset is not crawled when src is a `data:` URI1 comments · 2026-10-25#1903Refresh header target is missed when it uses `URL=`, quotes, or contains `url=`1 comments · 2026-10-25#1891how to update the katana tool??2 comments · 2026-10-14#1840-jsluice: unbounded memory (>6 GiB in 20 s) on inline scripts with escaped string literals; fixed by bumping odvcencio/gotreesitter to v0.52.01 comments · 2026-09-13#1729`-jsl` parses CSS with the JavaScript tree-sitter parser and exhausts memory1 comments · 2026-07-25#1710[Bug] Hybrid crawler has memory usage explosion for sites with "infinite loops" of links0 comments · 2026-07-10#1704RFC: End-of-run crawl statistics summary1 comments · 2026-07-03#1686[Bug] Headless crawler fails to crawl links from navigation dropdowns0 comments · 2026-06-05
Latest release
v1.8.0 v1.8.0 2026-10-05What's Changed 🎉 New Features Added recorded flow support for headless authentication by @Mzack9999 in https://github.com/projectdiscovery/katana/pull/1712 Added chrome-headless-shell for headless crawls by @Mzack9999 in https://github.com/projectdiscovery/katana/pull/1759 Added BrowserContextID to the hybrid crawler by @sullo in https://github.com/projectdiscovery/katana/pull/1839 Added optional per-page BeforeNavigate / AfterLoad hooks to the hybrid engine by @sullo in https://github.com/projectdiscovery/katana/pull/1853 🐞 Bug Fixes Fixed hybrid onclick-click simulation not being di