SeekSat
Satellite passes, live positions, visibility, cloud forecasts and radio Doppler. Free, no key.
사용해야 할까요
품질 및 안전성
도구 정의와 프로토콜 준수에 대한 자동 분석을 기반으로 합니다.
컨텍스트 비용
이는 서버의 도구가 모델의 컨텍스트에 로드될 때마다 소비되는 대략적인 토큰 수입니다. 수치가 높을수록 다른 작업에 사용할 수 있는 주의가 줄어듭니다.
설치
원클릭 설치
`claude_desktop_config.json` 파일에 다음을 추가하세요:
{
"mcpServers": {
"seeksat": {
"url": "https://seeksat.com/api/mcp"
}
}
}원격 엔드포인트
https://seeksat.com/api/mcpstreamable-http할 수 있는 일
도구 목록
도구 (12)
🟢list_satellites
List SeekSat's ten popular satellites (ISS, Tiangong, Hubble, weather satellites and a few others), in a fixed order, with each one's aliases, page url and orbit data freshness. This is not the full list: every other tool also accepts any NORAD catalog number, e.g. 25544. To find any other satellite by name use search_satellites; for one satellite's facts and TLE use get_satellite. Takes no input and reads only SeekSat's own catalog.
입력 스키마
{
"type": "object",
"properties": {},
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🟢find_passes(satellite, lat, lon, location, windowHours, ...)
Every upcoming pass of one satellite over a location within windowHours, in time order: the full schedule, up to 10 days in one call. It lists passes and does not rank them. Pass tools: find_next_visible_pass, the next pass of one satellite; find_passes, every pass of one satellite in time order; find_best_pass, the best passes ranked by rating, for one satellite or many. To draw a pass give its peak time to get_pass_chart, and to check clouds give it to get_pass_weather. Inputs: the satellite as a NORAD number or a name; the place as lat and lon, or as location (a place name, looked up with OpenStreetMap, or a grid square or written coordinates, read without a lookup). mode "visual" (default) keeps the part of each pass that can be seen by eye and rates it for skyType with the cloud forecast; mode "radio" keeps the whole pass and rates it for listening. Rise and set are where it crosses minElevation, not the horizon, so a higher minElevation gives shorter, fewer passes. In visual mode the cloud forecast is fetched for the place (`weather` says whether one was used). Each pass: rise/peak/set times (UTC, plus riseLocal etc. on the observer's clock), peak elevation, azimuths with compass words (direction), the range at the peak (peakRangeKm), duration, brightness (magnitude, lower is brighter; peakMagnitudeEstimated means no measured magnitude is known for it, so it is a cautious guess; most of the bright satellites have a measured one, and a Starlink still flying in its launch train uses a typical train brightness, a rule of thumb rather than a measurement), and when it can be seen by eye: visibleFrom/visibleUntil (null if never on that pass) plus leavesShadow/entersShadow when it appears or fades mid-sky. passUrl opens that pass on seeksat.com, from that place, to hand to the user. rating is the rating seeksat.com shows for the pass: { word (Poor, Fair, Good, Great, Excellent), bars (1-5), level (low, ok, good), reason }. In visual mode it is how much brighter than the faintest visible star the pass gets for skyType (headroomMag), stepped down for a cloudy forecast up to 4 days ahead, and no higher than Fair when the brightness is estimated; in radio mode it is the peak height, a bar lower for each 6 dB of extra path loss when the satellite is more than 2,000 km away at the peak (8,000 km costs two bars), and no higher than Fair when SatNOGS stations tried at least 3 times in 30 days and heard nothing (the result then carries the satellite's reception and receptionSource). captureProbability (0-1) is the chance a camera captures the pass: sky darkness, height, clear-sky odds and length, with brightness playing no part; quality is its deprecated old name, the same number except capped at 0.4 when peakMagnitudeEstimated is true, so use captureProbability. In visual mode rise and set are the part of the pass that can be seen, so they can start or end mid-sky, and peak, peakElevationDeg and direction.peak are the highest point of that part (the whole pass may climb higher). An empty list comes with a note saying why (it never rises high enough from that latitude, the sky never gets dark, and so on).
입력 스키마
{
"type": "object",
"properties": {
"satellite": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"maxLength": 64
},
{
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
}
],
"description": "NORAD catalog number (as a number or a string) or a name, e.g. 25544, \"25544\" or \"iss\"."
},
"lat": {
"description": "observer latitude in decimal degrees, north positive (-90 to 90). Give it with lon, or give location instead.",
"type": "number",
"minimum": -90,
"maximum": 90
},
"lon": {
"description": "observer longitude in decimal degrees, east positive and west negative (-180 to 180).",
"type": "number",
"minimum": -180,
"maximum": 180
},
"location": {
"description": "where the observer is, when lat and lon are not given (they win when both are): a Maidenhead grid square (EN52, EN52ve, EN52ve12), coordinates in any common form (\"41.88, -87.63\", \"41.88N 87.63W\", \"41°52'48\"N 87°37'48\"W\", a Google Maps link or geo: URI), all read locally, or a place name (city, address, landmark) looked up with OpenStreetMap. Prefer lat and lon, or a grid square, when you have them: a place name is a network lookup.",
"type": "string",
"maxLength": 200
},
"windowHours": {
"description": "how far ahead to look, in hours, up to 240 (10 days). Default 48.",
"type": "number",
"exclusiveMinimum": 0,
"maximum": 240
},
"minElevation": {
"description": "lowest elevation that counts: a pass must climb above it, and rise and set are when it crosses it, in degrees above the horizon (0 to 90). Default 10.",
"type": "number",
"minimum": 0,
"maximum": 90
},
"mode": {
"description": "\"visual\" (default): naked-eye passes, sunlit while the sky is dark; \"radio\": every line-of-sight pass, day or night.",
"type": "string",
"enum": [
"visual",
"radio"
]
},
"skyType": {
"description": "how dark the observer's sky is, for the visual rating as on seeksat.com: \"city\" (stars to magnitude 3.5), \"suburban\" (stars to magnitude 4.5), \"rural\" (stars to magnitude 5.5), \"dark\" (stars to magnitude 6.5). Default \"suburban\".",
"type": "string",
"enum": [
"city",
"suburban",
"rural",
"dark"
]
},
"minElevationDeg": {
"description": "old name for minElevation; still accepted.",
"type": "number",
"minimum": 0,
"maximum": 90
},
"minElev": {
"description": "old name for minElevation; still accepted.",
"type": "number",
"minimum": 0,
"maximum": 90
}
},
"required": [
"satellite"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🟢get_position(satellite, time, durationMinutes, stepSeconds, lat, ...)
Where a satellite is now, or at a given time: the point on Earth straight below it (latDeg, lonDeg, not where it is in your sky), its altitude, and whether it is sunlit, with url (its page on seeksat.com). Give durationMinutes to also get its ground track from that time on: track, the point below it every stepSeconds (up to a day, at most 720 points), each with time, latDeg, lonDeg, altitudeKm and sunlit, and trackStepSeconds, the step used. lonDeg jumps between 180 and -180 where the track crosses the antimeridian, so split a drawn line there. A location is optional: it only sets the time zone for local times and for reading a time with no offset (UTC without one). A time more than 30 days from the orbital elements' epoch is refused. For where it is in your sky (azimuth and elevation) use find_satellites_up_now; for when it passes over use find_passes or find_next_visible_pass; for its orbit and TLE use get_satellite.
입력 스키마
{
"type": "object",
"properties": {
"satellite": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"maxLength": 64
},
{
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
}
],
"description": "NORAD catalog number (as a number or a string) or a name, e.g. 25544, \"25544\" or \"iss\"."
},
"time": {
"description": "when (with durationMinutes, where the track starts). Default: now. ISO 8601 with Z or an offset, e.g. \"2026-11-14T21:00:00-06:00\"; a time with no offset, e.g. \"2026-11-14T21:00\", is read in the observer's time zone, and the result echoes how it was read (interpretedAs). A local time the clocks skip at a daylight-saving change is moved forward, with a note.",
"type": "string",
"maxLength": 64
},
"durationMinutes": {
"description": "how long a ground track to return, in minutes from time, up to 1440 (a day); about 93 is one ISS orbit. Omit for one position.",
"type": "number",
"exclusiveMinimum": 0,
"maximum": 1440
},
"stepSeconds": {
"description": "seconds between track points, 10 to 3600. Default 60, or wider when needed to keep the track to 720 points; a step you give that would make more is refused, naming the smallest that fits.",
"type": "integer",
"minimum": 10,
"maximum": 3600
},
"lat": {
"description": "observer latitude in decimal degrees, north positive (-90 to 90). Give it with lon, or give location instead.",
"type": "number",
"minimum": -90,
"maximum": 90
},
"lon": {
"description": "observer longitude in decimal degrees, east positive and west negative (-180 to 180).",
"type": "number",
"minimum": -180,
"maximum": 180
},
"location": {
"description": "where the observer is, when lat and lon are not given (they win when both are): a Maidenhead grid square (EN52, EN52ve, EN52ve12), coordinates in any common form (\"41.88, -87.63\", \"41.88N 87.63W\", \"41°52'48\"N 87°37'48\"W\", a Google Maps link or geo: URI), all read locally, or a place name (city, address, landmark) looked up with OpenStreetMap. Prefer lat and lon, or a grid square, when you have them: a place name is a network lookup. Optional here.",
"type": "string",
"maxLength": 200
},
"passTime": {
"description": "old name for time; still accepted.",
"type": "string",
"maxLength": 64
}
},
"required": [
"satellite"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🟢find_next_visible_pass(satellite, lat, lon, location, mode, ...)
Convenience shortcut: the next pass of one satellite from a location, within windowHours. Use this only when the user wants "the next pass". It returns that one pass in the same shape as find_passes (rise, peak and set times, direction, brightness, rating and passUrl). chart:true also renders that pass's sky chart (the same image get_pass_chart gives) in this same call, so one call answers when and where to look. The place, mode and minElevation work as in find_passes: visual keeps the part of the pass that can be seen by eye, radio the whole pass above minElevation. Pass tools: find_next_visible_pass, the next pass of one satellite; find_passes, every pass of one satellite in time order; find_best_pass, the best passes ranked by rating, for one satellite or many. When there is no pass, a note says why.
입력 스키마
{
"type": "object",
"properties": {
"satellite": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"maxLength": 64
},
{
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
}
],
"description": "NORAD catalog number (as a number or a string) or a name, e.g. 25544, \"25544\" or \"iss\"."
},
"lat": {
"description": "observer latitude in decimal degrees, north positive (-90 to 90). Give it with lon, or give location instead.",
"type": "number",
"minimum": -90,
"maximum": 90
},
"lon": {
"description": "observer longitude in decimal degrees, east positive and west negative (-180 to 180).",
"type": "number",
"minimum": -180,
"maximum": 180
},
"location": {
"description": "where the observer is, when lat and lon are not given (they win when both are): a Maidenhead grid square (EN52, EN52ve, EN52ve12), coordinates in any common form (\"41.88, -87.63\", \"41.88N 87.63W\", \"41°52'48\"N 87°37'48\"W\", a Google Maps link or geo: URI), all read locally, or a place name (city, address, landmark) looked up with OpenStreetMap. Prefer lat and lon, or a grid square, when you have them: a place name is a network lookup.",
"type": "string",
"maxLength": 200
},
"mode": {
"description": "\"visual\" (default): naked-eye passes, sunlit while the sky is dark; \"radio\": every line-of-sight pass, day or night.",
"type": "string",
"enum": [
"visual",
"radio"
]
},
"windowHours": {
"description": "how far ahead to look, in hours, up to 240 (10 days). Default 72.",
"type": "number",
"exclusiveMinimum": 0,
"maximum": 240
},
"minElevation": {
"description": "lowest elevation that counts: a pass must climb above it, and rise and set are when it crosses it, in degrees above the horizon (0 to 90). Default 10.",
"type": "number",
"minimum": 0,
"maximum": 90
},
"skyType": {
"description": "how dark the observer's sky is, for the visual rating as on seeksat.com: \"city\" (stars to magnitude 3.5), \"suburban\" (stars to magnitude 4.5), \"rural\" (stars to magnitude 5.5), \"dark\" (stars to magnitude 6.5). Default \"suburban\".",
"type": "string",
"enum": [
"city",
"suburban",
"rural",
"dark"
]
},
"chart": {
"description": "true to also render that pass's polar sky chart (PNG) and return it in this same result. Default false.",
"type": "boolean"
},
"minElevationDeg": {
"description": "old name for minElevation; still accepted.",
"type": "number",
"minimum": 0,
"maximum": 90
},
"minElev": {
"description": "old name for minElevation; still accepted.",
"type": "number",
"minimum": 0,
"maximum": 90
}
},
"required": [
"satellite"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🟢get_pass_weather(lat, lon, location, time)
Cloud-cover forecast (Open-Meteo and MET Norway) and the chance of a clear view for a location at one time, such as a pass's peak. The forecast reaches about 7 to 16 days ahead. viewingProbability is the clear-sky chance (0-1), blended toward 0.5 the further ahead the time is, since forecasts lose skill. Returns available, cloudCoverPct (at that hour), viewingProbability, forecastSource, forecastFrom and forecastUntil (the span the forecast covers), and time with interpretedAs. It knows nothing about satellites: give the same place a pass was found for and that pass's peak time, since the peak is when clouds matter. Use it on a pass's peak time from find_passes or find_best_pass; in visual mode those already fold the forecast into their ratings, so call this to show the cloud numbers or check another time. When there is no forecast for that time (in the past, beyond the forecast, a time it cannot read, or the forecast could not be fetched) the result is available:false with a reason, never a stand-in number.
입력 스키마
{
"type": "object",
"properties": {
"lat": {
"description": "observer latitude in decimal degrees, north positive (-90 to 90). Give it with lon, or give location instead.",
"type": "number",
"minimum": -90,
"maximum": 90
},
"lon": {
"description": "observer longitude in decimal degrees, east positive and west negative (-180 to 180).",
"type": "number",
"minimum": -180,
"maximum": 180
},
"location": {
"description": "where the observer is, when lat and lon are not given (they win when both are): a Maidenhead grid square (EN52, EN52ve, EN52ve12), coordinates in any common form (\"41.88, -87.63\", \"41.88N 87.63W\", \"41°52'48\"N 87°37'48\"W\", a Google Maps link or geo: URI), all read locally, or a place name (city, address, landmark) looked up with OpenStreetMap. Prefer lat and lon, or a grid square, when you have them: a place name is a network lookup.",
"type": "string",
"maxLength": 200
},
"time": {
"type": "string",
"maxLength": 64,
"description": "the time to check, e.g. a pass's peak. ISO 8601 with Z or an offset, e.g. \"2026-11-14T21:00:00-06:00\"; a time with no offset, e.g. \"2026-11-14T21:00\", is read in the observer's time zone, and the result echoes how it was read (interpretedAs). A local time the clocks skip at a daylight-saving change is moved forward, with a note."
}
},
"required": [
"time"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🟢get_pass_chart(satellite, lat, lon, location, time, ...)
Render a polar sky chart (PNG) of a satellite's pass over a location: where to look, with the moon, planets and stars in their real positions. Returns JSON (the charted pass as a full pass row, the same as find_passes gives, and a one-line summary) and the image. A geostationary satellite has no passes: the result gives `stationary` (where to point) instead. By default it charts the next pass; give `time` (the rise or peak of a pass from find_passes or find_best_pass) to chart that pass instead. Use the same minElevation as the pass came from. A place name in location is looked up with OpenStreetMap first, so lat and lon are faster. A time more than 30 days from the orbital elements' epoch is refused.
입력 스키마
{
"type": "object",
"properties": {
"satellite": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"maxLength": 64
},
{
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
}
],
"description": "NORAD catalog number (as a number or a string) or a name, e.g. 25544, \"25544\" or \"iss\"."
},
"lat": {
"description": "observer latitude in decimal degrees, north positive (-90 to 90). Give it with lon, or give location instead.",
"type": "number",
"minimum": -90,
"maximum": 90
},
"lon": {
"description": "observer longitude in decimal degrees, east positive and west negative (-180 to 180).",
"type": "number",
"minimum": -180,
"maximum": 180
},
"location": {
"description": "where the observer is, when lat and lon are not given (they win when both are): a Maidenhead grid square (EN52, EN52ve, EN52ve12), coordinates in any common form (\"41.88, -87.63\", \"41.88N 87.63W\", \"41°52'48\"N 87°37'48\"W\", a Google Maps link or geo: URI), all read locally, or a place name (city, address, landmark) looked up with OpenStreetMap. Prefer lat and lon, or a grid square, when you have them: a place name is a network lookup.",
"type": "string",
"maxLength": 200
},
"time": {
"description": "charts the pass around this time (a pass's rise or peak from find_passes or find_best_pass). Default: the next pass from now. ISO 8601 with Z or an offset, e.g. \"2026-11-14T21:00:00-06:00\"; a time with no offset, e.g. \"2026-11-14T21:00\", is read in the observer's time zone, and the result echoes how it was read (interpretedAs). A local time the clocks skip at a daylight-saving change is moved forward, with a note.",
"type": "string",
"maxLength": 64
},
"mode": {
"description": "\"visual\" (default): naked-eye passes, sunlit while the sky is dark; \"radio\": every line-of-sight pass, day or night.",
"type": "string",
"enum": [
"visual",
"radio"
]
},
"minElevation": {
"description": "lowest elevation that counts: a pass must climb above it, and rise and set are when it crosses it, in degrees above the horizon (0 to 90). Default 10.",
"type": "number",
"minimum": 0,
"maximum": 90
},
"skyType": {
"description": "how dark the observer's sky is, for the visual rating as on seeksat.com: \"city\" (stars to magnitude 3.5), \"suburban\" (stars to magnitude 4.5), \"rural\" (stars to magnitude 5.5), \"dark\" (stars to magnitude 6.5). Default \"suburban\".",
"type": "string",
"enum": [
"city",
"suburban",
"rural",
"dark"
]
},
"windowHours": {
"description": "how far ahead to look, in hours, up to 240 (10 days). Default 72. Only used to find the next pass when no time is given.",
"type": "number",
"exclusiveMinimum": 0,
"maximum": 240
},
"minElevationDeg": {
"description": "old name for minElevation; still accepted.",
"type": "number",
"minimum": 0,
"maximum": 90
},
"minElev": {
"description": "old name for minElevation; still accepted.",
"type": "number",
"minimum": 0,
"maximum": 90
},
"passTime": {
"description": "old name for time; still accepted.",
"type": "string",
"maxLength": 64
}
},
"required": [
"satellite"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🟢get_satellite(satellite)
Facts about one satellite, for "what is this satellite?" or to get its TLE. Returns a plain-words summary, object type (payload, rocket body, debris), owner, launch date and site, re-entry date if it has come down, orbit (class, period, inclination, perigee and apogee heights in km, eccentricity), size in meters when known, its radio downlinks, and its current orbital elements as TLE lines (as OMM for catalog numbers above 99999), with their epoch and age. It takes no location and no time: for where it is use get_position, for when to see it use find_passes or find_best_pass, and for a pass's Doppler and reception use get_radio_pass. Owner, launch and type come from CelesTrak's satellite catalog and are null when it does not say; the orbit is null once it has re-entered. An unknown satellite is an error that suggests search_satellites (outside the popular list a name resolves only on an exact whole-name match). Most satellites come from SeekSat's own copy of CelesTrak's catalog, refreshed every four hours; one missing from it is looked up at CelesTrak, which can take a few seconds and is limited per hour, so prefer NORAD numbers from search_satellites.
입력 스키마
{
"type": "object",
"properties": {
"satellite": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"maxLength": 64
},
{
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
}
],
"description": "NORAD catalog number (as a number or a string) or a name, e.g. 25544, \"25544\" or \"iss\"."
}
},
"required": [
"satellite"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🟢search_satellites(query, limit, mode)
Search the full satellite catalog (about 17,000 objects) by name, alias or NORAD number, best match first: an exact NORAD number, then the whole name, the start of the name or of each word, part of the number, anywhere in the name, and last near misses (so a small typo still finds it). Use it to turn a name like "SDO" or "NOAA 19" into a NORAD number for the other tools; names outside the popular list only resolve directly on an exact whole-name match. To find satellites by downlink kind, search with mode "radio" and the kind as the query (query "sstv"). Each result has noradId, name, url, hasKnownDownlinks and bands (the radio bands of its downlinks); no match is an empty list. For the popular satellites use list_satellites; for one satellite's facts and TLE use get_satellite.
입력 스키마
{
"type": "object",
"properties": {
"query": {
"type": "string",
"minLength": 1,
"maxLength": 64,
"description": "a name, part of one, or a NORAD number, e.g. \"sdo\", \"noaa 19\", \"25544\". With mode \"radio\", a downlink kind as the whole query (e.g. \"sstv\", \"aprs\", \"cw\") lists satellites that have one."
},
"limit": {
"description": "how many results to return, 1 to 20. Default 10.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 20
},
"mode": {
"description": "\"visual\" (default): best name match first; \"radio\": satellites with known radio downlinks first among equally good matches. To list satellites with a kind of downlink, set mode \"radio\" and put the kind in query (e.g. query \"sstv\"); mode itself takes only \"visual\" or \"radio\".",
"type": "string",
"enum": [
"visual",
"radio"
]
}
},
"required": [
"query"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🟢get_radio_pass(satellite, lat, lon, location, frequencyMHz, ...)
Radio details for one pass of a satellite over a location: its known downlink (and uplink) frequencies, the Doppler swing, when to tune to what frequency (at 10 and 30 degrees up and closest approach), and a table (at most 40 evenly spaced rows) of time, azimuth, elevation, range and receive frequency for pointing an antenna and tuning a radio. Uses the next pass above minElevation, or the one peaking nearest `time` (past or future, within 30 days of the orbital elements' epoch). A satellite that never sets here (geosynchronous) gets the next 24 hours instead. Give frequencyMHz to use a frequency other than the default downlink; the default is the most recently heard downlink when SatNOGS heard one, else the catalog's. Downlinks carry reception from SatNOGS Network observations when known: { state (heard, silent: stations tried and heard nothing, or unknown: no observations, never a sign it is dead), heardLast48h, heardLast7d, heardLast30d, failedLast30d, lastHeard }, listed most recently heard first; receptionSource names the source (CC BY-SA 4.0). Predictions from published elements: the transmitter's own frequency offset is unknown, so the curve's shape is what to compare. passUrl opens this pass on seeksat.com on the same frequency, to hand to the user; its Radio chart downloads the full table as CSV. When there is no pass (it never rises above minElevation here, or none within windowHours), window is null and message says why; the downlinks are still listed. To choose a satellite or pass first use find_best_pass with mode radio, or find_passes; for a sky chart of the pass use get_pass_chart.
입력 스키마
{
"type": "object",
"properties": {
"satellite": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"maxLength": 64
},
{
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
}
],
"description": "NORAD catalog number (as a number or a string) or a name, e.g. 25544, \"25544\" or \"iss\". e.g. \"so-50\" or 27607."
},
"lat": {
"description": "observer latitude in decimal degrees, north positive (-90 to 90). Give it with lon, or give location instead.",
"type": "number",
"minimum": -90,
"maximum": 90
},
"lon": {
"description": "observer longitude in decimal degrees, east positive and west negative (-180 to 180).",
"type": "number",
"minimum": -180,
"maximum": 180
},
"location": {
"description": "where the observer is, when lat and lon are not given (they win when both are): a Maidenhead grid square (EN52, EN52ve, EN52ve12), coordinates in any common form (\"41.88, -87.63\", \"41.88N 87.63W\", \"41°52'48\"N 87°37'48\"W\", a Google Maps link or geo: URI), all read locally, or a place name (city, address, landmark) looked up with OpenStreetMap. Prefer lat and lon, or a grid square, when you have them: a place name is a network lookup.",
"type": "string",
"maxLength": 200
},
"frequencyMHz": {
"description": "the downlink to compute Doppler for, in MHz. Default: the satellite's default known downlink.",
"type": "number",
"exclusiveMinimum": 0,
"maximum": 300000
},
"time": {
"description": "a time near the wanted pass's peak (e.g. from find_passes), past or future. Default: the next pass. ISO 8601 with Z or an offset, e.g. \"2026-11-14T21:00:00-06:00\"; a time with no offset, e.g. \"2026-11-14T21:00\", is read in the observer's time zone, and the result echoes how it was read (interpretedAs). A local time the clocks skip at a daylight-saving change is moved forward, with a note.",
"type": "string",
"maxLength": 64
},
"minElevation": {
"description": "lowest elevation that counts: a pass must climb above it, and rise and set are when it crosses it, in degrees above the horizon (0 to 90). Default 10.",
"type": "number",
"minimum": 0,
"maximum": 90
},
"windowHours": {
"description": "how far ahead to look, in hours, up to 240 (10 days). Default 48. How far past the start to look for a pass.",
"type": "number",
"exclusiveMinimum": 0,
"maximum": 240
},
"minElevationDeg": {
"description": "old name for minElevation; still accepted.",
"type": "number",
"minimum": 0,
"maximum": 90
},
"minElev": {
"description": "old name for minElevation; still accepted.",
"type": "number",
"minimum": 0,
"maximum": 90
},
"passTime": {
"description": "old name for time; still accepted.",
"type": "string",
"maxLength": 64
}
},
"required": [
"satellite"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🟢find_best_pass(satellite, lat, lon, location, windowHours, ...)
The best upcoming passes over a location, ranked by the rating seeksat.com shows ("what's the best pass tonight?"). Returns `best` (the top pass) and `passes` (the top-ranked options, each tagged with its satellite). Pass tools: find_next_visible_pass, the next pass of one satellite; find_passes, every pass of one satellite in time order; find_best_pass, the best passes ranked by rating, for one satellite or many. For what is up at this moment use find_satellites_up_now; to draw the winning pass set chart:true here, or give a pass's peak time to get_pass_chart. Give `satellite` to rank that one satellite's passes and get only the top `limit` (default 3), not every pass. Omit it to scan: in visual mode (default) the popular satellites plus every satellite in CelesTrak's visual group (the brightest objects in the sky, about 160, many of them spent rocket bodies), over 72 hours by default (168 at most); in radio mode every satellite with known downlinks (about a thousand), optionally only those with a downlink in `bands` or of a kind in `modes`, over 24 hours by default (72 at most). A scan reports satellitesScanned, leaves out satellites whose orbital elements are more than 14 days old at the start (skippedStaleElements) and any pass more than 14 days from its satellite's elements, counts what else it skipped, and radio passes list the satellite's downlinks. Inputs: the satellite as a NORAD number or a name; the place as lat and lon, or as location (a place name, looked up with OpenStreetMap, or a grid square or written coordinates, read without a lookup). mode "visual" (default) keeps the part of each pass that can be seen by eye and rates it for skyType with the cloud forecast; mode "radio" keeps the whole pass and rates it for listening. Rise and set are where it crosses minElevation, not the horizon, so a higher minElevation gives shorter, fewer passes. Each pass: rise/peak/set times (UTC, plus riseLocal etc. on the observer's clock), peak elevation, azimuths with compass words (direction), the range at the peak (peakRangeKm), duration, brightness (magnitude, lower is brighter; peakMagnitudeEstimated means no measured magnitude is known for it, so it is a cautious guess; most of the bright satellites have a measured one, and a Starlink still flying in its launch train uses a typical train brightness, a rule of thumb rather than a measurement), and when it can be seen by eye: visibleFrom/visibleUntil (null if never on that pass) plus leavesShadow/entersShadow when it appears or fades mid-sky. passUrl opens that pass on seeksat.com, from that place, to hand to the user. rating is the rating seeksat.com shows for the pass: { word (Poor, Fair, Good, Great, Excellent), bars (1-5), level (low, ok, good), reason }. In visual mode it is how much brighter than the faintest visible star the pass gets for skyType (headroomMag), stepped down for a cloudy forecast up to 4 days ahead, and no higher than Fair when the brightness is estimated; in radio mode it is the peak height, a bar lower for each 6 dB of extra path loss when the satellite is more than 2,000 km away at the peak (8,000 km costs two bars), and no higher than Fair when SatNOGS stations tried at least 3 times in 30 days and heard nothing (the result then carries the satellite's reception and receptionSource). captureProbability (0-1) is the chance a camera captures the pass: sky darkness, height, clear-sky odds and length, with brightness playing no part; quality is its deprecated old name, the same number except capped at 0.4 when peakMagnitudeEstimated is true, so use captureProbability. In visual mode rise and set are the part of the pass that can be seen, so they can start or end mid-sky, and peak, peakElevationDeg and direction.peak are the highest point of that part (the whole pass may climb higher). Ranking: visual passes rank by rating bars, then a known brightness before an estimated one, then headroomMag, then captureProbability; the cloud forecast for the location is folded in where it reaches (cloudCoverPct at the peak; `weather` says whether a forecast was used). Radio scans rank satellites with a downlink a hobby receiver can tune (30 MHz to 1 GHz) ahead of the rest unless `bands` is given, then by rating bars, then how recently SatNOGS stations heard the satellite (last 48 hours, 7 days, 30 days, unknown, probably silent), then how often they heard it in that span (20 or more times, 5 to 19, 2 to 4, once), then peak elevation, then captureProbability. A probably silent satellite (SatNOGS stations tried at least 3 times in 30 days and heard nothing) rates no higher than Fair; unknown is never held down. Radio rows carry the satellite's reception (its best downlink's). Downlinks carry reception from SatNOGS Network observations when known: { state (heard, silent: stations tried and heard nothing, or unknown: no observations, never a sign it is dead), heardLast48h, heardLast7d, heardLast30d, failedLast30d, lastHeard }, listed most recently heard first; receptionSource names the source (CC BY-SA 4.0). An empty result comes with a note saying why. chart:true also renders the winning pass's sky chart in this same call.
입력 스키마
{
"type": "object",
"properties": {
"satellite": {
"description": "NORAD catalog number (as a number or a string) or a name, e.g. 25544, \"25544\" or \"iss\". Omit to scan: visual mode scans the popular satellites plus CelesTrak's visual group, radio mode every satellite with known downlinks.",
"anyOf": [
{
"type": "string",
"minLength": 1,
"maxLength": 64
},
{
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
}
]
},
"lat": {
"description": "observer latitude in decimal degrees, north positive (-90 to 90). Give it with lon, or give location instead.",
"type": "number",
"minimum": -90,
"maximum": 90
},
"lon": {
"description": "observer longitude in decimal degrees, east positive and west negative (-180 to 180).",
"type": "number",
"minimum": -180,
"maximum": 180
},
"location": {
"description": "where the observer is, when lat and lon are not given (they win when both are): a Maidenhead grid square (EN52, EN52ve, EN52ve12), coordinates in any common form (\"41.88, -87.63\", \"41.88N 87.63W\", \"41°52'48\"N 87°37'48\"W\", a Google Maps link or geo: URI), all read locally, or a place name (city, address, landmark) looked up with OpenStreetMap. Prefer lat and lon, or a grid square, when you have them: a place name is a network lookup.",
"type": "string",
"maxLength": 200
},
"windowHours": {
"description": "how far ahead to look, in hours, up to 240 (10 days). Default 72. With no satellite named, a visual scan stops at 168, and a radio scan defaults to 24 and stops at 72.",
"type": "number",
"exclusiveMinimum": 0,
"maximum": 240
},
"minElevation": {
"description": "lowest elevation that counts: a pass must climb above it, and rise and set are when it crosses it, in degrees above the horizon (0 to 90). Default 10.",
"type": "number",
"minimum": 0,
"maximum": 90
},
"limit": {
"description": "how many ranked passes to return, 1 to 20. Default 3.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 20
},
"mode": {
"description": "\"visual\" (default): naked-eye passes, sunlit while the sky is dark; \"radio\": every line-of-sight pass, day or night.",
"type": "string",
"enum": [
"visual",
"radio"
]
},
"skyType": {
"description": "how dark the observer's sky is, for the visual rating as on seeksat.com: \"city\" (stars to magnitude 3.5), \"suburban\" (stars to magnitude 4.5), \"rural\" (stars to magnitude 5.5), \"dark\" (stars to magnitude 6.5). Default \"suburban\".",
"type": "string",
"enum": [
"city",
"suburban",
"rural",
"dark"
]
},
"bands": {
"description": "radio scan only: keep satellites with a downlink in these bands: hf (3-30 MHz), wx (137 MHz weather), 2m (144-148 MHz), 70cm (420-450 MHz), l (1-2 GHz), s (2-4 GHz), other. Default: any band.",
"type": "array",
"items": {
"type": "string",
"enum": [
"hf",
"wx",
"2m",
"70cm",
"l",
"s",
"other"
]
}
},
"modes": {
"description": "radio scan only: keep satellites with a downlink of one of these kinds, matched on its mode or label, e.g. [\"fm\", \"apt\", \"sstv\"]. Default: any.",
"type": "array",
"items": {
"type": "string",
"enum": [
"fm",
"ssb",
"usb",
"lsb",
"cw",
"sstv",
"aprs",
"afsk",
"bpsk",
"gmsk",
"fsk",
"lrpt",
"apt",
"repeater",
"transponder",
"beacon",
"digipeater",
"voice",
"telemetry"
]
}
},
"chart": {
"description": "true to also render the winning pass's polar sky chart (PNG) and return it in this same result. Default false.",
"type": "boolean"
},
"minElevationDeg": {
"description": "old name for minElevation; still accepted.",
"type": "number",
"minimum": 0,
"maximum": 90
},
"minElev": {
"description": "old name for minElevation; still accepted.",
"type": "number",
"minimum": 0,
"maximum": 90
}
},
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🟢find_satellites_up_now(lat, lon, location, mode, minElevation, ...)
What is in the sky over a location right now, from every satellite in the catalog (about 17,000, active satellites plus CelesTrak's visual group; most debris is not in it). mode "visual" (default) lists sunlit satellites above minElevation while the sky is dark there (Sun more than about 6 degrees down), brightest first; magnitudes are measured for most of the bright satellites (McCants' observations) and estimated for the rest (magnitudeEstimated). mode "radio" lists satellites with known downlinks above minElevation, those with a downlink a hobby receiver can tune (30 MHz to 1 GHz) first, then the more recently heard by SatNOGS stations, then highest first, with their downlinks and reception. Each has azimuth with a compass word, elevation, range, sunlit, magnitude and a url to its page. Satellites whose orbital elements are more than 14 days from now are left out and counted (skippedStaleElements). For upcoming passes rather than this moment, use find_best_pass or find_passes.
입력 스키마
{
"type": "object",
"properties": {
"lat": {
"description": "observer latitude in decimal degrees, north positive (-90 to 90). Give it with lon, or give location instead.",
"type": "number",
"minimum": -90,
"maximum": 90
},
"lon": {
"description": "observer longitude in decimal degrees, east positive and west negative (-180 to 180).",
"type": "number",
"minimum": -180,
"maximum": 180
},
"location": {
"description": "where the observer is, when lat and lon are not given (they win when both are): a Maidenhead grid square (EN52, EN52ve, EN52ve12), coordinates in any common form (\"41.88, -87.63\", \"41.88N 87.63W\", \"41°52'48\"N 87°37'48\"W\", a Google Maps link or geo: URI), all read locally, or a place name (city, address, landmark) looked up with OpenStreetMap. Prefer lat and lon, or a grid square, when you have them: a place name is a network lookup.",
"type": "string",
"maxLength": 200
},
"mode": {
"description": "\"visual\" (default): sunlit satellites in a dark sky, brightest first; \"radio\": satellites with known downlinks, highest first, day or night.",
"type": "string",
"enum": [
"visual",
"radio"
]
},
"minElevation": {
"description": "lowest elevation to list, in degrees above the horizon (0 to 90). Default 10.",
"type": "number",
"minimum": 0,
"maximum": 90
},
"limit": {
"description": "how many satellites to return, 1 to 50. Default 10.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 50
},
"minElevationDeg": {
"description": "old name for minElevation; still accepted.",
"type": "number",
"minimum": 0,
"maximum": 90
},
"minElev": {
"description": "old name for minElevation; still accepted.",
"type": "number",
"minimum": 0,
"maximum": 90
}
},
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🟢identify_satellite(lat, lon, location, time, azimuth, ...)
"What was that moving light?" Given where and when a light was seen, lists the satellites that were sunlit, above the horizon and within `tolerance` degrees of that spot, best match first, from every satellite in the catalog (active satellites plus CelesTrak's visual group). Needs the Sun at least about 3 degrees below the horizon. A match must lie within tolerance of the reported spot (azimuth or direction, plus elevation); travel never adds a match, it only re-ranks them by how well each one's direction of travel agrees. Sightings by eye are often 10 to 20 degrees off, so widen tolerance before concluding nothing matched. Each candidate has its azimuth, elevation, angular error, direction of travel, magnitude (estimated where none is measured, see magnitudeEstimated), name and a url to its page. Satellites whose orbital elements are more than 14 days from the sighting time are left out and counted (skippedStaleElements). If the sky was too bright then, a note says so instead of a list; with no match, a note suggests checking the time and direction or widening tolerance. For satellites up at this moment use find_satellites_up_now; for upcoming passes use find_passes or find_best_pass.
입력 스키마
{
"type": "object",
"properties": {
"lat": {
"description": "observer latitude in decimal degrees, north positive (-90 to 90). Give it with lon, or give location instead.",
"type": "number",
"minimum": -90,
"maximum": 90
},
"lon": {
"description": "observer longitude in decimal degrees, east positive and west negative (-180 to 180).",
"type": "number",
"minimum": -180,
"maximum": 180
},
"location": {
"description": "where the observer is, when lat and lon are not given (they win when both are): a Maidenhead grid square (EN52, EN52ve, EN52ve12), coordinates in any common form (\"41.88, -87.63\", \"41.88N 87.63W\", \"41°52'48\"N 87°37'48\"W\", a Google Maps link or geo: URI), all read locally, or a place name (city, address, landmark) looked up with OpenStreetMap. Prefer lat and lon, or a grid square, when you have them: a place name is a network lookup.",
"type": "string",
"maxLength": 200
},
"time": {
"description": "time of the sighting. Default: now. ISO 8601 with Z or an offset, e.g. \"2026-11-14T21:00:00-06:00\"; a time with no offset, e.g. \"2026-11-14T21:00\", is read in the observer's time zone, and the result echoes how it was read (interpretedAs). A local time the clocks skip at a daylight-saving change is moved forward, with a note.",
"type": "string",
"maxLength": 64
},
"azimuth": {
"description": "where it was, in degrees from north (90 = east), 0 to 360. Give this or direction.",
"type": "number",
"minimum": 0,
"maximum": 360
},
"direction": {
"description": "where it was, as a compass word: N, NNE, NE, ... or \"north-east\".",
"type": "string",
"maxLength": 20
},
"elevation": {
"type": "number",
"minimum": 0,
"maximum": 90,
"description": "how high it was, in degrees above the horizon (0 to 90, 90 = straight up). Required."
},
"travel": {
"description": "the compass direction it was moving towards, e.g. \"NE\". Optional, but it sharpens the match.",
"type": "string",
"maxLength": 20
},
"tolerance": {
"description": "how far off the reported spot a match may be, in degrees, 1 to 45. Default 10.",
"type": "number",
"minimum": 1,
"maximum": 45
},
"limit": {
"description": "how many candidates to return, 1 to 10. Default 5.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 10
},
"passTime": {
"description": "old name for time; still accepted.",
"type": "string",
"maxLength": 64
}
},
"required": [
"elevation"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}커뮤니티
증거