# scraping-google-search-results

Собирает результаты поиска Google по любому запросу: URL, заголовки, сниппеты, позиции и типы SERP-блоков. Пригодится, когда нужна сырая выдача для SEO или анализа конкурентов.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 759 установок · ★ 1
- Автор: apidojo
- Лицензия: Apache-2.0 · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/apidojo-io/apidojo-skills/tree/HEAD/skills/primitives/scraping-google-search-results/SKILL.md
- Обновлён: 2026-05-13
- HTML: https://affpapa.org/nevibecode/skills/scraping-google-search-results

## Что делает

Скилл запускает актор `apidojo/google-search-scraper` на Apify и отдаёт таблицу органических результатов вместе с featured snippets, блоком People Also Ask и другими элементами выдачи. На каждый результат есть поля query, position, url, title, description, type, а также sitelinks, rating и reviewsCount, если они есть.

На входе список поисковых запросов или готовые URL выдачи. Можно задать `countryCode` (по умолчанию `US`), `languageCode`, `maxItems`, `maxPagesPerQuery` (по умолчанию `1`) и `mobileResults`. Для запуска нужен `APIFY_TOKEN` в переменной окружения или в `.env` — без него ничего не поедет. Есть скрипт `scripts/run_actor.js`, который сам дожидается завершения и сохраняет результат в CSV или JSON; если стоит Apify MCP-сервер, тот же актор вызывается через `apify:run-actor`.

Позиции в выдаче зависят от геолокации и персонализации, поэтому для сравнимых данных `countryCode` лучше указывать явно. Если по запросу вернулись только объявления или панель знаний, органики не будет — это повод переформулировать запрос. При устойчивых блокировках со стороны Google автор советует уменьшить размер пакета запросов.

## Установка

### Claude Code (родная платформа)

1. **Через Skills CLI (Vercel)**
```bash
npx skills add apidojo-io/apidojo-skills --skill scraping-google-search-results -a claude-code
```

2. **Вручную: положить файлы**
- Файл: `~/.claude/skills/scraping-google-search-results/SKILL.md` — Папка скилла целиком; для одного проекта — .claude/skills/scraping-google-search-results/

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add apidojo-io/apidojo-skills --skill scraping-google-search-results -a codex
```

2. **Вручную: положить файлы**
- Файл: `.agents/skills/scraping-google-search-results/SKILL.md` — Для всех проектов — ~/.agents/skills/

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add apidojo-io/apidojo-skills --skill scraping-google-search-results -a cursor
```

2. **Вручную: положить файлы**
- Файл: `.cursor/skills/scraping-google-search-results/SKILL.md` — Cursor читает и .agents/skills/, и .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install apidojo-io/apidojo-skills scraping-google-search-results
```

2. **Вручную: положить файлы**
- Файл: `.github/skills/scraping-google-search-results/SKILL.md`

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add apidojo-io/apidojo-skills --skill scraping-google-search-results -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/apidojo-io/apidojo-skills --path skills/primitives/scraping-google-search-results
```

### Windsurf (Devin Desktop)

**Вручную: положить файлы**
- Файл: `.devin/skills/scraping-google-search-results/SKILL.md` — Старый путь .windsurf/skills/ тоже читается

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add apidojo-io/apidojo-skills --skill scraping-google-search-results -a opencode
```

### Claude.ai

**Claude.ai**
- Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/apidojo-io/apidojo-skills/tree/HEAD/skills/primitives/scraping-google-search-results/SKILL.md

## Когда брать
- собрать выдачу Google по списку ключевых слов в одну таблицу
- выгрузить сниппеты и позиции конкурентов для SEO-отчёта
- зафиксировать, какие SERP-блоки занимает запрос: PAA, featured snippet, local pack
- получить URL и описания страниц по теме для дальнейшего разбора
- сравнить выдачу для разных стран через `countryCode`

## Примеры запросов агенту
- собери выдачу Google по запросу «купить кофемашину» и покажи таблицу с позициями
- выгрузи SERP по этим десяти ключам для `GB` в CSV
- какие блоки People Also Ask есть по запросу «best running shoes»?

## Похожие
- [search](https://affpapa.org/nevibecode/skills/brightdata-search.md) — скилл · 7500 установок
- [google-search-agent-teneo](https://affpapa.org/nevibecode/skills/google-search-agent-teneo.md) — скилл · 509 установок
- [google-image-search](https://affpapa.org/nevibecode/skills/google-image-search.md) — скилл · 643 установки
- [google-search-console](https://affpapa.org/nevibecode/skills/google-search-console.md) — скилл · 1900 установок
- [pp-google-search-console](https://affpapa.org/nevibecode/skills/pp-google-search-console.md) — скилл · 511 установок
- [scrapeless-mcp-server](https://affpapa.org/nevibecode/mcp/scrapeless-mcp-server.md) — MCP-сервер · ★ 169

Из того же набора: [apidojo-io/apidojo-skills](https://affpapa.org/nevibecode/by/apidojo-io/apidojo-skills.md) — 22 карточки

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md