Przejdź do treści
Biblioteka skilli
Programowanie · Budowanie i kod

serpapi-core-workflow-a

/serpapi-core-workflow-a

Buduje odtwarzalny przepływ wyszukiwania Google w SerpAPI z walidacją parametrów, opcjonalnych sekcji wyników i ograniczoną paginacją, do monitoringu SEO i zbierania dowodów.

Licencja
MIT
Ostatnia zmiana repozytorium
26.10.2026

Ocena i bezpieczeństwo

100/ 100Klasa: dobry
Format25 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść35 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
1
Skrypty
0
Komentarze HTML
0
Adresy URL w SKILL.md
3
Przestarzałość

Brak sygnałów. Repozytorium zmienione 26.10.2026, bez odwołań do wycofanych modeli i API.

Licencja

MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.

Co robi i kiedy

Buduje odtwarzalny przepływ wyszukiwania Google w SerpAPI z walidacją parametrów, opcjonalnych sekcji wyników i ograniczoną paginacją, do monitoringu SEO i zbierania dowodów.

Wyzwalacze z opisu

build a SerpAPI Google workflow

Argumenty

/serpapi-core-workflow-a [query] [location] [page-budget]
Oryginalny opis (EN)

Build a reproducible Google Search workflow that validates parameters, optional result sections, and bounded pagination. Use when implementing search, SEO monitoring, or evidence collection. Trigger with "build a SerpAPI Google workflow".

Jak działa

  1. Overview
  2. Prerequisites
  3. Tool Discipline
  4. Current Contract
  5. Authentication
  6. Instructions
  7. Output
  8. Error Handling
  9. Example
  10. Resources
Sekcje z nagłówków SKILL.md, w oryginale · 77 linii, 466 słów
Podgląd SKILL.md
---
name: serpapi-core-workflow-a
description: 'Build a reproducible Google Search workflow that validates parameters, optional result sections, and bounded pagination. Use when implementing search, SEO monitoring, or evidence collection. Trigger with "build a SerpAPI Google workflow".'
argument-hint: "[query] [location] [page-budget]"
allowed-tools: Read, Glob, Grep, WebFetch, Write, Edit
version: 1.6.0
author: Jeremy Longshore <jeremy@intentsolutions.io>
license: MIT
tags: [saas, serpapi, google-search, pagination, seo]
model: inherit
effort: high
compatibility: Designed for Claude Code; live searches and multi-page retrieval consume account allowance unless a matching server cache is served
---
# SerpAPI Google Search Workflow

## Overview

Turn a search question into a bounded, reproducible Google Search request and normalize only the result sections the application actually needs.

## Prerequisites

- A business question, permitted query class, geography, language, device, and freshness target
- An authenticated official client behind a server-side gateway
- A search/page budget and fixtures for expected optional sections

## Tool Discipline

Use `Read`, `Glob`, and `Grep` to inspect call sites and result consumers, `WebFetch` to verify current Google parameters and schemas, and `Write` or `Edit` for request builders, normalizers, tests, and redacted receipts.

## Current Contract

Google Search uses `engine=google` and `q`. Locale and device inputs include `location`, `hl`, `gl`, and `device`; pagination commonly uses `start`. JSON sections such as `organic_results`, `answer_box`, `knowledge_graph`, `related_questions`, and local results are query-dependent and optional.

## Authentication

The server-side gateway supplies `SERPAPI_KEY`. Exclude the key and key-bearing URLs from application output, cache keys, logs, telemetry, fixtures, and error reports.

## Instructions

1. Convert the business question into a minimal query and document permitted use, location, language, device, safe-search setting, freshness, and requested fields.
2. Validate parameters against the current Google Search API rather than copying options from another engine.
3. Estimate the maximum searches, check the account budget, and present the live execution boundary.
4. Execute the first page and require a terminal `Success` or `Error` status before parsing sections.
5. Normalize each required section independently and retain provenance fields such as position, source link, and search ID.
6. Follow `serpapi_pagination.next` or a documented `start` offset only while results continue and the page budget remains.
7. Reconcile counts, deduplicate stable links, test empty and missing-section fixtures, and store a redacted receipt.

## Output

Return normalized parameters, result-section schema, requested records with provenance, pages and searches consumed, termination reason, search IDs, and fixture coverage.

## Error Handling

| Condition | Response |
|---|---|
| `Success` without `organic_results` | Inspect documented alternative sections and result-state fields. |
| Location is not resolved as intended | Use a canonical location from the Locations API and record the resolved value. |
| Page has no continuation | Stop successfully; never synthesize the next offset blindly. |
| Schema changes | Quarantine the response, update the narrow adapter and fixture, then replay offline. |

## Example

```python
params = {
    "engine": "google",
    "q": "site:example.com release notes",
    "location": "Austin, Texas, United States",
    "hl": "en",
    "gl": "us",
    "safe": "active",
}
result = client.search(params)
if result["search_metadata"]["status"] != "Success":
    raise RuntimeError(result.get("error", "search did not complete"))
records = [
    {"position": row.get("position"), "title": row.get("title"), "link": row.get("link")}
    for row in result.get("organic_results", [])
]
```

## Resources

- [Google Search API](https://serpapi.com/search-api)
- [Locations API](https://serpapi.com/locations-api)
- [Status and error codes](https://serpapi.com/api-status-and-error-codes)

## Next Steps

Freeze the normalized schema in fixtures and set a page budget appropriate to the product use case.

Wersje

W bazie nie ma innych skilli o nazwie serpapi-core-workflow-a.

Identyczna treść występuje jeszcze w 1 innych folderach na GitHubie. Tu pokazujemy jedną, najlepiej ocenioną kopię.

Migawka bazy z 13.11.2026 · wersja paczki a70915635dce (skrót SHA-256 całej paczki)

Pobrania w ostatnich 30 dniach: 0 · ranking

Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.

Podobne skille

  • 100serpapi-core-workflow-b
    Projektuje przepływ SerpAPI dla wielu wyszukiwarek z jawnymi mapami parametrów, adapterami wyników, budżetami i pochodzeniem danych, przy łączeniu Google, Bing, YouTube, News, Shopping i Maps.
  • 100serpapi-hello-world
    Uruchamia kontrolowane pierwsze wyszukiwanie Google przez oficjalnego klienta SerpAPI i waliduje metadane przed użyciem sekcji wyników, aby potwierdzić nową integrację od początku do końca.
  • 90search
    Pobiera na żywo wyniki z Google, map, wiadomości, zakupów, ofert pracy i ponad stu silników przez SerpApi, z linkami do źródeł.
  • 100serpapi-tool
    Sprawdza na żywo wyniki wyszukiwania dla frazy: lokalny pakiet map, sekcję Ludzie też pytają i AI Overviews.
  • 100perplexity-core-workflow-b
    Wykonuje drugorzędny przepływ pracy z Perplexity (Core Workflow B): dodatkowy przypadek użycia uzupełniający przepływ podstawowy.
  • 100windsurf-core-workflow-a
    Prowadzi podstawowy przepływ pracy Windsurf (Core Workflow A) przy budowie głównych funkcji i podstawowych integracji.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.