raj457036 / simple-web-crawler

A performant but simple web crawler thats easy to use and extend, supports async and sync requests with in memory and disk caching for high performance.

Simple Web Crawler

A performant but simple web crawler thats easy to use and extend, supports async and sync requests with in memory and disk caching for high performance.

Installation

pip install --upgrade git+https://github.com/raj457036/Simple-Web-Crawler.git@main

Usage

from pydantic import HttpUrl

from simple_crawler import SimpleSyncCrawler, CrawlerConfig, InMemoryPageStorage

# Create a crawler with a config and storage
config = CrawlerConfig(
    entrypoint=HttpUrl(
        "https://example.com"
    ),
    content_type="md",
    from_root=True,
)
# In memory storage
# you can also try `DiskPageStorage` for persistent storage and heavy volume.
storage = InMemoryPageStorage()

# Run the crawler
crawler = SimpleSyncCrawler(config=config, storage=storage)
crawler.run()

# Print the results or do something else with them
print(*crawler.page_storage.keys, sep="\n")

• Async Example: test/simple_async_crawler.py
• Sync Example: test/simple_sync_crawler.py

Features

• Sync and Async requests
• In memory and disk storage
• Configurable
• Pydantic and type annotated
• Extensible
• Customizable
• High performance
• Easy to use