stealthy-google-search

TotalClaw 作者 totalclaw

通过 Scrapling 的 StealthyFetcher/StealthySession 进行 Google 搜索。用于运行 Google 查询并返回干净的顶级结果标题 + 链接（纯文本或 JSON）。包括一个确定性安装脚本，用于设置本地 venv 并安装 Scrapling fetchers + 浏览器。

安装 / 下载方式

TotalClaw CLI推荐

totalclaw skills install shop:totalclaw:totalclaw~itzsubhadip-stealthy-google-search

cURL直接下载，无需登录

curl -fsSL https://skills.taituai.com/api/skills/totalclaw%3Atotalclaw~itzsubhadip-stealthy-google-search/file -o itzsubhadip-stealthy-google-search.md

## 概述（中文）

通过 Scrapling 的 StealthyFetcher/StealthySession 进行 Google 搜索。用于运行 Google 查询并返回干净的顶级结果标题 + 链接（纯文本或 JSON）。包括一个确定性安装脚本，用于设置本地 venv 并安装 Scrapling fetchers + 浏览器。

## 原文

# Stealthy Google Search (Scrapling)

This skill provides **one job**: do Google searches reliably and return the top result titles + URLs.

It ships two scripts:
- `{baseDir}/scripts/install.sh` → installs dependencies into a local venv (recommended).
- `{baseDir}/scripts/google_search.py` → runs the search and prints results.

## Install (recommended)

Run:

```bash
bash {baseDir}/scripts/install.sh
```

What it does:
- Creates a venv at `{baseDir}/.venv`
- Installs `scrapling[fetchers]`
- Runs `scrapling install` (downloads Playwright browsers + system deps)

## Usage (plain text)

```bash
{baseDir}/.venv/bin/python {baseDir}/scripts/google_search.py \
  --query "Top Indian universities" \
  --top 10 \
  --hl en \
  --gl in
```

## Usage (JSON)

```bash
{baseDir}/.venv/bin/python {baseDir}/scripts/google_search.py \
  --query "Top Indian universities" \
  --top 10 \
  --hl en \
  --gl in \
  --json
```

## Requirements / gotchas

- Python **3.10+**
- Disk space for Playwright browsers (the install step downloads them)
- Some environments require `sudo` for Playwright **system** dependencies. The installer will attempt `sudo` if available.
- Google can rate-limit/block; this skill uses Scrapling’s stealth browser fetcher, but no scraper is 100% unblockable.