Pangolinfo AI SERP

1---
2name: pangolinfo-ai-serp
3description: >
4  Programmatic Google SERP + AI Overviews (including AI Mode multi-turn) via
5  Pangolinfo APIs, with optional page screenshots. Use when you need structured
6  results (JSON) for pipelines/agents. Requires PANGOLIN_TOKEN or
7  PANGOLIN_EMAIL + PANGOLIN_PASSWORD.
8homepage: https://www.pangolinfo.com/ai-serp-skill/
9license: MIT
10metadata:
11  openclaw:
12    emoji: "🔎"
13    os: ["darwin", "linux"]
14    requires:
15      env: ["PANGOLIN_TOKEN"]
16      notes: "Auth: set PANGOLIN_TOKEN (recommended) OR set PANGOLIN_EMAIL + PANGOLIN_PASSWORD"
17---
18 
19# Pangolinfo AI SERP (Google SERP + AI Overviews)
20 
21Search Google programmatically via **Pangolinfo** APIs.
22Extract **Google AI Overviews**, run **AI Mode** searches with **multi-turn follow-ups**, and optionally capture **screenshots**.
23 
24## Migration note (Amazon)
25 
26Amazon scraping is now a separate skill: **Pangolinfo Amazon Scraper**.
27 
28If you previously used Amazon features from the combined skill, install the new Amazon skill and switch your `--mode` usage accordingly.
29 
30## Prerequisites
31 
32- **Python 3.6+** (standard library only)
33- A **Pangolinfo account**: https://tool.pangolinfo.com/
34- Auth env vars (choose one):
35  - `PANGOLIN_TOKEN` (recommended)
36  - or `PANGOLIN_EMAIL` + `PANGOLIN_PASSWORD`
37 
38```bash
39export PANGOLIN_TOKEN="..."
40# or
41export PANGOLIN_EMAIL="..."
42export PANGOLIN_PASSWORD="..."
43```
44 
45## Minimal examples
46 
47AI Mode search:
48 
49```bash
50python3 scripts/pangolinfo.py --q "what is quantum computing" --mode ai-mode
51```
52 
53Standard SERP + AI Overview extraction (+ optional screenshot):
54 
55```bash
56python3 scripts/pangolinfo.py --q "openclaw" --mode serp --screenshot
57```
58 
59Multi-turn dialogue (AI Mode follow-ups):
60 
61```bash
62python3 scripts/pangolinfo.py --q "python web frameworks" --mode ai-mode \
63  --follow-up "compare flask vs django" \
64  --follow-up "which is better for beginners"
65```
66 
67## Output
68 
69The script prints structured JSON to stdout.
70 
71Key output fields:
72- `organic_results[]`
73- `ai_overview[]` (only when returned)
74- `screenshot` (only when requested and available)
75- `task_id`, `success`
76 
77## Links
78 
79- Product: https://www.pangolinfo.com/ai-serp-skill/
80- AI Overview SERP API: https://www.pangolinfo.com/ai-overview-serp-api/
81- AI Overview API documentation: https://docs.pangolinfo.com/en-api-reference/aiModeSerpApi/aiModeSerpAPI
82- Source: https://github.com/Pangolin-spg/openclaw-skills/tree/main/pangolinfo-ai-serp
83 
84## Deep-dive references
85 
86- [references/ai-mode-api.md](references/ai-mode-api.md)
87- [references/ai-overview-serp-api.md](references/ai-overview-serp-api.md)
88- [references/error-codes.md](references/error-codes.md)
89