Requirements
- Goose 1.55 or newer.
- A Firecrawl API key, exported as
FIRECRAWL_API_KEY.
Quick setup
- Export your API key in the shell you start Goose from:
- Add the extension to the
extensionssection of~/.config/goose/config.yaml:
- Start a session and ask Goose to search or scrape:
Try it
What you can do
Search
Find current information and read the content of relevant results.
Scrape
Turn URLs into clean markdown or structured data.
Interact
Navigate, click, and fill forms to reach the data you need.
Alexandria
Discover structured data tools, inspect inputs and pricing, then run them through Firecrawl.
Troubleshooting
- The key is reported invalid or revoked: check that the header uses
$FIRECRAWL_API_KEYwithout braces and thatFIRECRAWL_API_KEYis exported in the shell that starts Goose. - The extension is missing: run
goose sessionagain after saving the file, and confirmenabled: true. - Calls time out: raise
timeout. Scraping a large page can take longer than the default. - Tools are not used: some models call MCP tools more reliably than others. Try a different model.

