Sriram-PR/doc-scraper

> A configurable, concurrent, and resumable web crawler written in Go. Specifically designed to scrape technical documentation websites, extract core content, convert it cleanly to Markdown format suitable for ingestion by Large Language Models (LLMs), and save the results locally.
doc-scraper crawls documentation sites into clean Markdown and serves them to coding agents over MCP. Your agent searches and reads the docs you chose, offline, instead of guessing from training data or a live web search. Point doc-scraper add at any docs page and it detects the framework (30+ docs generators, including Docusaurus, Starlight, Sphinx, VitePress, Material for MkDocs, and mdBook), validates the content selector, and drafts the config for you.
**Documentation: https://sriram-pr.github.io/doc-scraper/**
Features
- **Offline search for agents:** BM25 full-text search (search_docs) and page reads (read_page) over the stored corpus, with no network access
- **Framework detection:** 30+ docs generators recognized, each selector validated on the page, Readability fallback, JavaScript-only shells reported instead of crawled empty
- **Clean output:** GitHub-Flavored Markdown per page with frontmatter, plus pages.jsonl, llms.txt, and llms-full.txt
- **Polite and resumable:** robots.txt and sitemaps, per-host rate limits, retries with backoff, resumable crawls, and staged output that never clobbers the last good copy
- **Stays fresh:** incremental re-crawls, watch mode, and crawl history (get_freshness, diff_crawl)
- **Many sites at once:** parallel crawls with shared limits
Install
Download a release binary (Linux, macOS, Windows; amd64 and arm64) from the Releases page, or:
Claude Desktop users can install doc-scraper.mcpb from the latest release instead. Details: Install.
Quick start
Then give it to Claude Code:
See Claude Code setup for scopes and a first prompt.
Docs
- Getting started: install, quick start, adding a site
- Use with agents (MCP): Claude Code, Claude Desktop, any stdio client, and the 11 tools
- Docs frameworks: how detection works, with guides for Docusaurus, Starlight, Sphinx, VitePress, Material for MkDocs, and mdBook
- Configuration and CLI reference
- Detection benchmark
Contributing
Contributions are welcome. Read CONTRIBUTING.md before starting: it covers setup, the testing rules CI enforces, how to claim an issue, and the policy on AI-assisted contributions. Issues labeled good first issue are a good place to begin.
Report security problems privately as described in SECURITY.md. Everyone taking part follows the Code of Conduct.