discover
Rank the catalog for a job described in plain words. Free.
node akashi.mjs discover "<what you need>" [--limit N]All words that are not flags form the query, so quotes are optional: discover weather in Lagos and discover "weather in Lagos" are the same.
| Flag | Default | Meaning |
|---|---|---|
--limit N | 5 | How many candidates to return (the API accepts 1 to 25) |
It calls POST /v1/discover with {query, limit} and prints the response.
Example
node akashi.mjs discover "weather in Lagos" --limit 2{
"query": "weather in Lagos",
"count": 2,
"candidates": [
{
"id": "openweather/current",
"provider": "openweather",
"providerName": "OpenWeather",
"slug": "current",
"displayName": "OpenWeather Current Weather",
"summary": "Weather right now for a city or coordinates: temperature, feels-like, humidity, wind, rain, sunrise.",
"categories": ["weather"],
"render": "weather",
"price": { "usd": "0.005", "atomic": "5000", "tier": "standard", "network": "eip155:84532" },
"method": "POST",
"path": "/v1/run/openweather/current",
"available": true,
"score": 1.0,
"health": { "status": "healthy", "runs": 42, "successRate": 1.0, "p50Ms": 410, "p95Ms": 980, "lastOkAt": 1791374400 }
},
{ "id": "akashi/weather", "…": "…" }
],
"hints": [
"POST /v1/inspect with {\"id\": \"openweather/current\"} for its input schema, then POST /v1/run/openweather/current.",
"Related: openweather/forecast"
]
}To filter by category, call the API directly; the CLI sends only query and limit. See Discover for every field.