Ghostfetch

Web search and page fetcher for AI agents. Single binary, no browser needed. Fetches pages with browser-like TLS fingerprints for reliable access.

Use for: web searches, fetching page content as markdown, extracting links, and gathering information from the web.

Commands

Search the web

ghostfetch "your search query"                    # Search DuckDuckGo (default)
ghostfetch "query" -e brave                       # Search with Brave
ghostfetch "query" -e google                      # Search with Google
ghostfetch "query" -e bing                        # Search with Bing
ghostfetch "query" -n 5                           # Limit to 5 results
ghostfetch "query" --json                         # JSON output with metadata

Search engines: duckduckgo (default), brave, bing, google

Fetch pages

ghostfetch fetch https://example.com              # Fetch page (raw HTML)
ghostfetch fetch https://example.com -m           # Fetch as markdown (reader mode — preferred)
ghostfetch fetch https://example.com --markdown-full  # Full page as markdown (not just main content)
ghostfetch fetch https://example.com --json       # JSON with body, status, headers, cookies
ghostfetch fetch https://example.com --raw        # Raw HTML without processing
ghostfetch fetch url1 url2 url3 -p 3              # Fetch multiple URLs in parallel

Always use -m (markdown mode) when reading page content — it extracts the main content and converts to clean markdown, saving tokens vs raw HTML.

Extract links

ghostfetch links https://example.com              # Extract all links from page
ghostfetch links https://example.com -f "github"  # Filter links by regex pattern
ghostfetch links https://example.com --json       # JSON output

Flags Reference

Decision Guide

Examples

Research a topic

ghostfetch "rust async runtime comparison 2026" -n 5
ghostfetch fetch https://tokio.rs -m

Scrape structured data

ghostfetch fetch https://api.example.com/data --json

Find all GitHub links on a page

ghostfetch links https://awesome-list.com -f "github.com"

Installation

The ghostfetch binary must be in your PATH. Build from source:

git clone https://github.com/neothelobster/ghostfetch.git
cd ghostfetch
go build -o ghostfetch .
cp ghostfetch ~/.openclaw/workspace/tools/

Or run the included setup.sh which clones at a pinned commit with verification.

Requires Go 1.21+ to build. No runtime dependencies.

Security

• Read-only tool — output goes to stdout only, no file write capability
• No custom headers or POST bodies — cannot leak secrets to external endpoints
• No data is stored except optional cookie jars (disabled with --no-cookies)
• All network requests go directly from your machine — no proxy or third-party service
• The setup script clones from GitHub at a pinned commit with verification
• Source code: https://github.com/neothelobster/ghostfetch