Google Search
This skill searches Google using a stealthy fetcher and returns structured results suitable for LLM consumption.
Usage
Run the python script google_search.py with the query as an argument.
python google_search.py "<query>"
File Structure
- 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.
- verify_search.py: A debugging script. It runs a predefined set of queries to verify that the search functionality works correctly.
- requirements.txt: Lists the Python dependencies required for the project.
Requirements
- Python 3
scrapling package installed (with playwright and curl_cffi dependencies)
To install dependencies:
pip install -r requirements.txt
playwright install # Required for browser automation. If slow, consider downloading manually.
Notes & Troubleshooting
Browser Environment (Headless=False)
This skill is configured to run with headless=False (see google_search.py). This means:
- GUI Required: The environment where this code runs must support a Graphical User Interface (GUI). It will launch a visible browser window.
- 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.
Debugging with verify_search.py
If you encounter issues or want to test if the setup is working:
- Run
python verify_search.py.
- This script will execute several test queries (e.g., "python tutorial", mixed English/Chinese).
- Watch the browser window to see if it opens and loads Google results.
- Check the console output for success messages or error logs.