OpenCode plugin for Firecrawl. It gives your agent primary-source answers from the Firecrawl developer index, structured data from Firecrawl Alexandria providers, and web scraping, crawling, and search through the Firecrawl CLI.
Add the plugin to your opencode.json:
{
"$schema": "https://opencode.ai/config.json",
"plugin": ["@firecrawl/opencode"]
}OpenCode installs it on the next start. The developer search tool works right away, with no API key and no CLI.
For the web skills (scrape, crawl, map, search, agent), install the Firecrawl CLI:
npx -y firecrawl-cli@latest init -y --browserGet an API key at firecrawl.dev and export it before starting OpenCode:
export FIRECRAWL_API_KEY=fc-your-api-keyWith the key set, the plugin:
- registers the
firecrawl_alexandriatool - passes the key to shell commands, so the CLI is authenticated
- raises the rate limit on developer search
firecrawl login --browser authenticates the CLI alone.
Searches an index of GitHub issues, merged pull requests, READMEs, and library documentation, and returns the matched passages as markdown rather than a list of links. Use it for how a library behaves, what an error means, whether a bug was fixed, or what an API contract guarantees.
Why does my Playwright script hang on page.goto with a service worker registered?
It takes a query plus optional types (doc, issue, pull_request, readme), repos (owner/name), sources, k, and passages. No API key needed.
Finds and runs Alexandria data providers: official APIs, licensed publishers, and Firecrawl indexes that return structured records instead of a web page.
What has the unemployment rate in California been over the last two years?
The agent passes query to discover matching capabilities with their input contract and price (free), then provider, capability, and options to run one. A run spends Firecrawl credits at the listed price. Runs go through the firecrawl_alexandria permission, matched on provider/capability. To confirm each one before it spends:
{
"permission": { "firecrawl_alexandria": "ask" }
}The tool only appears when FIRECRAWL_API_KEY is set.
The plugin bundles the Firecrawl CLI skills (search, scrape, crawl, map, interact, download, parse, agent, monitor, the developer and research indexes, and Alexandria). They teach the agent when each one fits and how to keep output in a .firecrawl/ directory instead of the context window.
ISC