\r \r

Skill: Serpshot Google Search API\r

\r Perform Google web searches and image searches using the Serpshot API.\r \r

When to Use\r

\r

• User says: search / find / google / lookup / research / look up / browse\r
• User says: 查 / 搜 / 找 / 调研 / 查一下 / 搜索 / 查询 / 找一下 / 查资料\r
• Need real-time web information not in training data\r
• Need current news, prices, documentation, or any live data\r
• Need image search results\r \r

Setup (run once)\r

\r

1. Get API key: https://serpshot.com/dashboard\r
2. Set environment variable:\r
   • Mac/Linux: export SERPSHOT_API_KEY=your_key\r
   • Windows CMD: set SERPSHOT_API_KEY=your_key\r
   • Windows PowerShell: $env:SERPSHOT_API_KEY="your_key"\r \r

Tools\r

\r

• exec — Run Python to call Serpshot API\r \r

How to Use\r

\r

Web Search\r

\r

import requests\r
import os\r
\r
api_key = os.environ.get("SERPSHOT_API_KEY")\r
if not api_key:\r
    raise ValueError("SERPSHOT_API_KEY is not set. Get your key at https://serpshot.com/dashboard")\r
\r
response = requests.post(\r
    "https://api.serpshot.com/api/search/google",\r
    headers={"X-API-Key": api_key, "Content-Type": "application/json"},\r
    json={\r
        "queries": ["your search query here"],\r
        "type": "search",\r
        "num": 10,       # results per page (1-100)\r
        "gl": "us",      # country: us/cn/gb/jp/de/ca/fr/...\r
        "hl": "en",      # language: en/zh-Hans/ja/...\r
    }\r
)\r
\r
data = response.json()\r
if data.get("code") != 200:\r
    raise RuntimeError(f"API error {data.get('code')}: {data.get('msg')}")\r
\r
for r in data["data"]["results"]:\r
    print(f"{r['position']}. {r['title']}")\r
    print(f"   {r['link']}")\r
    print(f"   {r['snippet']}")\r
    print()\r
```\r
\r
### Image Search\r
\r
```python\r
import requests\r
import os\r
\r
api_key = os.environ.get("SERPSHOT_API_KEY")\r
\r
response = requests.post(\r
    "https://api.serpshot.com/api/search/google",\r
    headers={"X-API-Key": api_key, "Content-Type": "application/json"},\r
    json={\r
        "queries": ["your image query here"],\r
        "type": "image",\r
        "num": 10,\r
        "gl": "us",\r
    }\r
)\r
\r
data = response.json()\r
if data.get("code") != 200:\r
    raise RuntimeError(f"API error {data.get('code')}: {data.get('msg')}")\r
\r
for r in data["data"]["results"]:\r
    print(f"{r['position']}. {r['title']}")\r
    print(f"   Source: {r.get('source', '')}")\r
    print(f"   Link: {r['link']}")\r
    print(f"   Thumbnail: {r.get('thumbnail', '')}")\r
    print()\r
```\r
\r
## Parameters\r
\r
| Parameter | Default  | Description                                    |\r
|-----------|----------|------------------------------------------------|\r
| queries   | required | Search queries array (max 100)                 |\r
| type      | "search" | "search" or "image"                            |\r
| num       | 10       | Results per page (1-100)                       |\r
| page      | 1        | Page number for pagination                     |\r
| gl        | "us"     | Country code: us/cn/gb/jp/de/ca/fr/id/mx/sg    |\r
| hl        | "en"     | Language: en/zh-Hans/ja/ko/de/fr/...           |\r
\r
## Response Format\r
\r
```json\r
{\r
  "code": 200,\r
  "msg": "Success",\r
  "data": {\r
    "results": [\r
      {\r
        "title": "Result Title",\r
        "link": "https://example.com",\r
        "snippet": "Result description...",\r
        "position": 1\r
      }\r
    ],\r
    "total_results": "About 12,300,000 results",\r
    "search_time": 0.45,\r
    "credits_used": 1\r
  }\r
}\r
```\r
\r
## Example Tasks\r
\r
### Search for latest AI news (English)\r
```\r
queries: ["AI news 2026"]\r
gl: "us"\r
num: 5\r
```\r
\r
### Search Chinese results\r
```\r
queries: ["人工智能 最新消息"]\r
gl: "cn"\r
hl: "zh-Hans"\r
num: 10\r
```\r
\r
### Image search\r
```\r
queries: ["minimalist UI design"]\r
type: "image"\r
num: 10\r
```\r
\r
## Error Codes\r
\r
| Code | Meaning                  | Action                                      |\r
|------|--------------------------|---------------------------------------------|\r
| 400  | Bad request              | Check parameter format                      |\r
| 401  | Invalid API key          | Verify SERPSHOT_API_KEY is set correctly     |\r
| 402  | Insufficient credits     | Top up at https://serpshot.com/dashboard    |\r
| 429  | Rate limit exceeded      | Slow down requests                          |\r
\r
## Notes\r
\r
- Each search query uses 1 credit\r
- Check remaining credits: `GET https://api.serpshot.com/api/credit/available-credits`\r
- Full API docs: https://serpshot.com/docs\r