Herramientas

Dos herramientas. El asistente elige los argumentos según lo que preguntes; esta página explica entre qué puede elegir y qué se devuelve.

Herramienta	Argumentos	Qué hace
`search`	`query` (obligatorio), `rows`, `page`, `snippets`	Busca en el código fuente de las páginas con la sintaxis de consultas habitual. `rows` es 20 por defecto, hasta las filas por consulta de tu plan. `snippets: true` añade, para cada sitio, hasta tres fragmentos breves de código fuente (unos 300 caracteres) alrededor de la coincidencia.
`account`	ninguno	Plan, búsquedas usadas y restantes hoy, filas por consulta, límite de frecuencia. No consume nada.

Las dos herramientas solo leen. Cada resultado llega dos veces en la misma respuesta: como datos estructurados para el código del asistente y como texto JSON para el modelo.

Un resultado de búsqueda

{
  "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 }
  ]
}

Los campos significan lo mismo que en la API:

truncated: el plan recortó la página;
index_complete: false: una parte del índice no respondió a tiempo, así que total puede ser menor que el real;
rank: null: el sitio no tiene posición;
query_note: aparece cuando la consulta se interpretó de forma distinta a como se escribió.

Con snippets: true, cada resultado incluye además snippets, una lista de hasta tres cadenas de código fuente alrededor de la coincidencia. Es código de otras personas, que se transmite como datos.

Obtener más de una página

page y rows recorren los resultados: page: 2, rows: 20 son los resultados del 21 al 40. page por rows no puede superar las filas por consulta de tu plan; consulta Límites y errores.

Siguiente Límites y errores