ruiavskatana

Apache-2.0 9 3 1,743

414 (month) Oct 17 2018 0.8.5(2022-09-06 08:54:56 ago)

16,499 6 18 MIT

Nov 07 2022 v1.5.0(2026-03-10 14:52:47 ago)

Ruia is an async web scraping micro-framework, written with asyncio and aiohttp, aims to make crawling url as convenient as possible.

Ruia is inspired by scrapy however instead of Twisted it's based entirely on asyncio and aiohttp.

It also supports various features like cookies, headers, and proxy, which makes it very useful in dealing with complex web scraping tasks.

Katana is a next-generation web crawling and spidering framework written in Go by ProjectDiscovery. It is designed for fast, comprehensive endpoint and asset discovery and is widely used in the security research and bug bounty communities.

Katana offers multiple crawling modes:

Standard mode Fast HTTP-based crawling without a browser. Parses HTML, JavaScript files, and other resources to discover endpoints and links.
Headless mode Uses a headless Chrome browser for crawling JavaScript-rendered pages and single-page applications (SPAs).
Passive mode Discovers URLs from external sources (Wayback Machine, CommonCrawl, etc.) without actively visiting the target.

Key features include:

Scope control Configurable crawl scope with regex patterns for including/excluding URLs, domains, and file extensions.
JavaScript parsing Extracts endpoints from JavaScript files, inline scripts, and AJAX requests even in standard (non-headless) mode.
Customizable output Filter and format output with field selection, JSON output, and custom templates.
Rate limiting Built-in rate limiting and concurrency control to avoid overwhelming targets.
Proxy support HTTP and SOCKS5 proxy support with rotation.
Form filling Can detect and auto-fill forms to discover endpoints behind form submissions.

While Katana was designed for security research and reconnaissance, its fast crawling capabilities and JavaScript parsing make it equally useful for web scraping discovery and sitemap generation.

Highlights

fastpopularlarge-scale

Example Use

```python #!/usr/bin/env python """ Target: https://news.ycombinator.com/ pip install aiofiles """ import aiofiles from ruia import AttrField, Item, Spider, TextField class HackerNewsItem(Item): target_item = TextField(css_select="tr.athing") title = TextField(css_select="a.storylink") url = AttrField(css_select="a.storylink", attr="href") async def clean_title(self, value): return value.strip() class HackerNewsSpider(Spider): start_urls = [ "https://news.ycombinator.com/news?p=1", "https://news.ycombinator.com/news?p=2", ] concurrency = 10 # aiohttp_kwargs = {"proxy": "http://0.0.0.0:1087"} async def parse(self, response): async for item in HackerNewsItem.get_items(html=await response.text()): yield item async def process_item(self, item: HackerNewsItem): async with aiofiles.open("./hacker_news.txt", "a") as f: self.logger.info(item) await f.write(str(item.title) + "\n") if __name__ == "__main__": HackerNewsSpider.start(middleware=None) ```

```go package main import ( "context" "math" "github.com/projectdiscovery/katana/pkg/engine/standard" "github.com/projectdiscovery/katana/pkg/output" "github.com/projectdiscovery/katana/pkg/types" ) func main() { // Configure crawl options options := &types.Options{ MaxDepth: 3, FieldScope: "rdn", // restrict to root domain BodyReadSize: math.MaxInt, Timeout: 10, Concurrency: 10, Parallelism: 10, Delay: 0, RateLimit: 150, Strategy: "depth-first", OnResult: func(result output.Result) { // Process each discovered URL println(result.Request.URL) }, } // Create and run the crawler crawlerOptions, _ := types.NewCrawlerOptions(options) defer crawlerOptions.Close() crawler, _ := standard.New(crawlerOptions) defer crawler.Close() // Start crawling _ = crawler.Crawl("https://example.com") } ```

Alternatives / Similar

colly

25,231 compare

katana new

16,499 compare

pholcus

7,594 compare

geziyor

2,772 compare

dataflowkit

711 compare

scrapy

61,276 compare

crawl4ai new

63,373 compare

rvest

1,517 compare

scrapling new

36,206 compare

crawlee new

22,720 compare

mechanize new

4,440 compare

scrapegraphai new

23,278 compare

ferret

5,964 compare

gocrawl

2,053 compare

scrapyd

3,087 compare

botasaurus new

4,321 compare

node-crawler

6,790 compare

panther

3,062 compare

goutte new

9,215 compare

gracy

248 compare

spidr

835 compare

kimurai new

1,098 compare

scrapydweb

3,400 compare

photon

12,807 compare

wombat

1,360 compare

autoscraper

7,136 compare

roach

1,454 compare

gerapy

3,495 compare

ralger

165 compare

ayakashi

217 compare

phpscraper

583 compare

dude

425 compare

php-spider

1,341 compare

crwlr-crawler

369 compare

firecrawl new

- compare