\r \r

Google Search\r

\r This skill searches Google using a stealthy fetcher and returns structured results suitable for LLM consumption.\r \r

Usage\r

\r Run the python script google_search.py with the query as an argument.\r \r

python google_search.py "\x3Cquery>"\r
```\r
\r
## File Structure\r
\r
- **google_search.py**: The main script. It uses `scrapling` to perform the Google search. It launches a browser instance to fetch results, ensuring high success rates by mimicking real user behavior.\r
- **verify_search.py**: A debugging script. It runs a predefined set of queries to verify that the search functionality works correctly.\r
- **requirements.txt**: Lists the Python dependencies required for the project.\r
\r
## Requirements\r
\r
- Python 3\r
- `scrapling` package installed (with `playwright` and `curl_cffi` dependencies)\r
\r
To install dependencies:\r
```bash\r
pip install -r requirements.txt\r
playwright install  # Required for browser automation. If slow, consider downloading manually.\r
```\r
\r
## Notes & Troubleshooting\r
\r
### Browser Environment (Headless=False)\r
This skill is configured to run with **`headless=False`** (see `google_search.py`). This means:\r
1.  **GUI Required**: The environment where this code runs **must** support a Graphical User Interface (GUI). It will launch a visible browser window.\r
2.  **No Headless Servers**: It will likely fail on headless servers (like standard CI/CD runners or SSH-only servers) unless X11 forwarding or a virtual display (like `xvfb`) is configured.\r
\r
### Debugging with `verify_search.py`\r
If you encounter issues or want to test if the setup is working:\r
1.  Run `python verify_search.py`.\r
2.  This script will execute several test queries (e.g., "python tutorial", mixed English/Chinese).\r
3.  Watch the browser window to see if it opens and loads Google results.\r
4.  Check the console output for success messages or error logs.