feat(search): add highlights option

README.md

@@ -313,6 +313,8 @@ firecrawl search "AI data tools"
 | `--location <location>`      | Geo-targeting (e.g., "Germany", "San Francisco,California,United States")                   |
 | `--country <code>`           | ISO country code (default: US)                                                              |
 | `--timeout <ms>`             | Timeout in milliseconds (default: 60000)                                                    |
+| `--highlights`               | Return query-relevant highlights for each result                                            |
+| `--no-highlights`            | Keep the original search snippets                                                           |
 | `--ignore-invalid-urls`      | Exclude URLs invalid for other Firecrawl endpoints                                          |
 | `--scrape`                   | Enable scraping of search results                                                           |
 | `--scrape-formats <formats>` | Scrape formats when `--scrape` enabled (default: markdown)                                  |

package.json

@@ -1,6 +1,6 @@
 {
   "name": "firecrawl-cli",
-  "version": "1.19.26",
+  "version": "1.19.27",
   "description": "Command-line interface for Firecrawl. Scrape, crawl, and extract data from any website directly from your terminal.",
   "main": "dist/index.js",
   "bin": {

src/__tests__/commands/search.test.ts

@@ -84,6 +84,23 @@ describe('executeSearch', () => {
       });
     });
 
+    it('should allow highlights to be disabled', async () => {
+      mockHttpPost.mockResolvedValue(mockSearchResponse({ web: [] }));
+
+      await executeSearch({
+        query: 'test query',
+        highlights: false,
+      });
+
+      expect(mockHttpPost).toHaveBeenCalledWith(
+        '/v2/search',
+        expect.objectContaining({
+          highlights: false,
+          query: 'test query',
+        })
+      );
+    });
+
     it('should pass apiUrl to getClient when provided', async () => {
       mockHttpPost.mockResolvedValue(mockSearchResponse({ web: [] }));
 

src/commands/search.ts

@@ -27,6 +27,10 @@ export async function executeSearch(
       integration: 'cli',
     };
 
+    if (options.highlights !== undefined) {
+      searchParams.highlights = options.highlights;
+    }
+
     // Add sources if specified
     if (options.sources && options.sources.length > 0) {
       searchParams.sources = options.sources.map((source) => ({

src/index.ts

@@ -943,6 +943,14 @@ function createSearchCommand(): Command {
       'Exclude URLs invalid for other Firecrawl endpoints',
       false
     )
+    .option(
+      '--highlights',
+      'Return query-relevant highlights for each search result'
+    )
+    .option(
+      '--no-highlights',
+      'Keep the original search snippets instead of returning highlights'
+    )
     .option('--scrape', 'Enable scraping of search results', false)
     .option(
       '--scrape-formats <formats>',
@@ -1022,6 +1030,7 @@ function createSearchCommand(): Command {
         country: options.country,
         timeout: options.timeout,
         ignoreInvalidUrls: options.ignoreInvalidUrls,
+        highlights: options.highlights,
         scrape: options.scrape,
         scrapeFormats,
         onlyMainContent: options.onlyMainContent,

src/types/search.ts

@@ -30,6 +30,8 @@ export interface SearchOptions {
   timeout?: number;
   /** Exclude URLs invalid for other Firecrawl endpoints */
   ignoreInvalidUrls?: boolean;
+  /** Return query-relevant highlights instead of the original search snippets */
+  highlights?: boolean;
   /** Output file path */
   output?: string;
   /** Output as JSON format */