AIsa Web Search & Research

Firecrawl Crawl submit

post_firecrawl_crawl

Destructive

Owner-scoped local asynchronous job lifecycle. Disabling new admission does not disable existing job reads or cancellation. Runtime availability and access policy also apply.

A request reference price is not currently available; use a request quote where supported. Account-specific pricing and final settlement may differ.

Input Schema

Name	Required	Description
`body`	Yes
`Idempotency-Key`	Yes	Trimmed UTF-8 length must be 1 through 191 bytes.
`X-AISA-Cost-Mode`	No	Return a read-only cost quote instead of submitting a job.
`X-AISA-Max-Price-USD`	No	Optional maximum customer authorization in USD, validated by the runtime price parser.

Output Schema

Name	Required	Description	Default
No arguments

Schema Changelog

Changes observed during successful MCP inspections.

Changed16 schema fields changedOct 19, 2026

addedInput schema / additionalProperties
```
Added value: +false
```

removedInput schema / properties / allowExternalLinks

Removed value: -{
-  "type": [
-    "boolean",
-    "null"
-  ]
-}

removedInput schema / properties / allowSubdomains

Removed value: -{
-  "type": [
-    "boolean",
-    "null"
-  ]
-}

addedInput schema / properties / body

Added value: +{
+  "additionalProperties": false,
+  "properties": {
+    "allowExternalLinks": {
+      "type": [
+        "boolean",
+        "null"
+      ]
+    },
+    "allowSubdomains": {
+      "type": [
+        "boolean",
+        "null"
+      ]
+    },
+    "crawlEntireDomain": {
+      "type": [
+        "boolean",
+        "null"
+      ]
+    },
+    "delay": {
+      "maximum": 30,
+      "minimum": 0,
+      "type": [
+        "number",
+        "null"
+      ]
+    },
+    "excludePaths": {
+      "items": {
+        "description": "Non-empty after trimming; no CR/LF; UTF-8 byte length is bounded.",
+        "pattern": "^[^\\r\\n]*\\S[^\\r\\n]*$(?![\\s\\S])",
+        "type": "string",
+        "x-aisa-max-utf8-bytes": 256
+      },
+      "maxItems": 20,
+      "type": [
+        "array",
+        "null"
+      ]
+    },
+    "ignoreQueryParameters": {
+      "type": [
+        "boolean",
+        "null"
+      ]
+    },
+    "includePaths": {
+      "items": {
+        "description": "Non-empty after trimming; no CR/LF; UTF-8 byte length is bounded.",
+        "pattern": "^[^\\r\\n]*\\S[^\\r\\n]*$(?![\\s\\S])",
+        "type": "string",
+        "x-aisa-max-utf8-bytes": 256
+      },
+      "maxItems": 20,
+      "type": [
+        "array",
+        "null"
+      ]
+    },
+    "limit": {
+      "maximum": 1000,
+      "minimum": 1,
+      "type": "integer"
+    },
+    "maxConcurrency": {
+      "maximum": 20,
+      "minimum": 1,
+      "type": [
+        "integer",
+        "null"
+      ]
+    },
+    "maxDiscoveryDepth": {
+      "maximum": 10,
+      "minimum": 0,
+      "type": [
+        "integer",
+        "null"
+      ]
+    },
+    "scrapeOptions": {
+      "additionalProperties": false,
+      "properties": {
+        "excludeTags": {
+          "items": {
+            "description": "Non-empty after trimming; no CR/LF; UTF-8 byte length is bounded.",
+            "pattern": "^[^\\r\\n]*\\S[^\\r\\n]*$(?![\\s\\S])",
+            "type": "string",
+            "x-aisa-max-utf8-bytes": 128
+          },
+          "maxItems": 50,
+          "type": [
+            "array",
+            "null"
+          ]
+        },
+        "includeTags": {
+          "items": {
+            "description": "Non-empty after trimming; no CR/LF; UTF-8 byte length is bounded.",
+            "pattern": "^[^\\r\\n]*\\S[^\\r\\n]*$(?![\\s\\S])",
+            "type": "string",
+            "x-aisa-max-utf8-bytes": 128
+          },
+          "maxItems": 50,
+          "type": [
+            "array",
+            "null"
+          ]
+        },
+        "maxAge": {
+          "maximum": 31536000000,
+          "minimum": 0,
+          "type": [
+            "integer",
+            "null"
+          ]
+        },
+        "minAge": {
+          "maximum": 31536000000,
+          "minimum": 0,
+          "type": [
+            "integer",
+            "null"
+          ]
+        },
+        "onlyMainContent": {
+          "type": [
+            "boolean",
+            "null"
+          ]
+        },
+        "timeout": {
+          "maximum": 300000,
+          "minimum": 1000,
+          "type": [
+            "integer",
+            "null"
+          ]
+        }
+      },
+      "type": [
+        "object",
+        "null"
+      ]
+    },
+    "sitemap": {
+      "enum": [
+        null,
+        "skip",
+        "include",
+        "only"
+      ],
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "url": {
+      "description": "HTTPS URL with a hostname, without credentials or fragment. Trimmed input ending in .pdf (case insensitive) is not supported.",
+      "pattern": "^\\s*[hH][tT][tT][pP][sS]://",
+      "type": "string"
+    }
+  },
+  "required": [
+    "url",
+    "limit"
+  ],
+  "type": "object"
+}

removedInput schema / properties / crawlEntireDomain

Removed value: -{
-  "type": [
-    "boolean",
-    "null"
-  ]
-}

removedInput schema / properties / delay

Removed value: -{
-  "maximum": 30,
-  "minimum": 0,
-  "type": [
-    "number",
-    "null"
-  ]
-}

removedInput schema / properties / excludePaths

Removed value: -{
-  "items": {
-    "description": "Non-empty after trimming; no CR/LF; UTF-8 byte length is bounded.",
-    "pattern": "^[^\\r\\n]*\\S[^\\r\\n]*$(?![\\s\\S])",
-    "type": "string",
-    "x-aisa-max-utf8-bytes": 256
-  },
-  "maxItems": 20,
-  "type": [
-    "array",
-    "null"
-  ]
-}

removedInput schema / properties / ignoreQueryParameters

Removed value: -{
-  "type": [
-    "boolean",
-    "null"
-  ]
-}

removedInput schema / properties / includePaths

Removed value: -{
-  "items": {
-    "description": "Non-empty after trimming; no CR/LF; UTF-8 byte length is bounded.",
-    "pattern": "^[^\\r\\n]*\\S[^\\r\\n]*$(?![\\s\\S])",
-    "type": "string",
-    "x-aisa-max-utf8-bytes": 256
-  },
-  "maxItems": 20,
-  "type": [
-    "array",
-    "null"
-  ]
-}

removedInput schema / properties / limit

Removed value: -{
-  "maximum": 1000,
-  "minimum": 1,
-  "type": "integer"
-}

removedInput schema / properties / maxConcurrency

Removed value: -{
-  "maximum": 20,
-  "minimum": 1,
-  "type": [
-    "integer",
-    "null"
-  ]
-}

removedInput schema / properties / maxDiscoveryDepth

Removed value: -{
-  "maximum": 10,
-  "minimum": 0,
-  "type": [
-    "integer",
-    "null"
-  ]
-}

removedInput schema / properties / scrapeOptions

Removed value: -{
-  "additionalProperties": {
-    "not": {}
-  },
-  "properties": {
-    "excludeTags": {
-      "items": {
-        "description": "Non-empty after trimming; no CR/LF; UTF-8 byte length is bounded.",
-        "pattern": "^[^\\r\\n]*\\S[^\\r\\n]*$(?![\\s\\S])",
-        "type": "string",
-        "x-aisa-max-utf8-bytes": 128
-      },
-      "maxItems": 50,
-      "type": [
-        "array",
-        "null"
-      ]
-    },
-    "includeTags": {
-      "items": {
-        "description": "Non-empty after trimming; no CR/LF; UTF-8 byte length is bounded.",
-        "pattern": "^[^\\r\\n]*\\S[^\\r\\n]*$(?![\\s\\S])",
-        "type": "string",
-        "x-aisa-max-utf8-bytes": 128
-      },
-      "maxItems": 50,
-      "type": [
-        "array",
-        "null"
-      ]
-    },
-    "maxAge": {
-      "maximum": 31536000000,
-      "minimum": 0,
-      "type": [
-        "integer",
-        "null"
-      ]
-    },
-    "minAge": {
-      "maximum": 31536000000,
-      "minimum": 0,
-      "type": [
-        "integer",
-        "null"
-      ]
-    },
-    "onlyMainContent": {
-      "type": [
-        "boolean",
-        "null"
-      ]
-    },
-    "timeout": {
-      "maximum": 300000,
-      "minimum": 1000,
-      "type": [
-        "integer",
-        "null"
-      ]
-    }
-  },
-  "type": [
-    "object",
-    "null"
-  ]
-}

removedInput schema / properties / sitemap

Removed value: -{
-  "enum": [
-    null,
-    "skip",
-    "include",
-    "only"
-  ],
-  "type": [
-    "string",
-    "null"
-  ]
-}

removedInput schema / properties / url

Removed value: -{
-  "description": "HTTPS URL with a hostname, without credentials or fragment. Trimmed input ending in .pdf (case insensitive) is not supported.",
-  "pattern": "^\\s*[hH][tT][tT][pP][sS]://",
-  "type": "string"
-}

changedInput schema / required

Previous value: -[
-  "Idempotency-Key",
-  "url",
-  "limit"
-]New value: +[
+  "Idempotency-Key",
+  "body"
+]

Changed64 schema fields changedOct 15, 2026
- changedInput schema / properties / Idempotency-Key / description
```
Previous value: -"Unique key (1 to 191 characters) that makes the submit idempotent. Re-submitting with the same key returns the original job."New value: +"Trimmed UTF-8 length must be 1 through 191 bytes."
```
- removedInput schema / properties / Idempotency-Key / maxLength
```
Removed value: -191
```
- addedInput schema / properties / Idempotency-Key / pattern
```
Added value: +"\\S"
```
- addedInput schema / properties / X-AISA-Cost-Mode
```
Added value: +{
+  "description": "Return a read-only cost quote instead of submitting a job.",
+  "enum": [
+    "quote"
+  ],
+  "type": "string"
+}
```
- addedInput schema / properties / X-AISA-Max-Price-USD
```
Added value: +{
+  "description": "Optional maximum customer authorization in USD, validated by the runtime price parser.",
+  "type": "string"
+}
```
- removedInput schema / properties / allowExternalLinks / description
```
Removed value: -"Follow links to external domains."
```
- changedInput schema / properties / allowExternalLinks / type
```
Previous value: -"boolean"New value: +[
+  "boolean",
+  "null"
+]
```
- removedInput schema / properties / allowSubdomains / description
```
Removed value: -"Follow links into subdomains of the root domain."
```
- changedInput schema / properties / allowSubdomains / type
```
Previous value: -"boolean"New value: +[
+  "boolean",
+  "null"
+]
```
- removedInput schema / properties / crawlEntireDomain / description
```
Removed value: -"Crawl the whole domain rather than only the subtree under the root URL."
```
- changedInput schema / properties / crawlEntireDomain / type
```
Previous value: -"boolean"New value: +[
+  "boolean",
+  "null"
+]
```
- removedInput schema / properties / delay / description
```
Removed value: -"Delay in seconds between requests (0 to 30)."
```
- changedInput schema / properties / delay / type
```
Previous value: -"number"New value: +[
+  "number",
+  "null"
+]
```
- removedInput schema / properties / excludePaths / description
```
Removed value: -"Skip URLs whose path matches one of these patterns."
```
- addedInput schema / properties / excludePaths / items / description
```
Added value: +"Non-empty after trimming; no CR/LF; UTF-8 byte length is bounded."
```
- removedInput schema / properties / excludePaths / items / maxLength
```
Removed value: -256
```
- addedInput schema / properties / excludePaths / items / pattern
```
Added value: +"^[^\\r\\n]*\\S[^\\r\\n]*$(?![\\s\\S])"
```
- addedInput schema / properties / excludePaths / items / x-aisa-max-utf8-bytes
```
Added value: +256
```
- changedInput schema / properties / excludePaths / type
```
Previous value: -"array"New value: +[
+  "array",
+  "null"
+]
```
- removedInput schema / properties / ignoreQueryParameters / description
```
Removed value: -"Treat URLs that differ only by query string as the same page."
```
- changedInput schema / properties / ignoreQueryParameters / type
```
Previous value: -"boolean"New value: +[
+  "boolean",
+  "null"
+]
```
- removedInput schema / properties / includePaths / description
```
Removed value: -"Only crawl URLs whose path matches one of these patterns."
```
- addedInput schema / properties / includePaths / items / description
```
Added value: +"Non-empty after trimming; no CR/LF; UTF-8 byte length is bounded."
```
- removedInput schema / properties / includePaths / items / maxLength
```
Removed value: -256
```
- addedInput schema / properties / includePaths / items / pattern
```
Added value: +"^[^\\r\\n]*\\S[^\\r\\n]*$(?![\\s\\S])"
```
- addedInput schema / properties / includePaths / items / x-aisa-max-utf8-bytes
```
Added value: +256
```
- changedInput schema / properties / includePaths / type
```
Previous value: -"array"New value: +[
+  "array",
+  "null"
+]
```
- removedInput schema / properties / limit / description
```
Removed value: -"Maximum number of pages to crawl."
```
- removedInput schema / properties / limit / example
```
Removed value: -50
```
- removedInput schema / properties / maxConcurrency / description
```
Removed value: -"Maximum number of concurrent page fetches (1 to 20)."
```
- changedInput schema / properties / maxConcurrency / type
```
Previous value: -"integer"New value: +[
+  "integer",
+  "null"
+]
```
- removedInput schema / properties / maxDiscoveryDepth / description
```
Removed value: -"Maximum link-discovery depth from the root URL."
```
- changedInput schema / properties / maxDiscoveryDepth / type
```
Previous value: -"integer"New value: +[
+  "integer",
+  "null"
+]
```
- addedInput schema / properties / scrapeOptions / additionalProperties
```
Added value: +{
+  "not": {}
+}
```
- removedInput schema / properties / scrapeOptions / description
```
Removed value: -"Per-page scrape options applied while crawling. On the metered profile output is always markdown."
```
- removedInput schema / properties / scrapeOptions / properties / excludeTags / description
```
Removed value: -"HTML tags/selectors to drop."
```
- addedInput schema / properties / scrapeOptions / properties / excludeTags / items / description
```
Added value: +"Non-empty after trimming; no CR/LF; UTF-8 byte length is bounded."
```
- removedInput schema / properties / scrapeOptions / properties / excludeTags / items / maxLength
```
Removed value: -128
```
- addedInput schema / properties / scrapeOptions / properties / excludeTags / items / pattern
```
Added value: +"^[^\\r\\n]*\\S[^\\r\\n]*$(?![\\s\\S])"
```
- addedInput schema / properties / scrapeOptions / properties / excludeTags / items / x-aisa-max-utf8-bytes
```
Added value: +128
```
- changedInput schema / properties / scrapeOptions / properties / excludeTags / type
```
Previous value: -"array"New value: +[
+  "array",
+  "null"
+]
```
- removedInput schema / properties / scrapeOptions / properties / includeTags / description
```
Removed value: -"HTML tags/selectors to keep."
```
- addedInput schema / properties / scrapeOptions / properties / includeTags / items / description
```
Added value: +"Non-empty after trimming; no CR/LF; UTF-8 byte length is bounded."
```
- removedInput schema / properties / scrapeOptions / properties / includeTags / items / maxLength
```
Removed value: -128
```
- addedInput schema / properties / scrapeOptions / properties / includeTags / items / pattern
```
Added value: +"^[^\\r\\n]*\\S[^\\r\\n]*$(?![\\s\\S])"
```
- addedInput schema / properties / scrapeOptions / properties / includeTags / items / x-aisa-max-utf8-bytes
```
Added value: +128
```
- changedInput schema / properties / scrapeOptions / properties / includeTags / type
```
Previous value: -"array"New value: +[
+  "array",
+  "null"
+]
```
- removedInput schema / properties / scrapeOptions / properties / maxAge / description
```
Removed value: -"Maximum acceptable cache age in milliseconds."
```
- changedInput schema / properties / scrapeOptions / properties / maxAge / type
```
Previous value: -"integer"New value: +[
+  "integer",
+  "null"
+]
```
- removedInput schema / properties / scrapeOptions / properties / minAge / description
```
Removed value: -"Minimum cache age in milliseconds before a page is refetched."
```
- changedInput schema / properties / scrapeOptions / properties / minAge / type
```
Previous value: -"integer"New value: +[
+  "integer",
+  "null"
+]
```
- removedInput schema / properties / scrapeOptions / properties / onlyMainContent / default
```
Removed value: -true
```
- removedInput schema / properties / scrapeOptions / properties / onlyMainContent / description
```
Removed value: -"Return only the main content of each page."
```
- changedInput schema / properties / scrapeOptions / properties / onlyMainContent / type
```
Previous value: -"boolean"New value: +[
+  "boolean",
+  "null"
+]
```
- removedInput schema / properties / scrapeOptions / properties / timeout / description
```
Removed value: -"Per-page timeout in milliseconds."
```
- changedInput schema / properties / scrapeOptions / properties / timeout / type
```
Previous value: -"integer"New value: +[
+  "integer",
+  "null"
+]
```
- changedInput schema / properties / scrapeOptions / type
```
Previous value: -"object"New value: +[
+  "object",
+  "null"
+]
```
- removedInput schema / properties / sitemap / description
```
Removed value: -"How the site's sitemap is used during discovery."
```
- changedInput schema / properties / sitemap / enum
```
Previous value: -[
-  "skip",
-  "include",
-  "only"
-]New value: +[
+  null,
+  "skip",
+  "include",
+  "only"
+]
```
- changedInput schema / properties / sitemap / type
```
Previous value: -"string"New value: +[
+  "string",
+  "null"
+]
```
- changedInput schema / properties / url / description
```
Previous value: -"The HTTPS root URL to crawl. PDF URLs are not supported."New value: +"HTTPS URL with a hostname, without credentials or fragment. Trimmed input ending in .pdf (case insensitive) is not supported."
```
- removedInput schema / properties / url / example
```
Removed value: -"https://docs.firecrawl.dev"
```
- removedInput schema / properties / url / format
```
Removed value: -"uri"
```
- addedInput schema / properties / url / pattern
```
Added value: +"^\\s*[hH][tT][tT][pP][sS]://"
```
Changed64 schema fields changedOct 15, 2026
- changedInput schema / properties / Idempotency-Key / description
```
Previous value: -"Trimmed UTF-8 length must be 1 through 191 bytes."New value: +"Unique key (1 to 191 characters) that makes the submit idempotent. Re-submitting with the same key returns the original job."
```
- addedInput schema / properties / Idempotency-Key / maxLength
```
Added value: +191
```
- removedInput schema / properties / Idempotency-Key / pattern
```
Removed value: -"\\S"
```
- removedInput schema / properties / X-AISA-Cost-Mode
```
Removed value: -{
-  "description": "Return a read-only cost quote instead of submitting a job.",
-  "enum": [
-    "quote"
-  ],
-  "type": "string"
-}
```
- removedInput schema / properties / X-AISA-Max-Price-USD
```
Removed value: -{
-  "description": "Optional maximum customer authorization in USD, validated by the runtime price parser.",
-  "type": "string"
-}
```
- addedInput schema / properties / allowExternalLinks / description
```
Added value: +"Follow links to external domains."
```
- changedInput schema / properties / allowExternalLinks / type
```
Previous value: -[
-  "boolean",
-  "null"
-]New value: +"boolean"
```
- addedInput schema / properties / allowSubdomains / description
```
Added value: +"Follow links into subdomains of the root domain."
```
- changedInput schema / properties / allowSubdomains / type
```
Previous value: -[
-  "boolean",
-  "null"
-]New value: +"boolean"
```
- addedInput schema / properties / crawlEntireDomain / description
```
Added value: +"Crawl the whole domain rather than only the subtree under the root URL."
```
- changedInput schema / properties / crawlEntireDomain / type
```
Previous value: -[
-  "boolean",
-  "null"
-]New value: +"boolean"
```
- addedInput schema / properties / delay / description
```
Added value: +"Delay in seconds between requests (0 to 30)."
```
- changedInput schema / properties / delay / type
```
Previous value: -[
-  "number",
-  "null"
-]New value: +"number"
```
- addedInput schema / properties / excludePaths / description
```
Added value: +"Skip URLs whose path matches one of these patterns."
```
- removedInput schema / properties / excludePaths / items / description
```
Removed value: -"Non-empty after trimming; no CR/LF; UTF-8 byte length is bounded."
```
- addedInput schema / properties / excludePaths / items / maxLength
```
Added value: +256
```
- removedInput schema / properties / excludePaths / items / pattern
```
Removed value: -"^[^\\r\\n]*\\S[^\\r\\n]*$(?![\\s\\S])"
```
- removedInput schema / properties / excludePaths / items / x-aisa-max-utf8-bytes
```
Removed value: -256
```
- changedInput schema / properties / excludePaths / type
```
Previous value: -[
-  "array",
-  "null"
-]New value: +"array"
```
- addedInput schema / properties / ignoreQueryParameters / description
```
Added value: +"Treat URLs that differ only by query string as the same page."
```
- changedInput schema / properties / ignoreQueryParameters / type
```
Previous value: -[
-  "boolean",
-  "null"
-]New value: +"boolean"
```
- addedInput schema / properties / includePaths / description
```
Added value: +"Only crawl URLs whose path matches one of these patterns."
```
- removedInput schema / properties / includePaths / items / description
```
Removed value: -"Non-empty after trimming; no CR/LF; UTF-8 byte length is bounded."
```
- addedInput schema / properties / includePaths / items / maxLength
```
Added value: +256
```
- removedInput schema / properties / includePaths / items / pattern
```
Removed value: -"^[^\\r\\n]*\\S[^\\r\\n]*$(?![\\s\\S])"
```
- removedInput schema / properties / includePaths / items / x-aisa-max-utf8-bytes
```
Removed value: -256
```
- changedInput schema / properties / includePaths / type
```
Previous value: -[
-  "array",
-  "null"
-]New value: +"array"
```
- addedInput schema / properties / limit / description
```
Added value: +"Maximum number of pages to crawl."
```
- addedInput schema / properties / limit / example
```
Added value: +50
```
- addedInput schema / properties / maxConcurrency / description
```
Added value: +"Maximum number of concurrent page fetches (1 to 20)."
```
- changedInput schema / properties / maxConcurrency / type
```
Previous value: -[
-  "integer",
-  "null"
-]New value: +"integer"
```
- addedInput schema / properties / maxDiscoveryDepth / description
```
Added value: +"Maximum link-discovery depth from the root URL."
```
- changedInput schema / properties / maxDiscoveryDepth / type
```
Previous value: -[
-  "integer",
-  "null"
-]New value: +"integer"
```
- removedInput schema / properties / scrapeOptions / additionalProperties
```
Removed value: -{
-  "not": {}
-}
```
- addedInput schema / properties / scrapeOptions / description
```
Added value: +"Per-page scrape options applied while crawling. On the metered profile output is always markdown."
```
- addedInput schema / properties / scrapeOptions / properties / excludeTags / description
```
Added value: +"HTML tags/selectors to drop."
```
- removedInput schema / properties / scrapeOptions / properties / excludeTags / items / description
```
Removed value: -"Non-empty after trimming; no CR/LF; UTF-8 byte length is bounded."
```
- addedInput schema / properties / scrapeOptions / properties / excludeTags / items / maxLength
```
Added value: +128
```
- removedInput schema / properties / scrapeOptions / properties / excludeTags / items / pattern
```
Removed value: -"^[^\\r\\n]*\\S[^\\r\\n]*$(?![\\s\\S])"
```
- removedInput schema / properties / scrapeOptions / properties / excludeTags / items / x-aisa-max-utf8-bytes
```
Removed value: -128
```
- changedInput schema / properties / scrapeOptions / properties / excludeTags / type
```
Previous value: -[
-  "array",
-  "null"
-]New value: +"array"
```
- addedInput schema / properties / scrapeOptions / properties / includeTags / description
```
Added value: +"HTML tags/selectors to keep."
```
- removedInput schema / properties / scrapeOptions / properties / includeTags / items / description
```
Removed value: -"Non-empty after trimming; no CR/LF; UTF-8 byte length is bounded."
```
- addedInput schema / properties / scrapeOptions / properties / includeTags / items / maxLength
```
Added value: +128
```
- removedInput schema / properties / scrapeOptions / properties / includeTags / items / pattern
```
Removed value: -"^[^\\r\\n]*\\S[^\\r\\n]*$(?![\\s\\S])"
```
- removedInput schema / properties / scrapeOptions / properties / includeTags / items / x-aisa-max-utf8-bytes
```
Removed value: -128
```
- changedInput schema / properties / scrapeOptions / properties / includeTags / type
```
Previous value: -[
-  "array",
-  "null"
-]New value: +"array"
```
- addedInput schema / properties / scrapeOptions / properties / maxAge / description
```
Added value: +"Maximum acceptable cache age in milliseconds."
```
- changedInput schema / properties / scrapeOptions / properties / maxAge / type
```
Previous value: -[
-  "integer",
-  "null"
-]New value: +"integer"
```
- addedInput schema / properties / scrapeOptions / properties / minAge / description
```
Added value: +"Minimum cache age in milliseconds before a page is refetched."
```
- changedInput schema / properties / scrapeOptions / properties / minAge / type
```
Previous value: -[
-  "integer",
-  "null"
-]New value: +"integer"
```
- addedInput schema / properties / scrapeOptions / properties / onlyMainContent / default
```
Added value: +true
```
- addedInput schema / properties / scrapeOptions / properties / onlyMainContent / description
```
Added value: +"Return only the main content of each page."
```
- changedInput schema / properties / scrapeOptions / properties / onlyMainContent / type
```
Previous value: -[
-  "boolean",
-  "null"
-]New value: +"boolean"
```
- addedInput schema / properties / scrapeOptions / properties / timeout / description
```
Added value: +"Per-page timeout in milliseconds."
```
- changedInput schema / properties / scrapeOptions / properties / timeout / type
```
Previous value: -[
-  "integer",
-  "null"
-]New value: +"integer"
```
- changedInput schema / properties / scrapeOptions / type
```
Previous value: -[
-  "object",
-  "null"
-]New value: +"object"
```
- addedInput schema / properties / sitemap / description
```
Added value: +"How the site's sitemap is used during discovery."
```
- changedInput schema / properties / sitemap / enum
```
Previous value: -[
-  null,
-  "skip",
-  "include",
-  "only"
-]New value: +[
+  "skip",
+  "include",
+  "only"
+]
```
- changedInput schema / properties / sitemap / type
```
Previous value: -[
-  "string",
-  "null"
-]New value: +"string"
```
- changedInput schema / properties / url / description
```
Previous value: -"HTTPS URL with a hostname, without credentials or fragment. Trimmed input ending in .pdf (case insensitive) is not supported."New value: +"The HTTPS root URL to crawl. PDF URLs are not supported."
```
- addedInput schema / properties / url / example
```
Added value: +"https://docs.firecrawl.dev"
```
- addedInput schema / properties / url / format
```
Added value: +"uri"
```
- removedInput schema / properties / url / pattern
```
Removed value: -"^\\s*[hH][tT][tT][pP][sS]://"
```
Changed64 schema fields changedOct 15, 2026
- changedInput schema / properties / Idempotency-Key / description
```
Previous value: -"Unique key (1 to 191 characters) that makes the submit idempotent. Re-submitting with the same key returns the original job."New value: +"Trimmed UTF-8 length must be 1 through 191 bytes."
```
- removedInput schema / properties / Idempotency-Key / maxLength
```
Removed value: -191
```
- addedInput schema / properties / Idempotency-Key / pattern
```
Added value: +"\\S"
```
- addedInput schema / properties / X-AISA-Cost-Mode
```
Added value: +{
+  "description": "Return a read-only cost quote instead of submitting a job.",
+  "enum": [
+    "quote"
+  ],
+  "type": "string"
+}
```
- addedInput schema / properties / X-AISA-Max-Price-USD
```
Added value: +{
+  "description": "Optional maximum customer authorization in USD, validated by the runtime price parser.",
+  "type": "string"
+}
```
- removedInput schema / properties / allowExternalLinks / description
```
Removed value: -"Follow links to external domains."
```
- changedInput schema / properties / allowExternalLinks / type
```
Previous value: -"boolean"New value: +[
+  "boolean",
+  "null"
+]
```
- removedInput schema / properties / allowSubdomains / description
```
Removed value: -"Follow links into subdomains of the root domain."
```
- changedInput schema / properties / allowSubdomains / type
```
Previous value: -"boolean"New value: +[
+  "boolean",
+  "null"
+]
```
- removedInput schema / properties / crawlEntireDomain / description
```
Removed value: -"Crawl the whole domain rather than only the subtree under the root URL."
```
- changedInput schema / properties / crawlEntireDomain / type
```
Previous value: -"boolean"New value: +[
+  "boolean",
+  "null"
+]
```
- removedInput schema / properties / delay / description
```
Removed value: -"Delay in seconds between requests (0 to 30)."
```
- changedInput schema / properties / delay / type
```
Previous value: -"number"New value: +[
+  "number",
+  "null"
+]
```
- removedInput schema / properties / excludePaths / description
```
Removed value: -"Skip URLs whose path matches one of these patterns."
```
- addedInput schema / properties / excludePaths / items / description
```
Added value: +"Non-empty after trimming; no CR/LF; UTF-8 byte length is bounded."
```
- removedInput schema / properties / excludePaths / items / maxLength
```
Removed value: -256
```
- addedInput schema / properties / excludePaths / items / pattern
```
Added value: +"^[^\\r\\n]*\\S[^\\r\\n]*$(?![\\s\\S])"
```
- addedInput schema / properties / excludePaths / items / x-aisa-max-utf8-bytes
```
Added value: +256
```
- changedInput schema / properties / excludePaths / type
```
Previous value: -"array"New value: +[
+  "array",
+  "null"
+]
```
- removedInput schema / properties / ignoreQueryParameters / description
```
Removed value: -"Treat URLs that differ only by query string as the same page."
```
- changedInput schema / properties / ignoreQueryParameters / type
```
Previous value: -"boolean"New value: +[
+  "boolean",
+  "null"
+]
```
- removedInput schema / properties / includePaths / description
```
Removed value: -"Only crawl URLs whose path matches one of these patterns."
```
- addedInput schema / properties / includePaths / items / description
```
Added value: +"Non-empty after trimming; no CR/LF; UTF-8 byte length is bounded."
```
- removedInput schema / properties / includePaths / items / maxLength
```
Removed value: -256
```
- addedInput schema / properties / includePaths / items / pattern
```
Added value: +"^[^\\r\\n]*\\S[^\\r\\n]*$(?![\\s\\S])"
```
- addedInput schema / properties / includePaths / items / x-aisa-max-utf8-bytes
```
Added value: +256
```
- changedInput schema / properties / includePaths / type
```
Previous value: -"array"New value: +[
+  "array",
+  "null"
+]
```
- removedInput schema / properties / limit / description
```
Removed value: -"Maximum number of pages to crawl."
```
- removedInput schema / properties / limit / example
```
Removed value: -50
```
- removedInput schema / properties / maxConcurrency / description
```
Removed value: -"Maximum number of concurrent page fetches (1 to 20)."
```
- changedInput schema / properties / maxConcurrency / type
```
Previous value: -"integer"New value: +[
+  "integer",
+  "null"
+]
```
- removedInput schema / properties / maxDiscoveryDepth / description
```
Removed value: -"Maximum link-discovery depth from the root URL."
```
- changedInput schema / properties / maxDiscoveryDepth / type
```
Previous value: -"integer"New value: +[
+  "integer",
+  "null"
+]
```
- addedInput schema / properties / scrapeOptions / additionalProperties
```
Added value: +{
+  "not": {}
+}
```
- removedInput schema / properties / scrapeOptions / description
```
Removed value: -"Per-page scrape options applied while crawling. On the metered profile output is always markdown."
```
- removedInput schema / properties / scrapeOptions / properties / excludeTags / description
```
Removed value: -"HTML tags/selectors to drop."
```
- addedInput schema / properties / scrapeOptions / properties / excludeTags / items / description
```
Added value: +"Non-empty after trimming; no CR/LF; UTF-8 byte length is bounded."
```
- removedInput schema / properties / scrapeOptions / properties / excludeTags / items / maxLength
```
Removed value: -128
```
- addedInput schema / properties / scrapeOptions / properties / excludeTags / items / pattern
```
Added value: +"^[^\\r\\n]*\\S[^\\r\\n]*$(?![\\s\\S])"
```
- addedInput schema / properties / scrapeOptions / properties / excludeTags / items / x-aisa-max-utf8-bytes
```
Added value: +128
```
- changedInput schema / properties / scrapeOptions / properties / excludeTags / type
```
Previous value: -"array"New value: +[
+  "array",
+  "null"
+]
```
- removedInput schema / properties / scrapeOptions / properties / includeTags / description
```
Removed value: -"HTML tags/selectors to keep."
```
- addedInput schema / properties / scrapeOptions / properties / includeTags / items / description
```
Added value: +"Non-empty after trimming; no CR/LF; UTF-8 byte length is bounded."
```
- removedInput schema / properties / scrapeOptions / properties / includeTags / items / maxLength
```
Removed value: -128
```
- addedInput schema / properties / scrapeOptions / properties / includeTags / items / pattern
```
Added value: +"^[^\\r\\n]*\\S[^\\r\\n]*$(?![\\s\\S])"
```
- addedInput schema / properties / scrapeOptions / properties / includeTags / items / x-aisa-max-utf8-bytes
```
Added value: +128
```
- changedInput schema / properties / scrapeOptions / properties / includeTags / type
```
Previous value: -"array"New value: +[
+  "array",
+  "null"
+]
```
- removedInput schema / properties / scrapeOptions / properties / maxAge / description
```
Removed value: -"Maximum acceptable cache age in milliseconds."
```
- changedInput schema / properties / scrapeOptions / properties / maxAge / type
```
Previous value: -"integer"New value: +[
+  "integer",
+  "null"
+]
```
- removedInput schema / properties / scrapeOptions / properties / minAge / description
```
Removed value: -"Minimum cache age in milliseconds before a page is refetched."
```
- changedInput schema / properties / scrapeOptions / properties / minAge / type
```
Previous value: -"integer"New value: +[
+  "integer",
+  "null"
+]
```
- removedInput schema / properties / scrapeOptions / properties / onlyMainContent / default
```
Removed value: -true
```
- removedInput schema / properties / scrapeOptions / properties / onlyMainContent / description
```
Removed value: -"Return only the main content of each page."
```
- changedInput schema / properties / scrapeOptions / properties / onlyMainContent / type
```
Previous value: -"boolean"New value: +[
+  "boolean",
+  "null"
+]
```
- removedInput schema / properties / scrapeOptions / properties / timeout / description
```
Removed value: -"Per-page timeout in milliseconds."
```
- changedInput schema / properties / scrapeOptions / properties / timeout / type
```
Previous value: -"integer"New value: +[
+  "integer",
+  "null"
+]
```
- changedInput schema / properties / scrapeOptions / type
```
Previous value: -"object"New value: +[
+  "object",
+  "null"
+]
```
- removedInput schema / properties / sitemap / description
```
Removed value: -"How the site's sitemap is used during discovery."
```
- changedInput schema / properties / sitemap / enum
```
Previous value: -[
-  "skip",
-  "include",
-  "only"
-]New value: +[
+  null,
+  "skip",
+  "include",
+  "only"
+]
```
- changedInput schema / properties / sitemap / type
```
Previous value: -"string"New value: +[
+  "string",
+  "null"
+]
```
- changedInput schema / properties / url / description
```
Previous value: -"The HTTPS root URL to crawl. PDF URLs are not supported."New value: +"HTTPS URL with a hostname, without credentials or fragment. Trimmed input ending in .pdf (case insensitive) is not supported."
```
- removedInput schema / properties / url / example
```
Removed value: -"https://docs.firecrawl.dev"
```
- removedInput schema / properties / url / format
```
Removed value: -"uri"
```
- addedInput schema / properties / url / pattern
```
Added value: +"^\\s*[hH][tT][tT][pP][sS]://"
```
First observedSep 15, 2026

TDQS

C2.1/5.0

Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already declare destructiveHint=true, openWorldHint=true, readOnlyHint=false and idempotentHint=false, so the safety profile is covered elsewhere. The description adds only vague async-lifecycle and pricing boilerplate, and says nothing specific about job creation, polling via get_firecrawl_crawl_job, rate/limits, or the quote path even though a cost-mode parameter exists.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness2/5

Is the description appropriately sized, front-loaded, and free of redundancy?

It is short, but the opening sentence is not front-loaded with the tool's purpose, and the aisa-pricing HTML comment block is filler that does not earn its place for an invocation decision. Structure prioritizes platform boilerplate over the crawl action.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness1/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a complex, nested-object crawl submission with a required Idempotency-Key and an output schema, the description omits purpose, usage, return-job semantics, and how to retrieve results. An agent has essentially nothing usable beyond the name and title.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 75%, so the schema already documents most parameters (url, limits, path filters, scrapeOptions, Idempotency-Key, X-AISA-Cost-Mode). The description adds no parameter meaning whatsoever; the pricing note gestures at cost mode but with no actionable detail. Baseline 3 applies given the strong schema.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose2/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description never states that this tool submits a web crawl. 'Owner-scoped local asynchronous job lifecycle' is generic platform boilerplate that names no verb or resource tied to crawling, so an agent must fall back on the tool name/title to guess the purpose. It is at best vague and arguably misleading about what the tool actually computes.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

No when-to-use guidance is given, nor any routing to alternatives such as post_firecrawl_scrape, post_firecrawl_map, post_firecrawl_batch_scrape, or post_tavily_crawl. The admission-control sentence ('Disabling new admission does not disable existing job reads or cancellation') is a policy note, not a usage condition.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

All AIsa Web Search & Research tools Inspect

Try in Browser

Let your AI agent see the webWeb-to-screenshot MCP for Claude, Cursor and Codex. No cookie banners. Free to start.snap-render.comAd

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources

Need Help?