Best spots nearby
spots_find_bestRank up to 10 places within 5-25 km of a centre place for one day, on a given local hour or on each place's best daylight hour, by fish activity score (bite), verdict or water clarity. Use for "where near X is best tomorrow", "best spot at 7 am", "clearest water near Y". For "near me" omit placeId; if that fails, ask the user for a town or beach name. For regions wider than 25 km call it at several named centres. Link every recommended spot using its returned url exactly, query string included. Returned place names can be ambiguous across regions. Exact coordinates are unavailable in these ranked results. GO/marginal/NO are conditions ratings for planning, not safety; say so.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "spots_find_best"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| date | No | Local date at the place: YYYY-MM-DD, or 'today', 'tomorrow' or an English weekday ('saturday' = the next one, today included). Prefer the words over computing dates yourself. | |
| hour | No | Local hour 0-23 to rank on; omit for each place's best daylight hour. | |
| lang | No | The user's language (ISO 639-1; one of Peskio's 15, otherwise 'en'). Picks the peskio.com page language and local place names; answer in the user's language yourself. | en |
| limit | No | ||
| rankBy | No | bite | |
| placeId | No | Centre place from places_search. Omit only for "near me" questions. | |
| audience | No | Who the answer is for. | angler |
| radiusKm | No | ||
| discipline | No | Fishing discipline: shore, boat, rock, kayak or spearfishing. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| date | Yes | ||
| hour | Yes | ||
| note | Yes | ||
| spots | Yes | ||
| centre | Yes | ||
| rankBy | Yes | ||
| schema | Yes | ||
| omitted | Yes | Candidate cells not evaluated, because the response-time budget was spent or a single place could not be evaluated; same-cell neighbours de-duplicated before candidate selection are never counted here. | |
| weekday | Yes | English weekday of `date` (e.g. "Sunday"); use it, never compute weekdays yourself. | |
| radiusKm | Yes | ||
| timezone | Yes | ||
| astroOnly | Yes | True when no ranked spot has a weather forecast. | |
| considered | Yes | ||
| discipline | Yes | ||
| disclaimer | Yes | ||
| attribution | Yes |