serpshot

# Skill: Serpshot Google Search API

Perform Google searches using Serpshot API.

## When to Use

- User asks to "search", "google", "查一下", "调研" something
- Need to get web search results for a topic
- Need image search results

## Tools

- `exec` - Run Python to call Serpshot API

## How to Use

### Basic Search

```python
import requests
import json
import os

# Get API key - YOU MUST ASK USER FOR API KEY
api_key = os.environ.get("SERPSHOT_API_KEY", "YOUR_API_KEY")

url = "https://api.serpshot.com/api/search/google"

headers = {
    "X-API-Key": api_key,
    "Content-Type": "application/json"
}

payload = {
    "queries": ["your search query here"],
    "type": "search",  # or "image"
    "num": 10,  # results per page (1-100)
    "page": 1,
    "location": "US",  # US, CN, JP, GB, DE, etc.
    "lr": "en",  # language restriction
    "gl": "us"  # geolocation
}

response = requests.post(url, headers=headers, json=payload)
data = response.json()

# Parse results
for result in data.get("data", {}).get("results", []):
    print(f"{result['position']}. {result['title']}")
    print(f"   {result['link']}")
    print(f"   {result['snippet']}")
    print()
```

### Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| queries | array[string] | Yes | Search queries (max 100) |
| type | string | No | "search" or "image", default: "search" |
| num | integer | No | Results per page (1-100), default: 10 |
| page | integer | No | Page number, default: 1 |
| location | string | No | Country code (US, CN, JP, GB, DE, etc.), default: US |
| lr | string | No | Language restriction (en, zh-Hans, etc.), default: en |
| gl | string | No | Geolocation (us, cn, etc.), default: us |

### Response Format

```json
{
  "code": 200,
  "msg": "Success",
  "data": {
    "results": [
      {
        "title": "Result Title",
        "link": "https://example.com",
        "snippet": "Result description...",
        "position": 1
      }...