← all repositories
watercrawl/WaterCrawl

A self-hosted scraper that speaks fluent LLM

WaterCrawl wraps Scrapy and Django into a self-hosted crawling API aimed at LLM and automation pipelines.

1.9k stars TypeScript Data Tooling
WaterCrawl
Not currently ranked — collecting fresh signals.
star history

What it does

WaterCrawl is a web crawling platform built on Django, Scrapy, and Celery that you host yourself. It crawls and scrapes sites with configurable depth and speed, then serves the results through a REST API with OpenAPI documentation. A built-in search engine offers tiered discovery modes—basic, advanced, and ultimate—with multi-language and country-specific targeting. Real-time job progress streams back via Server-Sent Events.

The interesting bit

Instead of treating scraping as a scripting chore, WaterCrawl wraps the mature Python scraping stack into an API-first service with SDKs and no-code integrations. It explicitly targets LLM and automation pipelines, offering plugins for OpenAI and hookups for Dify and N8N.

Key highlights

  • Self-hosted stack: Django, Scrapy, Celery, and Docker-based deployment
  • REST API with OpenAPI spec and SSE-based real-time progress updates
  • Tiered search engine with basic, advanced, and ultimate depth levels
  • Client SDKs for Python, Node.js, Go, and PHP
  • Integrations for Dify, N8N, and an OpenAI plugin

Caveats

  • Non-localhost deployments require manual MinIO endpoint configuration; the README warns that skipping this breaks file uploads and downloads
  • Production setup demands additional database and service configuration beyond the default Docker Compose environment
  • The Langflow integration is currently an unmerged pull request

Verdict

Best for teams that need a private, API-driven crawling backend for RAG or automation. Not for anyone looking for a fully managed SaaS or a lightweight CLI tool.

Frequently asked

What is watercrawl/WaterCrawl?
WaterCrawl wraps Scrapy and Django into a self-hosted crawling API aimed at LLM and automation pipelines.
Is WaterCrawl open source?
Yes — watercrawl/WaterCrawl is an open-source project tracked on heatdrop.
What language is WaterCrawl written in?
watercrawl/WaterCrawl is primarily written in TypeScript.
How popular is WaterCrawl?
watercrawl/WaterCrawl has 1.9k stars on GitHub.
Where can I find WaterCrawl?
watercrawl/WaterCrawl is on GitHub at https://github.com/watercrawl/WaterCrawl.

heatdrop uses Google Analytics to see which pages get read — nothing else. Your call. How we handle data.