firecrawl 1.20.0 → 1.21.0

package/dist/index.cjs

@@ -841,7 +841,7 @@ var FirecrawlApp = class {
    * @param {string} action - The action being performed when the error occurred.
    */
   handleError(response, action) {
-    if ([400, 402, 408, 409, 500].includes(response.status)) {
+    if ([400, 402, 403, 408, 409, 500].includes(response.status)) {
       const errorMessage = response.data.error || "Unknown error occurred";
       const details = response.data.details ? ` - ${JSON.stringify(response.data.details)}` : "";
       throw new FirecrawlError(
@@ -922,10 +922,25 @@ var FirecrawlApp = class {
    */
   async asyncDeepResearch(query, params) {
     const headers = this.prepareHeaders();
+    let jsonData = { query, ...params };
+    if (jsonData?.jsonOptions?.schema) {
+      let schema = jsonData.jsonOptions.schema;
+      try {
+        schema = (0, import_zod_to_json_schema.zodToJsonSchema)(schema);
+      } catch (error) {
+      }
+      jsonData = {
+        ...jsonData,
+        jsonOptions: {
+          ...jsonData.jsonOptions,
+          schema
+        }
+      };
+    }
     try {
       const response = await this.postRequest(
         `${this.apiUrl}/v1/deep-research`,
-        { query, ...params },
+        jsonData,
         headers
       );
       if (response.status === 200) {

package/dist/index.d.cts

@@ -97,6 +97,7 @@ type Action = {
 } | {
     type: "click";
     selector: string;
+    all?: boolean;
 } | {
     type: "screenshot";
     fullPage?: boolean;
@@ -325,7 +326,7 @@ interface CrawlErrorsResponse {
  * Parameters for deep research operations.
  * Defines options for conducting deep research on a query.
  */
-interface DeepResearchParams {
+interface DeepResearchParams<LLMSchema extends zt.ZodSchema = any> {
     /**
      * Maximum depth of research iterations (1-10)
      * @default 7
@@ -342,9 +343,25 @@ interface DeepResearchParams {
      */
     maxUrls?: number;
     /**
-     * Experimental flag for streaming steps
+     * The prompt to use for the final analysis
      */
-    __experimental_streamSteps?: boolean;
+    analysisPrompt?: string;
+    /**
+     * The system prompt to use for the research agent
+     */
+    systemPrompt?: string;
+    /**
+     * The formats to use for the final analysis
+     */
+    formats?: ("markdown" | "json")[];
+    /**
+     * The JSON options to use for the final analysis
+     */
+    jsonOptions?: {
+        prompt?: string;
+        schema?: LLMSchema;
+        systemPrompt?: string;
+    };
 }
 /**
  * Response interface for deep research operations.
@@ -613,7 +630,7 @@ declare class FirecrawlApp {
      * @param onSource - Optional callback to receive source updates in real-time.
      * @returns The final research results.
      */
-    deepResearch(query: string, params: DeepResearchParams, onActivity?: (activity: {
+    deepResearch(query: string, params: DeepResearchParams<zt.ZodSchema>, onActivity?: (activity: {
         type: string;
         status: string;
         message: string;
@@ -630,7 +647,7 @@ declare class FirecrawlApp {
      * @param params - Parameters for the deep research operation.
      * @returns The response containing the research job ID.
      */
-    asyncDeepResearch(query: string, params: DeepResearchParams): Promise<DeepResearchResponse | ErrorResponse>;
+    asyncDeepResearch(query: string, params: DeepResearchParams<zt.ZodSchema>): Promise<DeepResearchResponse | ErrorResponse>;
     /**
      * Checks the status of a deep research operation.
      * @param id - The ID of the deep research operation.

package/dist/index.d.ts

@@ -97,6 +97,7 @@ type Action = {
 } | {
     type: "click";
     selector: string;
+    all?: boolean;
 } | {
     type: "screenshot";
     fullPage?: boolean;
@@ -325,7 +326,7 @@ interface CrawlErrorsResponse {
  * Parameters for deep research operations.
  * Defines options for conducting deep research on a query.
  */
-interface DeepResearchParams {
+interface DeepResearchParams<LLMSchema extends zt.ZodSchema = any> {
     /**
      * Maximum depth of research iterations (1-10)
      * @default 7
@@ -342,9 +343,25 @@ interface DeepResearchParams {
      */
     maxUrls?: number;
     /**
-     * Experimental flag for streaming steps
+     * The prompt to use for the final analysis
      */
-    __experimental_streamSteps?: boolean;
+    analysisPrompt?: string;
+    /**
+     * The system prompt to use for the research agent
+     */
+    systemPrompt?: string;
+    /**
+     * The formats to use for the final analysis
+     */
+    formats?: ("markdown" | "json")[];
+    /**
+     * The JSON options to use for the final analysis
+     */
+    jsonOptions?: {
+        prompt?: string;
+        schema?: LLMSchema;
+        systemPrompt?: string;
+    };
 }
 /**
  * Response interface for deep research operations.
@@ -613,7 +630,7 @@ declare class FirecrawlApp {
      * @param onSource - Optional callback to receive source updates in real-time.
      * @returns The final research results.
      */
-    deepResearch(query: string, params: DeepResearchParams, onActivity?: (activity: {
+    deepResearch(query: string, params: DeepResearchParams<zt.ZodSchema>, onActivity?: (activity: {
         type: string;
         status: string;
         message: string;
@@ -630,7 +647,7 @@ declare class FirecrawlApp {
      * @param params - Parameters for the deep research operation.
      * @returns The response containing the research job ID.
      */
-    asyncDeepResearch(query: string, params: DeepResearchParams): Promise<DeepResearchResponse | ErrorResponse>;
+    asyncDeepResearch(query: string, params: DeepResearchParams<zt.ZodSchema>): Promise<DeepResearchResponse | ErrorResponse>;
     /**
      * Checks the status of a deep research operation.
      * @param id - The ID of the deep research operation.

package/dist/index.js

@@ -805,7 +805,7 @@ var FirecrawlApp = class {
    * @param {string} action - The action being performed when the error occurred.
    */
   handleError(response, action) {
-    if ([400, 402, 408, 409, 500].includes(response.status)) {
+    if ([400, 402, 403, 408, 409, 500].includes(response.status)) {
       const errorMessage = response.data.error || "Unknown error occurred";
       const details = response.data.details ? ` - ${JSON.stringify(response.data.details)}` : "";
       throw new FirecrawlError(
@@ -886,10 +886,25 @@ var FirecrawlApp = class {
    */
   async asyncDeepResearch(query, params) {
     const headers = this.prepareHeaders();
+    let jsonData = { query, ...params };
+    if (jsonData?.jsonOptions?.schema) {
+      let schema = jsonData.jsonOptions.schema;
+      try {
+        schema = zodToJsonSchema(schema);
+      } catch (error) {
+      }
+      jsonData = {
+        ...jsonData,
+        jsonOptions: {
+          ...jsonData.jsonOptions,
+          schema
+        }
+      };
+    }
     try {
       const response = await this.postRequest(
         `${this.apiUrl}/v1/deep-research`,
-        { query, ...params },
+        jsonData,
         headers
       );
       if (response.status === 200) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "firecrawl",
-  "version": "1.20.0",
+  "version": "1.21.0",
   "description": "JavaScript SDK for Firecrawl API",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package/src/index.ts

@@ -104,6 +104,7 @@ export type Action = {
 } | {
   type: "click",
   selector: string,
+  all?: boolean,
 } | {
   type: "screenshot",
   fullPage?: boolean,
@@ -355,7 +356,7 @@ export interface CrawlErrorsResponse {
  * Parameters for deep research operations.
  * Defines options for conducting deep research on a query.
  */
-export interface DeepResearchParams {
+export interface DeepResearchParams<LLMSchema extends zt.ZodSchema = any>  {
   /**
    * Maximum depth of research iterations (1-10)
    * @default 7
@@ -372,9 +373,29 @@ export interface DeepResearchParams {
    */
   maxUrls?: number;
   /**
+   * The prompt to use for the final analysis
+   */
+  analysisPrompt?: string;
+  /**
+   * The system prompt to use for the research agent
+   */
+  systemPrompt?: string;
+  /**
+   * The formats to use for the final analysis
+   */
+  formats?: ("markdown" | "json")[];
+  /**
+   * The JSON options to use for the final analysis
+   */
+  jsonOptions?:{
+    prompt?: string;
+    schema?: LLMSchema;
+    systemPrompt?: string;
+  };
+  /** 
    * Experimental flag for streaming steps
    */
-  __experimental_streamSteps?: boolean;
+  // __experimental_streamSteps?: boolean;
 }
 
 /**
@@ -1388,7 +1409,7 @@ export default class FirecrawlApp {
    * @param {string} action - The action being performed when the error occurred.
    */
   handleError(response: AxiosResponse, action: string): void {
-    if ([400, 402, 408, 409, 500].includes(response.status)) {
+    if ([400, 402, 403, 408, 409, 500].includes(response.status)) {
       const errorMessage: string =
         response.data.error || "Unknown error occurred";
       const details = response.data.details ? ` - ${JSON.stringify(response.data.details)}` : '';
@@ -1415,7 +1436,7 @@ export default class FirecrawlApp {
    */
   async deepResearch(
     query: string, 
-    params: DeepResearchParams,
+    params: DeepResearchParams<zt.ZodSchema>,
     onActivity?: (activity: {
       type: string;
       status: string;
@@ -1500,12 +1521,31 @@ export default class FirecrawlApp {
    * @param params - Parameters for the deep research operation.
    * @returns The response containing the research job ID.
    */
-  async asyncDeepResearch(query: string, params: DeepResearchParams): Promise<DeepResearchResponse | ErrorResponse> {
+  async asyncDeepResearch(query: string, params: DeepResearchParams<zt.ZodSchema>): Promise<DeepResearchResponse | ErrorResponse> {
     const headers = this.prepareHeaders();
+    let jsonData: any = { query, ...params };
+
+    if (jsonData?.jsonOptions?.schema) {
+      let schema = jsonData.jsonOptions.schema;
+      // Try parsing the schema as a Zod schema
+      try {
+        schema = zodToJsonSchema(schema);
+      } catch (error) {
+        
+      }
+      jsonData = {
+        ...jsonData,
+        jsonOptions: {
+          ...jsonData.jsonOptions,
+          schema: schema,
+        },
+      };
+    }
+
     try {
       const response: AxiosResponse = await this.postRequest(
         `${this.apiUrl}/v1/deep-research`,
-        { query, ...params },
+        jsonData,
         headers
       );