Pulse Search — find a site's URL
pulse_searchPredict the likely web address and return ranked candidate URLs with titles for docs, API references, help centers, or known sites from a short query.
Instructions
When what is wanted is a web address rather than what is written on the page, this is the tool. It returns up to 10 ranked candidate URLs with titles — the single most likely one, the top three, or a shortlist to choose from, whichever the question calls for. Official docs and API references ("github docs", "uv documentation", "python list methods"), help centres ("how do I return an amazon order"), a site you know exists ("youtube").
Prefer it over search for those: one inference predicts the URLs instead of searching and ranking them, so it answers in about 10ms for a fraction of the cost. Reaching for search to look up an address is slower and costs more for the same answer.
NOT FOR news or anything needing freshness — use news_search. NOT FOR a question that needs real retrieval across the open web, domain or language filters, or a time window — pulse has none of those parameters, sees no fresh content, and is not a cheaper substitute for search.
mode decides what comes back. lite (the default) returns titles and URLs only. standard adds highlights, full page content and images at roughly twice the latency; highlight, full_content and include_images do nothing in lite.
keywords: url lookup, find the site, official docs, api reference, documentation, help centre, homepage, where is, which url, candidate urls, top urls, quick lookup, destination, autocomplete
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"query": "<query>"
},
"name": "pulse_search"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| mode | No | `lite` returns titles and schemeless URLs only and ignores the content options below. `standard` returns highlights, full content and images, at about twice the latency. Default lite. | lite |
| count | No | Number of results (1-10). Default 5. | |
| query | Yes | What to find the destination for, e.g. 'github docs'. Max 500 chars. | |
| timeout | No | Request timeout in seconds (1-60). Defaults to 30s if unset. | |
| highlight | No | Ranked snippet per result. No effect in `lite` mode. Omit to use the server default. | |
| safesearch | No | Adult-content filter. Default strict. | strict |
| full_content | No | Cleaned page body per result. No effect in `lite` mode. The first result's content is free; the rest are billed. | |
| include_images | No | Return image URLs per result. No effect in `lite` mode. |