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

CODEBLOCK0

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

Fetch pages

CODEBLOCK1

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

CODEBLOCK2

Flags Reference

Flag	Short	Default	What it does
INLINECODE5	INLINECODE6	duckduckgo	Search engine to use
INLINECODE7

-n | 10 | Number of search results | | --markdown | -m | false | Convert to markdown (reader mode) | | --markdown-full | | false | Full page markdown (not just main content) | | --json | -j | false | JSON output with metadata | | --raw | | false | Raw HTML output | | --max-parallel | -p | 5 | Max parallel fetches | | --filter | -f | | Filter links by regex | | --timeout | -t | 30s | Request timeout | | --browser | -b | chrome | Browser fingerprint: chrome, firefox | | --no-cookies | | false | Disable cookie persistence | | --follow | -L | true | Follow redirects | | --verbose | -v | false | Print request/response details | | --captcha-service | | | Captcha service: 2captcha, anticaptcha | | --captcha-key | | | Captcha service API key |

Decision Guide

I want to...	Use this
Search the web	INLINECODE30
Search with specific engine

ghostfetch "query" -e brave | | Read a web page | ghostfetch fetch <url> -m | | Read multiple pages at once | ghostfetch fetch url1 url2 url3 -m -p 3 | | Find links on a page | ghostfetch links <url> | | Find specific links | ghostfetch links <url> -f "pattern" | | Get structured data | ghostfetch fetch <url> --json |

Examples

Research a topic

CODEBLOCK3

Scrape structured data

CODEBLOCK4

Find all GitHub links on a page

CODEBLOCK5

Installation

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

CODEBLOCK6

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