feat(drivers-web-search-firecrawl): add FirecrawlWebSearchDriver

[JuampiHernandez]

Hey, I'm Juampi from the Firecrawl team.

• I have read and agree to the contributing guidelines.

Describe your changes

Adds a FirecrawlWebSearchDriver for the Firecrawl Search API, following the other web search drivers: attrs class, lazy optional-dependency client, results_count mapped to limit, and params and kwargs passed through to Firecrawl.search. It returns a ListArtifact of JsonArtifacts with title, url and description. When scrape_options is set, each result also carries the page content (markdown, summary or json). api_url can point at a self-hosted Firecrawl.

The extra pins firecrawl-py>=4.46.0, the first release whose client takes an origin argument; the driver sets it to griptape.

Includes the drivers-web-search-firecrawl extra, unit tests, and a docs section with an example. The example reads FIRECRAWL_API_KEY, so I added it to the docs integration workflow env next to the other keys. It needs an INTEG_FIRECRAWL_API_KEY secret, and I'm happy to provide a key for it.

Tested against the live API: plain search, search with scrape_options (markdown and summary), and an Agent using WebSearchTool with this driver (OpenAiChatPromptDriver).

Issue ticket number and link

Discussion: https://github.com/orgs/griptape-ai/discussions/2366

---

📚 Documentation preview 📚: https://griptape--2367.org.readthedocs.build//2367/

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.

📢 Thoughts on this report? Let us know!