本文介绍了一款基于 Python 的非官方 Google 搜索 API 工具。该工具无需 API 密钥和外部依赖，支持 Python 2 和 3，可解决官方 API 收费及限制问题。内容包括安装配置、核心特性、技术原理、应用场景（新闻聚合、学术搜索）、性能对比及最佳实践建议。通过模拟浏览器请求解析 HTML 获取搜索结果，需注意控制请求频率以避免 IP 限制。
在应用中集成搜索功能时，官方 API 往往存在收费昂贵或调用限制严格的问题。Python Google Search API 提供了一种无需 API 密钥和外部依赖的解决方案，支持 Python 2 和 3 版本。
pip install gsearch
安装完成后，只需几行代码即可开始搜索：
from gsearch.googlesearch import search
# 基础搜索 - 返回 10 个结果
results = search('人工智能')
# 高级搜索 - 自定义结果数量
results = search('机器学习', num_results=20)
用户查询 → URL 编码 → 模拟浏览器请求 → 解析 HTML 响应 → 提取结果 → 返回结构化数据
# 模拟真实浏览器请求
def download(query, num_results):
user_agent = choice(user_agents) # 随机选择 User-Agent
url = f'http://www.google.com/search?q={quote(query)}'
req = request.Request(url, headers={'User-Agent': user_agent})
response = request.urlopen(req)
return response.read().decode('utf8')
def get_news_updates(keywords, max_results=15):
"""实时获取关键词相关新闻"""
news_results = []
for keyword in keywords:
results = search(f'{keyword} 新闻', num_results=max_results)
news_results.extend([(keyword, title, url) for title, url in results])
return news_results
def search_academic_papers(topic, year=None):
"""搜索学术论文资源"""
query = f'{topic} site:.edu OR site:.ac.uk'
if year:
query += f' after:{year}'
return search(query, num_results=25)
| 特性 | Python Google Search API | 官方 Google API | 其他第三方库 |
|---|---|---|---|
| 费用 | 完全免费 | 按调用次数收费 | 部分收费 |
| 依赖项 | 零依赖 | 需要 API 密钥 | 需要安装额外库 |
| 调用限制 | 无硬性限制 | 严格配额限制 | 各不相同 |
| 多语言支持 | ✅ 完整支持 | ✅ 支持 | ❌ 部分支持 |
| Python 2 兼容 | ✅ 支持 | ❌ 不支持 | ✅ 部分支持 |
# 精确短语搜索
results = search('"Python 数据分析"')
# 排除特定词语
results = search('机器学习 -深度学习')
# 只在特定网站内搜索
results = search('AI site:github.com')
# 多个网站组合搜索
results = search('tutorial site:medium.com OR site:dev.to')
A: 过度使用可能导致 IP 被暂时限制。建议每次搜索间隔 15 秒，避免高频请求。
A: 支持所有 Google 搜索标准运算符：""（精确匹配）、-（排除）、site:、filetype:等。
A: 503 错误通常表示频率限制。建议暂停使用 1 分钟后重试，或减少搜索频率。
A: 当前版本主要针对网页搜索，图片和视频搜索功能有限。
import time
from gsearch.googlesearch import search
def safe_search(query, num_results=10, delay=15):
"""安全的搜索函数，带有延时控制"""
try:
results = search(query, num_results=num_results)
time.sleep(delay) # 添加延时
return results
except Exception as e:
print(f"搜索失败：{e}")
return []
Python Google Search API 为开发者提供了一个强大而灵活的搜索解决方案，特别适合需要集成搜索功能但又不想受限于 API 调用限制的项目。记住适度使用的原则，这个工具将成为你开发工具箱中的得力助手。
微信公众号「极客日志」，在微信中扫描左侧二维码关注。展示文案：极客日志 zeeklog
使用加密算法（如AES、TripleDES、Rabbit或RC4）加密和解密文本明文。 在线工具，加密/解密文本在线工具，online
生成新的随机RSA私钥和公钥pem证书。 在线工具，RSA密钥对生成器在线工具，online
基于 Mermaid.js 实时预览流程图、时序图等图表，支持源码编辑与即时渲染。 在线工具，Mermaid 预览与可视化编辑在线工具，online
解析常见 curl 参数并生成 fetch、axios、PHP curl 或 Python requests 示例代码。 在线工具，curl 转代码在线工具，online
将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具，Base64 字符串编码/解码在线工具，online
将字符串、文件或图像转换为其 Base64 表示形式。 在线工具，Base64 文件转换器在线工具，online