Skip to main content

Dynamic documentation fetching CLI that converts entire documentation sites to single markdown files for AI/LLM consumption

Project description

DocFetch - Dynamic Documentation Fetcher 📚

Transform entire documentation sites into AI-ready, single-file markdown with intelligent LLM.txt indexing

Most AIs can't navigate documentation like humans do. They can't scroll through sections, click sidebar links, or explore related pages. DocFetch solves this fundamental problem by converting entire documentation sites into comprehensive, clean markdown files that contain every section and piece of information in a format that LLMs love.

🚀 Why DocFetch is Essential for AI Development

🤖 AI/LLM Optimization

  • Single-file consumption: No more fragmented context across multiple pages
  • Clean, structured markdown: Perfect token efficiency for LLM context windows
  • Intelligent LLM.txt generation: AI-friendly index with semantic categorization
  • Noise removal: Automatically strips navigation, headers, footers, ads, and buttons

Developer Productivity

  • One command automation: Replace hours of manual copy-pasting with a single CLI command
  • Complete documentation access: Give your AI agents full access to official documentation
  • Consistent formatting: Uniform structure across different documentation sites
  • Version control friendly: Markdown files work perfectly with Git

🎯 Smart Content Intelligence

  • Automatic page classification: Identifies APIs, guides, references, and examples
  • Semantic descriptions: Generates concise, relevant descriptions for each section
  • URL preservation: Maintains original source links for verification
  • Adaptive content extraction: Works with diverse documentation site structures

🔧 Production Ready

  • Concurrent fetching: Fast downloads with configurable concurrency
  • Respectful crawling: Honors robots.txt and includes rate limiting
  • Cross-platform: Works on Windows, macOS, and Linux
  • Multiple installation options: NPM, Go install, or direct binary download

📦 Installation

PyPI (Recommended for Python developers) ✨ NEW

pip install doc-fetch

NPM (Recommended for JavaScript/Node.js developers)

npm install -g doc-fetch

Go (For Go developers)

go install github.com/AlphaTechini/doc-fetch/cmd/docfetch@latest

Direct Binary Download

Visit Releases and download your platform's binary.

🎯 Usage

Basic Usage

# Fetch entire documentation site to single markdown file
doc-fetch --url https://golang.org/doc/ --output ./docs/golang-full.md

# With LLM.txt generation for AI optimization
doc-fetch --url https://react.dev/learn --output docs.md --llm-txt

Advanced Usage

# Comprehensive documentation fetch with all features
doc-fetch \
  --url https://docs.example.com \
  --output ./internal/docs.md \
  --depth 4 \
  --concurrent 10 \
  --llm-txt \
  --user-agent "MyBot/1.0"

Command Options

Flag Short Description Default
--url -u Base URL to fetch documentation from Required
--output -o Output file path docs.md
--depth -d Maximum crawl depth 2
--concurrent -c Number of concurrent fetchers 3
--llm-txt Generate AI-friendly llm.txt index false
--user-agent Custom user agent string DocFetch/1.0

📁 Output Files

When using --llm-txt, DocFetch generates two files:

docs.md - Complete Documentation

# Documentation

This file contains documentation fetched by DocFetch.

---

## Getting Started

This guide covers installation, setup, and first program...

---

## Language Specification

Complete Go language specification and syntax...

docs.llm.txt - AI-Friendly Index

# llm.txt - AI-friendly documentation index

[GUIDE] Getting Started
https://golang.org/doc/install
Covers installation, setup, and first program.

[REFERENCE] Language Specification  
https://golang.org/ref/spec
Complete Go language specification and syntax.

[API] net/http
https://pkg.go.dev/net/http
HTTP client/server implementation.

🌟 Real-World Examples

Fetch Go Documentation

doc-fetch --url https://golang.org/doc/ --output ./docs/go-documentation.md --depth 4 --llm-txt

Fetch React Documentation

doc-fetch --url https://react.dev/learn --output ./docs/react-learn.md --concurrent 10 --llm-txt

Fetch Your Own Project Docs

doc-fetch --url https://your-project.com/docs/ --output ./internal/docs.md --llm-txt

🤖 How LLM.txt Supercharges Your AI

The generated llm.txt file acts as a semantic roadmap for your AI agents:

  1. Precise Navigation: Agents can query specific sections without scanning entire documents
  2. Context Awareness: Know whether they're looking at an API reference vs. a tutorial
  3. Efficient Retrieval: Jump directly to relevant content based on query intent
  4. Source Verification: Always maintain links back to original documentation

Example AI Prompt Enhancement:

Instead of: "What does the net/http package do?"
Your AI can now: "Check the [API] net/http section in llm.txt for HTTP client/server implementation details"

🏗️ How It Works

  1. Link Discovery: Parses the base URL to find all internal documentation links
  2. Content Fetching: Downloads all pages concurrently with respect for robots.txt
  3. HTML Cleaning: Removes non-content elements (navigation, headers, footers, etc.)
  4. Markdown Conversion: Converts cleaned HTML to structured markdown
  5. Intelligent Classification: Categorizes pages as API, GUIDE, REFERENCE, or EXAMPLE
  6. Description Generation: Creates concise, relevant descriptions for each section
  7. Single File Output: Combines all documentation into one comprehensive file
  8. LLM.txt Generation: Creates AI-friendly index with semantic categorization

🚀 Future Features

  • Incremental updates: Only fetch changed pages on subsequent runs
  • Custom selectors: Allow users to specify content areas for different sites
  • Multiple formats: Support PDF, JSON, and other output formats
  • Token counting: Estimate token usage for LLM context planning
  • Advanced classification: Machine learning-based page type detection

💡 Why This Exists

Traditional documentation sites are designed for human navigation, not AI consumption. When working with LLMs, you often need to manually copy-paste multiple sections or provide incomplete context. DocFetch automates this process, giving your AI agents complete access to documentation without the manual overhead.

Stop wasting time copying documentation. Start building AI agents with complete knowledge.

🤝 Contributing

Contributions are welcome! Please open an issue or pull request on GitHub.

📄 License

MIT License


Built with ❤️ for AI developers who deserve better documentation access

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

doc_fetch-1.1.0.tar.gz (14.1 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

doc_fetch-1.1.0-py3-none-any.whl (5.1 MB view details)

Uploaded Python 3

File details

Details for the file doc_fetch-1.1.0.tar.gz.

File metadata

  • Download URL: doc_fetch-1.1.0.tar.gz
  • Upload date:
  • Size: 14.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.12.3

File hashes

Hashes for doc_fetch-1.1.0.tar.gz
Algorithm Hash digest
SHA256 0ea16545d305ebe0845abc842294eaf96560a580b6d93b9683157b92ae780439
MD5 eb17e05e187c9056d8371a0643ef5286
BLAKE2b-256 c1589908164b8ac16e5ac0a942bf68ae09b71c0a456db816f677cf3e5cad7dee

See more details on using hashes here.

File details

Details for the file doc_fetch-1.1.0-py3-none-any.whl.

File metadata

  • Download URL: doc_fetch-1.1.0-py3-none-any.whl
  • Upload date:
  • Size: 5.1 MB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.12.3

File hashes

Hashes for doc_fetch-1.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 166e9f3f968a8ec545eef0766fdd02194278e9d5b72d608f03dffb184d1b25b7
MD5 9ccc868de98427128dfb004edb6a3864
BLAKE2b-256 540f8bf75ee8c452201a69d8b74726580ead172253ea4c3738b227a7385b7659

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page