ddg-playwright-search

DuckDuckGo search scraping utility using Playwright.

Features

• Scrape DuckDuckGo search results with Playwright
• Customizable selectors, user agent, proxy, and more
• Automatic profile isolation and cleanup

Installation

npm install ddg-playwright-search

Usage

import { searchDuck } from 'ddg-playwright-search';

(async () => {
  const results = await searchDuck('playwright npm package', {
    maxLinks: 5,
    headless: true
  });
  console.log(results);
})();

API

searchDuck(query, options)

• query (string): Search query for DuckDuckGo
• options (object):
  • maxLinks (number): Maximum number of links to return (default: 3)
  • selector (string): CSS selector for result links
  • attribute (string): Attribute to extract from links (default: 'href')
  • headless (boolean): Run browser in headless mode (default: true)
  • userAgent (string): Custom user agent string
  • viewport (object): Browser viewport size
  • profileDirBase (string): Base directory for browser profiles
  • timeout (number): Navigation and selector wait timeout (ms)
  • waitForSelector (string): Selector to wait for
  • proxy (object): Proxy settings for Playwright
  • extraLaunchArgs (array): Extra launch arguments for Playwright
  • gotoOptions (object): Additional options for page.goto

Returns: Array of { title, href, snippet } objects.

License

MIT