A next-generation crawling and spidering framework.

★ 17,849⑂ 1,230👁 97⑃ 1,423● 454▤ 23
GoMITCreated 2021-01-02
Download: v1.8.0v1.8.0 ↓1.8.02026-10-05
+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

Discussions

Latest release

v1.8.0 v1.8.0 2026-10-05
What'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

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON