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.
The plugin supports OpenCode 2 and OpenCode 1 (1.18.29 or later) from the same package.
opencode plugin add @firecrawl/opencodeOr add it to opencode.jsonc yourself:
Add it to opencode.json:
{
"$schema": "https://opencode.ai/config.json",
"plugin": ["@firecrawl/opencode"]
}OpenCode installs the package 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 --browserOn OpenCode 2, run /connect in the TUI (or opencode auth login), pick Firecrawl, and choose Sign in with Firecrawl. OpenCode opens Firecrawl in your browser; approve access and you are connected, with no API key to copy. OpenCode keeps the sign-in fresh on its own. Pasting an API key from firecrawl.dev works too, as does FIRECRAWL_API_KEY in the environment. Connecting or disconnecting takes effect without a restart.
The browser sign-in is used by this plugin's tools and the Firecrawl CLI. OpenCode's built-in Firecrawl web search reads only an API key.
On OpenCode 1, export an API key before starting OpenCode:
export FIRECRAWL_API_KEY=fc-your-api-keyOnce connected, the plugin:
- registers the
firecrawl_alexandriatool - passes the credential 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. The tool only appears once a key is connected.
On OpenCode 1, runs go through the firecrawl_alexandria permission, matched on provider/capability. To confirm each one before it spends:
{
"permission": { "firecrawl_alexandria": "ask" }
}OpenCode 2 does not let plugin tools prompt for each call, so runs there are not confirmed one by one. To turn the tool off:
{
"permissions": [{ "action": "firecrawl_alexandria", "resource": "*", "effect": "deny" }]
}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
{ "$schema": "https://opencode.ai/config.json", "plugins": ["@firecrawl/opencode"] }