firecrawl.search

Search the web with Firecrawl: pay per use, no API key

Use Firecrawl from Claude, Claude Code, Cursor, ChatGPT, and other agents through one Cralo balance.

Search the public web with Firecrawl and return normalized results with optional page content.

Price and execution

Price: $0.002
Pricing model: Fixed price per successful call
Execution class: fast

Limits

No additional limits are published for this tool.

Parameters

Fields firecrawl.search accepts as JSON input.

limitintegerOptional
Maximum number of search results to return per source.
querystringRequired
Natural-language web search query.
countrystringOptional
Two-letter country code used to localize search results.
sourcesarray of "web" | "news" | "images" | "pdf"Optional
Result sources to query. Defaults to web only. Each source can return up to limit results.
scrape_contentbooleanOptional
When true, Firecrawl scrapes each result and returns markdown in the markdown field.
exclude_domainsarray of stringOptional
Exclude results from these domain names.
include_domainsarray of stringOptional
Only return results from these domain names.

Raw input JSON Schema

{
  "type": "object",
  "required": [
    "query"
  ],
  "properties": {
    "limit": {
      "type": "integer",
      "default": 10,
      "maximum": 100,
      "minimum": 1,
      "description": "Maximum number of search results to return per source."
    },
    "query": {
      "type": "string",
      "maxLength": 1000,
      "minLength": 1,
      "description": "Natural-language web search query."
    },
    "country": {
      "type": "string",
      "default": "US",
      "pattern": "^[A-Za-z]{2}quot;,
      "description": "Two-letter country code used to localize search results."
    },
    "sources": {
      "type": "array",
      "items": {
        "enum": [
          "web",
          "news",
          "images",
          "pdf"
        ],
        "type": "string"
      },
      "default": [
        "web"
      ],
      "maxItems": 4,
      "minItems": 1,
      "uniqueItems": true,
      "description": "Result sources to query. Defaults to web only. Each source can return up to limit results."
    },
    "scrape_content": {
      "type": "boolean",
      "default": false,
      "description": "When true, Firecrawl scrapes each result and returns markdown in the markdown field."
    },
    "exclude_domains": {
      "type": "array",
      "items": {
        "type": "string",
        "maxLength": 255,
        "minLength": 1
      },
      "maxItems": 10,
      "uniqueItems": true,
      "description": "Exclude results from these domain names."
    },
    "include_domains": {
      "type": "array",
      "items": {
        "type": "string",
        "maxLength": 255,
        "minLength": 1
      },
      "maxItems": 10,
      "uniqueItems": true,
      "description": "Only return results from these domain names."
    }
  },
  "additionalProperties": false
}

Returns

Fields a successful firecrawl.search call returns.

querystringRequired
resultsarray of objectRequired
- urlstring (uri)Required
- titlestringRequired
- markdownstring | nullRequired
- descriptionstring | nullRequired
search_idstring | nullRequired
credits_usednumber | nullRequired
retrieved_atstring (date-time)Required

Raw output JSON Schema

{
  "type": "object",
  "required": [
    "query",
    "results",
    "search_id",
    "credits_used",
    "retrieved_at"
  ],
  "properties": {
    "query": {
      "type": "string"
    },
    "results": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "title",
          "url",
          "description",
          "markdown"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri"
          },
          "title": {
            "type": "string"
          },
          "markdown": {
            "type": [
              "string",
              "null"
            ]
          },
          "description": {
            "type": [
              "string",
              "null"
            ]
          }
        },
        "additionalProperties": false
      },
      "maxItems": 100
    },
    "search_id": {
      "type": [
        "string",
        "null"
      ]
    },
    "credits_used": {
      "type": [
        "number",
        "null"
      ],
      "minimum": 0
    },
    "retrieved_at": {
      "type": "string",
      "format": "date-time"
    }
  },
  "additionalProperties": false
}

Run this tool

Copy this instruction to your agent to set up Cralo and call this tool with the example input.

Set up Cralo by following https://cralo.ai/SKILL.md, then call the firecrawl.search tool with this input: {"query":"Cralo","limit":1,"country":"US"}

Start with $1 free See pricing

Safety notes

Side Effect: read_only
Public Sources Only: Yes

How this compares to using Firecrawl directly

You do not need a separate Firecrawl account or subscription for this call. Cralo uses one prepaid balance across all tools and shows the per-call price before you run the command.

Related tools

[Browse all tools]