Summary

This PR replaces the old ReadTheDocs/Sphinx documentation setup with a static GitHub Pages site for serpapi-python (using the great-docs Python package).

• A live sample can be seen on my personal fork: https://adarshdigievo.github.io/serpapi-python/
• Solves issue [Proposal] Use great-docs package for documentation #28
• The docs build will generate a static site that can be automatically deployed to GitHub Pages at serpapi.github.io/serpapi-python when a new version is released.

When docs are built

Deployed docs are built from the release workflow on version tags matching v**.

The release flow is now:

1. run tests
2. build distribution
3. publish release
4. smoke-test the published PyPI package
5. build Great Docs
6. upload and deploy the Pages artifact

New dependency

Adds an optional docs extra:

docs = ["great-docs>=0.12; python_version >= '3.11'"]

New docs tests

Adds doc tests. The code snippets present in docs pages are included in the pytest suite of the package via tests/test_docs_examples.py, which executes Python fenced code blocks from:

• README.md
• docs/index.md
• docs/user_guide/*.md
• docs/examples/*.md

The test uses SERPAPI_KEY or API_KEY, replaces placeholder secret_api_key values, and supports <!-- docs-test: skip ... --> for examples that should not run, such as proxy/TLS placeholder snippets.

pyproject.toml also enables module doctests for serpapi.

Removed old docs setup

Removes the ReadTheDocs/Sphinx files:

• .readthedocs.yaml
• docs/Makefile
• docs/conf.py
• docs/requirements.txt
• docs/index.rst
• docs/_static/serpapi-python.png

.gitignore now ignores the generated great-docs/ output instead of docs/build.

Docs structure overview

Adds:

• great-docs.yml for site configuration, navigation, API reference grouping, theme settings, and llms.txt pre-render generation.
• docs/index.md as the docs homepage.
• docs/user_guide/ pages for setup, client usage, parameters, pagination, errors/timeouts, account/location helpers, migration, async archive, threading, multiprocessing, zero trace, JSON Restrictor, and request options.
• docs/examples/ pages grouped by search engines, AI answers, local/maps, shopping, travel, finance/trends/jobs/events, media/apps/research.
• custom SerpApi branding and docs styling in assets/.
• scripts/build_llms_txt.py so /llms.txt includes useful homepage/getting-started context, not only API reference links.
• Python docstrings of core.py and models.py files are changed to match the great-docs supported format.
• No core code changes are made. PR touches doc-related functionality only.

Screenshots: