SerpApi

View saved version →

---
name: serpapi-setup
description: Guide the user through SerpApi setup or repair when first used, unconfigured, missing a key or request tool, or failing requests. Reuse access or configure direct HTTP, CLI, or cURL for the environment, collect credentials securely, and verify a real search before resuming the task with SerpApi.
license: MIT
---

## Identify and choose

1. Tell the user you will help configure SerpApi and then resume their task. Identify the client, available request tools, and execution host from the session; identify the OS and shell when using commands. Ask only for missing context. Local apps, WSL, containers, and remote hosts can have different credentials and network access.
2. Check for an HTTP tool or runtime that can make authenticated requests, keep credentials private, and inspect HTTP status and response bodies. If shell access is available, also check for `serpapi` and `curl` (`curl.exe` in PowerShell). Check credential presence in the chosen route's [stored source](references/credentials.md). All routes need HTTPS access to `serpapi.com` and an API key; only CLI and cURL require a shell. An unset `SERPAPI_KEY` alone does not prove a key is unavailable. Never print credentials; config presence does not prove connectivity.
3. Reuse working access or honor the user's selected route. Otherwise explain the available choices below, recommend one that fits, and ask their preference. Carry out the chosen setup within existing authorization; do not stop at a menu or tell them to configure it themselves.

| Route | Requirements | Guide |
|---|---|---|
| Direct HTTP | HTTP tool or runtime with secure credential handling and response inspection; no shell required | [HTTP](references/http.md) |
| CLI | Shell, user wants the command interface, HTTPS access to `serpapi.com` | [CLI](references/cli.md) |
| Raw cURL | Existing curl, HTTPS access to `serpapi.com`; no additional packages | [cURL](references/curl.md) |

Read the chosen guide and relevant credential section. For no additional packages, use an existing suitable HTTP tool or cURL; do not install Python, Node.js, jq, or a package manager. Keep working SDK integrations in their runtime when the user explicitly requests them. If no available route can protect the key and inspect the response, explain the missing capability and leave verification pending.

This workflow applies to SerpApi setup and repair. Follow the user's explicit instructions over its defaults. Keep the SerpApi request pending during setup and ask before substituting another provider. For a failed request, diagnose below while retaining the route and original task.

## Configure

For a missing key, share the [dashboard](https://serpapi.com/dashboard) and explain where to enter it. Use the client's secret field, an interactive hidden prompt, or the [Windows password-dialog helper](references/credentials.md#windows-encrypted-storage). Never request the key in chat or put it in commands, history, or workspace files. Launch the actual prompt and confirm completion; an empty terminal window is not a prompt.

For direct HTTP, use the host's credential connection or secret store and let it inject `api_key` into the request's query parameters. Follow the [HTTP guide](references/http.md); do not paste the key into a visible URL or an ordinary browsing/fetch tool's arguments. Without a shell, do not attempt OS-store commands or the desktop helpers.

Preserve existing credentials and their scope. If input, approval, or a restart is required, give the exact next action and wait for it; silence is not completion. Reload the stored key in the same process as each CLI or cURL request; never assume an earlier tool call's export persists. Keep verification pending while blocked; do not replace keys, disable TLS verification, or bypass host policy.

## Verify and resume

Make one small real search with `engine=google_light`, `q=coffee`, or the original task's valid request. It may use one credit. Do no

Preview of the first 4,000 characters. Read full instructions →

Referenced files: 6 — file references are metadata, not package contents.

View saved version →

---
name: serpapi-web-search
description: Search for structured web results, citations, local businesses, flights, hotels, shopping prices, jobs, and other current data through SerpApi's 100+ engines. Use google_light for general web searches. If access or a key is missing, guide the user through serpapi-setup and then complete the search with SerpApi.
license: MIT
---

## Access

Use this workflow for SerpApi tasks and follow the user's explicit instructions over its defaults. Tell the user you are using SerpApi and reuse working direct HTTP, CLI, or cURL access. All routes require HTTPS access to `serpapi.com` and an API key available to the requesting tool or runtime. Only CLI and cURL require a shell. If access is unconfigured or fails, load [serpapi-setup](../serpapi-setup/SKILL.md), discovering it by name if the sibling link is unavailable. Keep the SerpApi request pending during setup; ask before substituting another provider. Fetching documentation or opening result links is still allowed.

For direct HTTP, follow the [HTTP guide](../serpapi-setup/references/http.md): send `GET` requests to `/search.json` for structured JSON or `/search.md` for Markdown, with engine-specific parameters and `api_key` injected from the host's secret source. Use an HTTP tool or runtime that protects credentials; do not put the key in a visible fetch URL. For CLI and cURL, translate the same parameters using the [CLI](../serpapi-setup/references/cli.md) or [cURL](../serpapi-setup/references/curl.md) guide. Keep credentials in the source selected during setup. For command-based requests, load stored credentials in the same process; an export from an earlier tool call or session may be unavailable.

## Engine selection

Prefer `_light` variants when you need a faster, smaller response.

| Intent | Engine | Result key | Key fields |
|---|---|---|---|
| General web (default) | `google_light` | `organic_results` | `.title`, `.link`, `.snippet` |
| Knowledge graph / featured snippets | `google` | `knowledge_graph`, `answer_box` | Top-level sections; fields vary by query. |
| News | `google_news_light` | `news_results` | `.title`, `.link`, `.date` |
| Images | `google_images_light` | `images_results` | `.original`, `.thumbnail` |
| Shopping / prices | `google_shopping_light` | `shopping_results` | `.title`, `.price`, `.source` |
| Academic papers | `google_scholar` | `organic_results` | `.title`, `.inline_links.cited_by.total` |
| Local businesses (list) | `google_maps` | `local_results` | `.title`, `.phone`, `.address`, `.rating`, `.reviews` |
| Local business (single) | `google_maps` | `place_results` | `.title`, `.phone`, `.address`, `.rating`, `.reviews` |
| Place reviews | `google_maps_reviews` | `reviews` | `.rating`, `.snippet`, `.date` |
| Video | `youtube` | `video_results` | `.title`, `.link`, `.views`, `.length` |
| Stock / ticker | `google_finance` | `summary` | `.price`, `.exchange`, `.currency` |
| Flights | `google_flights` | `best_flights`, `other_flights` | `.flights[].airline`, `.price`, `.total_duration` |
| Hotels | `google_hotels` | `properties` | `.name`, `.rate_per_night.extracted_lowest`, `.total_rate.extracted_lowest`, `.overall_rating` |
| Jobs | `google_jobs` | `jobs_results` | `.title`, `.company_name`, `.location` |
| App Store (iOS) | `apple_app_store` | `organic_results` | `.title`, `.rating[0].rating`, `.rating[0].count`, `.developer.name` |
| Alternative web | `bing`, `duckduckgo` | `organic_results` | `.title`, `.link`, `.snippet` |
| SerpApi's own index (preview) | `search_index` | `organic_results` | `.title`, `.link`, `.snippet` |

Fetch [SerpApi's documentation index](https://serpapi.com/llms.txt) to discover supported engines and links to their detailed API pages. Read the selected engine's page to verify the engine name, argument names, required inputs, accepted values, and conditional requirements. Use it to correct invalid or mismatched arguments before retrying a request. The [bundled catalog](references

Preview of the first 4,000 characters. Read full instructions →

Referenced files: 3 — file references are metadata, not package contents.