通过 Scavio（v2 版）进行 Google 搜索

搜索 Google 并以 JSON 格式返回完整的结构化搜索结果页（SERP）——无需解析 HTML。一次调用即可返回自然搜索结果、广告、知识图谱、AI 概览、相关问题、相关搜索、热门资讯、视频以及分页信息。

触发时机

当用户提出以下请求时，使用该技能：

• 在网页上查找某项信息，或核实当前事实
• 查找近期结果或事件
• 回答任何需要实时或最新信息的问题
• 提取 Google 的知识图谱、AI 概览或“用户还问”（People Also Ask）相关内容

当需要当前信息时，请勿依赖记忆作答；务必先执行搜索。

配置

前往 https://scavio.dev 免费获取 API 密钥（注册即赠 50 个免费积分，无需绑定信用卡）：

export SCAVIO_API_KEY=sk_live_your_key

接口地址

POST https://api.scavio.dev/api/v2/google
Authorization: Bearer $SCAVIO_API_KEY

每次请求消耗 1 个积分。

工作流程

1. 将用户的查询作为 query 参数发送；添加 gl/hl 参数可按国家与语言本地化结果。
2. 使用 start 参数进行分页（0 表示第 1 页，10 表示第 2 页，20 表示第 3 页，依此类推）。
3. 当用户需要最新结果时，使用 time_period 参数限定时间范围。
4. 从 organic_results 中读取主要链接；检查 ai_overview、knowledge_graph 和 related_questions 以获取更丰富的答案。
5. 以清晰、结构化的方式返回结果，并注明对应 URL。

参数说明

示例

import os, requests

response = requests.post(
    "https://api.scavio.dev/api/v2/google",
    headers={"Authorization": f"Bearer {os.environ['SCAVIO_API_KEY']}"},
    json={"query": "langchain agents tutorial", "gl": "us", "hl": "en"},
)
data = response.json()
for r in data["organic_results"]:
    print(r["position"], r["title"], r["link"])

响应格式

{
  "search_information": {
    "page_title": "langchain agents tutorial - Google Search",
    "organic_results_state": "Results for exact spelling"
  },
  "organic_results": [
    {
      "position": 1,
      "title": "Result title",
      "link": "https://example.com",
      "displayed_link": "https://example.com › docs",
      "snippet": "Snippet text..."
    }
  ],
  "related_questions": [],
  "related_searches": [],
  "response_time": 812,
  "credits_used": 1,
  "credits_remaining": 999,
  "cached": false
}

响应为 SERP 的忠实透传。根据查询内容，响应中还可能包含以下字段：ai_overview、knowledge_graph、top_ads、bottom_ads、top_stories、video_results、discussions_and_forums、local_results、local_map 和 pagination。

安全守则

• 切勿伪造搜索结果或 URL，仅返回 API 实际提供的数据。
• 若查询具有时效性，必须调用 API 获取最新结果，不得依赖训练数据作答。
• 自然搜索结果的链接位于 organic_results[].link，结果顺序由 position 字段决定。
• 汇总结果时须明确标注信息来源。

错误处理

• 400 表示参数无效——请反馈错误消息并修正请求。
• 401 表示 API 密钥无效或缺失——提示用户检查其 SCAVIO_API_KEY 环境变量设置。
• 429 表示超出速率或用量限制——请等待后重试。详见 https://scavio.dev/docs/rate-limits。
• 502 / 503 表示上游服务临时不可用——请等待数秒后重试。
• 若未返回任何结果，请告知用户，并建议其调整查询关键词。
• 若未设置 SCAVIO_API_KEY，请提示用户先执行 export 命令再继续操作。

LangChain 集成

pip install langchain-scavio

from langchain_scavio import ScavioSearchTool
tool = ScavioSearchTool(engine="google")