Files
openclaw/extensions/firecrawl/openclaw.plugin.json
Developers Digest 8809848b19 feat(firecrawl): add keyless Firecrawl Search (Free) provider + richer firecrawl_search options (#97078)
* feat(firecrawl): add keyless Firecrawl Search (Free) provider + richer firecrawl_search options

Add an opt-in, keyless 'firecrawl-free' web_search provider (Firecrawl
Search (Free)) mirroring the Parallel plugin's parallel-free pattern:
requiresCredential false, no autoDetectOrder, never auto-selected. The
free path is credential-isolated — it never resolves or sends any
Firecrawl API key (no Authorization header), so opting out of credentials
cannot leak a configured/paid key — and its results and cache key carry a
distinct 'firecrawl-free' provider identity. The keyed 'firecrawl'
provider and core search auto-select behavior are unchanged, honoring the
maintainers' opt-in policy for keyless search.

Registered in index.ts, the web-search-provider barrel, the
web-search-contract-api metadata artifact (the onboarding/setup source),
manifest contracts, the official external plugin catalog snapshot, and
the doctor/contract registries.

Also extend the firecrawl_search tool to /v2/search parity:
includeDomains/excludeDomains (mutually exclusive), tbs, location,
country, and raise the result cap to 100.

* docs: regenerate docs_map for firecrawl heading rename

---------

Co-authored-by: developersdigest <jonathan@sideguide.dev>
2026-07-12 21:04:43 -07:00

84 lines
2.0 KiB
JSON

{
"id": "firecrawl",
"activation": {
"onStartup": false
},
"setup": {
"providers": [
{
"id": "firecrawl",
"envVars": ["FIRECRAWL_API_KEY"]
}
]
},
"uiHints": {
"webSearch.apiKey": {
"label": "Firecrawl Search API Key",
"help": "Firecrawl API key for web search (fallback: FIRECRAWL_API_KEY env var).",
"sensitive": true,
"placeholder": "fc-..."
},
"webSearch.baseUrl": {
"label": "Firecrawl Search Base URL",
"help": "Firecrawl Search base URL override."
},
"webFetch.apiKey": {
"label": "Firecrawl Fetch API Key",
"help": "Optional for hosted keyless scraping; add a key for higher limits (fallback: FIRECRAWL_API_KEY env var).",
"sensitive": true,
"placeholder": "fc-..."
},
"webFetch.baseUrl": {
"label": "Firecrawl Fetch Base URL",
"help": "Firecrawl Fetch base URL override."
}
},
"contracts": {
"webFetchProviders": ["firecrawl"],
"webSearchProviders": ["firecrawl", "firecrawl-free"],
"tools": ["firecrawl_search", "firecrawl_scrape"]
},
"configContracts": {
"compatibilityRuntimePaths": ["tools.web.search.apiKey"]
},
"configSchema": {
"type": "object",
"additionalProperties": false,
"properties": {
"webSearch": {
"type": "object",
"additionalProperties": false,
"properties": {
"apiKey": {
"type": ["string", "object"]
},
"baseUrl": {
"type": "string"
}
}
},
"webFetch": {
"type": "object",
"additionalProperties": false,
"properties": {
"apiKey": {
"type": ["string", "object"]
},
"baseUrl": {
"type": "string"
},
"onlyMainContent": {
"type": "boolean"
},
"maxAgeMs": {
"type": "number"
},
"timeoutSeconds": {
"type": "number"
}
}
}
}
}
}