# firecrawl_search

tool by [@c0va23](/marketplace/@c0va23/tools)

A tool that fetches api.firecrawl.dev.

- First published 2026-10-27 · release 2 on 2026-10-28
- [Download release 2](/marketplace/listings/01a17b91-9f47-7776-9915-29b3b438e983/latest.bylm.json)
- [0 stars](/marketplace/listings/01a17b91-9f47-7776-9915-29b3b438e983/stars)
- Needs a key: **Firecrawl** — sent to https://api.firecrawl.dev. Hint: Dashboard › API Keys: create a key at firecrawl.dev/app/api-keys and paste it here. [Get a key](https://www.firecrawl.dev/app/api-keys)

## What it holds

### What the model is told

**Tool the model sees**: `fetch_url-firecrawl_search`

```text
Search the web with the Firecrawl Search API (POST https://api.firecrawl.dev/v2/search). Returns ranked web results with title, URL and description for a query. Use it to find relevant pages, then pass any result URL to the firecrawl_scrape tool to read the full page. Results are only titles/URLs/descriptions — never answer a question from them alone.
```

### Request

**Method and address**: `POST https://api.firecrawl.dev/v2/search`

**Headers sent**:

- `Authorization: Bearer {apiKey}`

**Body**: `application/json`

```json
{
  "query": "{query}",
  "limit": {limit},
  "sources": ["web"]
}
```

### Arguments the model passes

| Name | Type | Required | Default | Description |
| --- | --- | --- | --- | --- |
| `query` | string | yes |  | The search query, e.g. "firecrawl pricing" or "python asyncio timeout best practices" |
| `limit` | integer | no | `5` |  |

### Responses

**Retries**: A 429 or a 503 is sent again, 3 times at most, waiting 1000 ms first and doubling, 60000 ms at most

**Kept for the app's response details screen**: the first 65536 characters of the body and of each filter's output; the model never reads them

### Filters over the response, in order

#### Step 1

A jq program, giving `text/markdown`

```
def clip: if (length > 600) then .[0:600] + " …" else . end;
(if ((.success // true) | not) then "Firecrawl search failed: " + ((.error // "unknown error") | tostring) + "\n\n" else "" end)
+
([ ((.data.web // [])[] | "### " + ((.title // "(untitled)") | tostring) + "\nURL: " + ((.url // "") | tostring) + "\n" + (((.description // "") | tostring) | clip)) ]
 | if length == 0 then "No web results were returned for this query." else join("\n\n") end)
```

When the program outputs several values, only the first is passed on. A string is passed on without its quotes.

### Keys

**`apiKey`**: **Firecrawl**, an API key

## Downloads

Downloaded 6 times directly. Included in 3 downloads of other listings. 6 downloads in the last 30 days.

## Releases

| Release | Published | Downloads | File |
| --- | --- | --- | --- |
| [2](/marketplace/listings/01a17b91-9f47-7776-9915-29b3b438e983/releases/2) | 2026-10-28 | [3](/marketplace/listings/01a17b91-9f47-7776-9915-29b3b438e983?release=2) | [download](/marketplace/listings/01a17b91-9f47-7776-9915-29b3b438e983/v/2.bylm.json) |
| [1](/marketplace/listings/01a17b91-9f47-7776-9915-29b3b438e983/releases/1) | 2026-10-27 | [3](/marketplace/listings/01a17b91-9f47-7776-9915-29b3b438e983?release=1) | [download](/marketplace/listings/01a17b91-9f47-7776-9915-29b3b438e983/v/1.bylm.json) |

---

[Bring Your LM](/) · [Docs](/docs/features) · [Marketplace](/marketplace)

[Articles](/articles) · [Releases](/releases) · [Bundle Format](/marketplace/bundle-format) · [Marketplace Terms](/terms) · [App Privacy](/privacy) · [Website Privacy](/website-privacy) · [Open Source](/open-source) · [llms.txt](/llms.txt)