Pangolin SERP & Scrape

新版规范（AI SERP）： https://clawhub.ai/pangolinfo/pangolinfo-ai-serp
亚马逊技能： https://clawhub.ai/pangolinfo/pangolinfo-amazon-scraper

通过Pangolin API以编程方式搜索Google并抓取亚马逊。提取AI概览、自然搜索结果、亚马逊产品数据和页面截图。

前提条件

• - Python 3.6+ （仅使用标准库）
• Pangolin账户 访问 pangolinfo.com
• 环境变量（任选其一）：

快速开始

AI模式搜索（Google AI概览）

bash
python3 scripts/pangolin.py --q 什么是量子计算 --mode ai-mode

带AI概览的标准SERP

bash
python3 scripts/pangolin.py --q Java如何工作 --mode serp --screenshot

多轮对话

bash
python3 scripts/pangolin.py --q Python Web框架 --mode ai-mode \
--follow-up 比较Flask和Django \
--follow-up 哪个更适合初学者

亚马逊产品详情

bash
python3 scripts/pangolin.py --url https://www.amazon.com/dp/B0DYTF8L2W --mode amazon

亚马逊关键词搜索

bash
python3 scripts/pangolin.py --q 无线鼠标 --mode amazon --parser amzKeyword

工作流程

1. 1. 身份验证 -- 从环境变量、缓存（~/.pangolin_token）或全新登录解析令牌
2. 选择API模式 -- ai-mode | serp | amazon
3. 执行 -- 脚本构建请求，使用重试逻辑调用API
4. 解析输出 -- 结构化JSON输出到标准输出

使用方法

AI模式（--mode ai-mode）

使用 parserName: googleAISearch 并设置 udm=50 获取Google AI模式结果。

bash
python3 scripts/pangolin.py --q 解释机器学习 --mode ai-mode

输出包含 ai_overview，其中包含内容段落和来源引用。

AI概览SERP（--mode serp）

使用 parserName: googleSearch 获取标准SERP结果并提取AI概览。

bash
python3 scripts/pangolin.py --q 2025年最佳编程语言 --mode serp

输出同时包含 organicresults 和可选的 aioverview。

多轮追问

向AI模式搜索添加追问问题。建议不超过5个以获得最佳性能（允许更多但速度较慢）：

bash
python3 scripts/pangolin.py --q Kubernetes --mode ai-mode \
--follow-up 如何部署 \
--follow-up 监控工具 \
--follow-up 成本优化

亚马逊（--mode amazon）

使用各种解析器抓取亚马逊产品数据。

通过URL获取产品详情：
bash
python3 scripts/pangolin.py --url https://www.amazon.com/dp/B0DYTF8L2W --mode amazon

关键词搜索：
bash
python3 scripts/pangolin.py --q 机械键盘 --mode amazon --parser amzKeyword

畅销商品：
bash
python3 scripts/pangolin.py --url https://www.amazon.com/gp/bestsellers/electronics \
--mode amazon --parser amzBestSellers

自定义邮编和原始HTML：
bash
python3 scripts/pangolin.py --url https://www.amazon.com/dp/B0DYTF8L2W \
--mode amazon --zipcode 90210 --format rawHtml

可用的亚马逊解析器：

仅身份验证

bash
python3 scripts/pangolin.py --auth-only

原始API响应

bash
python3 scripts/pangolin.py --q 测试 --mode ai-mode --raw

所有CLI选项

--q QUERY 搜索查询
--url URL 目标URL（用于亚马逊产品页面、分类页面等）
--mode MODE ai-mode（默认）| serp | amazon
--screenshot 捕获页面截图（仅Google）
--follow-up TEXT 追问问题（可重复，仅ai-mode）
--num N 结果数量（默认：10，仅Google）
--parser PARSER 亚马逊解析器名称（默认：amzProductDetail）
--zipcode CODE 亚马逊邮编（默认：10041）
--format FMT 亚马逊响应格式：json（默认）| rawHtml | markdown
--auth-only 身份验证并显示令牌信息
--raw 输出原始API响应

选择合适的API

输出格式

Google（ai-mode / serp）

json
{
success: true,
task_id: ...,
results_num: 1,
aioverviewcount: 1,
ai_overview: [{content: [...], references: [{title: ..., url: ..., domain: ...}]}],
organic_results: [{title: ..., url: ..., text: ...}],
screenshot: https://...
}

亚马逊

json
{
success: true,
task_id: ...,
url: https://www.amazon.com/dp/...,
results_count: 1,
product: {asin: ..., title: ..., price: ..., star: ..., rating: ...}
}

完整响应模式请参考相关文件。

退出代码

故障排除

完整错误代码参考请参见 references/error-codes.md。

深度文档