工具

共有两个工具。助手会根据您的提问选择参数；本页说明可选的参数以及返回的内容。

工具	参数	功能
`search`	`query`（必填）、`rows`、`page`、`snippets`	按常规查询语法搜索网页源代码。`rows` 默认为 20，最多为您套餐的每次查询行数。`snippets: true` 会为每个网站附上匹配处附近最多三段简短的源代码片段（每段约 300 个字符）。
`account`	无	套餐、今日已用和剩余的搜索次数、每次查询行数、速率限制。不消耗任何配额。

两个工具都是只读的。同一个回答中，结果会返回两份：一份是供助手代码使用的结构化数据，另一份是供模型阅读的 JSON 文本。

搜索结果示例

{
  "query": "\"angular.min.js\"",
  "total": 73665,
  "page": 1,
  "rows": 3,
  "returned": 3,
  "truncated": false,
  "index_complete": true,
  "took_ms": 6,
  "results": [
    { "domain": "imgbox.com", "url": "https://imgbox.com/", "rank": 4229 },
    { "domain": "uc.edu", "url": "https://www.uc.edu/", "rank": 5861 },
    { "domain": "sharemods.com", "url": "https://sharemods.com/", "rank": 10962 }
  ]
}

各字段的含义与 API 中相同：

truncated：套餐限制导致本页结果不完整；
index_complete: false：部分索引未能及时响应，因此 total 可能偏低；
rank: null：该网站没有排名；
query_note：当查询的解析方式与书写方式不同时出现。

使用 snippets: true 时，每条结果还带有 snippets，即匹配处附近最多三段源代码字符串组成的列表。这些是他人的代码，仅作为数据传递。

获取多页结果

用 page 和 rows 逐页浏览结果：page: 2, rows: 20 表示第 21 至 40 条结果。page 乘以 rows 不能超过您套餐的每次查询行数，详见限制与错误。

下一篇限制与错误