.. google-search-playwright documentation master file.
   You can adapt this file completely to your liking, but it should at least
   contain the root `toctree` directive.

Welcome to google-search-playwright's documentation!
===================================================

Google search from Python, powered by Playwright.

This project is not affiliated with Google in any way.

Why this fork?
==============

Google's web search interface now requires JavaScript for most requests,
which broke the classic urllib + BeautifulSoup scraping used by the original
``googlesearch`` library. This package replaces that stack with a real
headless browser driven by Playwright so it keeps working against the current
Google search experience.

Usage
=====

.. code-block:: python

    from googlesearch import search

    # Get the first 20 hits for: "Breaking Code" WordPress blog
    for url in search('"Breaking Code" WordPress blog', stop=20):
        print(url)

.. code-block:: python

    from googlesearch import search, lucky

    # "I'm feeling lucky"
    first = lucky('python programming')
    print(first)

Browser auto-detection
======================

The library searches in this order:

1. Chromium/Chrome family via PATH.
2. Chromium/Chrome family at platform-specific paths (macOS, Windows).
3. Firefox via PATH.
4. Firefox at platform-specific paths.

You can override with ``search(..., browser_type="firefox", exe_path="/path")``.

Indices and tables
==================

* :ref:`genindex`
* :ref:`modindex`
* :ref:`search`

Reference
=========

.. automodule:: googlesearch
   :members: