← Back to Skills Marketplace
41
Downloads
0
Stars
0
Active Installs
2
Versions
Install in OpenClaw
/install satellite-tracker
Description
Real-time satellite and spacecraft tracking powered by SGP4 orbit prediction. Supports Tiangong (CSS), ISS, Hubble, or any NORAD catalog ID. Features real-ti...
README (SKILL.md)
Satellite Tracker / 卫星追踪器
Real-time satellite tracking for AI agents — no API key required. 实时卫星追踪 —— 无需 API Key，开箱即用。
When to Use / 何时使用
- User asks where a satellite or space station is / 用户问某颗卫星/空间站在哪
- User asks about Tiangong (CSS) or ISS location / 用户问天宫空间站或ISS位置
- User wants to track a spacecraft after launch / 用户想追踪发射后的航天器
- User wants satellite pass predictions / 用户想看卫星过境时间
- User is following a launch mission / 用户追踪发射任务
Installation / 安装
pip install sgp4
Usage / 用法
# Real-time position by name / 按名称查询
python3 skills/satellite-tracker/track.py --name 天宫
python3 skills/satellite-tracker/track.py --name ISS
# Real-time position by NORAD ID / 按NORAD ID查询
python3 skills/satellite-tracker/track.py --id 48274
# Pass predictions (requires observer coordinates) / 过境预测（需要观测者坐标）
python3 skills/satellite-tracker/track.py --name 天宫 --observer 28.2,112.9 --passes 5
# List all known satellites / 列出所有已知卫星
python3 skills/satellite-tracker/track.py --list
# Update TLE cache / 更新TLE缓存
python3 skills/satellite-tracker/track.py --update
# Continuous tracking mode / 持续追踪模式
python3 skills/satellite-tracker/track.py --name 天宫 --watch 60
# JSON output / JSON输出
python3 skills/satellite-tracker/track.py --name 天宫 --json
Known Satellites / 已知卫星
| Name / 名称 | NORAD ID | Description / 说明 |
|---|---|---|
| 天宫 (Tiangong/CSS) | 48274 | 中国空间站 Chinese Space Station |
| ISS | 25544 | 国际空间站 International Space Station |
| 哈勃 (Hubble) | 20580 | 哈勃太空望远镜 Hubble Space Telescope |
New satellites (e.g. Tianzhou cargo spacecraft) get assigned NORAD IDs after launch.
Use --update to refresh TLE data, then search by ID.
天舟等新航天器发射后会分配NORAD ID，用 --update 更新后可追踪。
Output / 输出示例
🛰️ 天宫 (CSS)
━━━━━━━━━━━━━━━━━━━━━━━
⏰ 北京时间: 2026-05-08 16:32:43
📍 纬度: 29.12°S
📍 经度: 170.84°E
📏 轨道高度: 384.9 km
🚀 飞行速度: 7.68 km/s (27656 km/h)
🌐 区域: 🌏 澳洲上空
📊 轨道参数 Orbital Parameters
周期 Period: 92.1 min (15.6 orbits/day)
倾角 Inclination: 41.47°
远地点 Apogee: 388 km
近地点 Perigee: 382 km
Pass Prediction Output / 过境预测示例
🔭 天宫 过境预测 Pass Predictions
观测位置: 28.2000°N, 112.9000°E
━━━━━━━━━━━━━━━━━━━━━━━
第1次过境 Pass #1:
⏰ 北京时间: 2026-05-09 00:34:13
📐 最大仰角 Max Elevation: 30.3°
📍 地面距离 Ground Distance: 647 km
📏 卫星高度 Altitude: 378 km
Technical Details / 技术细节
| Item / 项目 | Detail / 说明 |
|---|---|
| Orbit model / 轨道模型 | SGP4 (Simplified General Perturbations) |
| Data source / 数据源 | Celestrak TLE (updated hourly) / 每小时更新 |
| Cache / 缓存 | Local JSON, 1-hour TTL / 本地JSON，1小时有效期 |
| Coordinate system / 坐标系 | TEME → ECEF via GMST rotation |
| Pass prediction / 过境预测 | Brute-force scan with 10s steps, 5° min elevation |
Dependencies / 依赖
sgp4(Python package / Python包)- Internet connection for TLE data / 网络连接（获取TLE数据）
License
MIT-0
Usage Guidance
This looks safe for normal satellite tracking. Before installing, use a virtual environment for the sgp4 dependency and treat any request for API keys, tokens, or other credentials as unexpected unless separately documented by the maintainer.
Capability Analysis
Type: OpenClaw Skill
Name: satellite-tracker
Version: 1.1.0
The Satellite Tracker skill is a legitimate tool for calculating real-time satellite positions and predicting passes using the SGP4 orbit model. The code in track.py fetches orbital data (TLE) from a trusted public source (celestrak.org) and stores it in a local cache file (tle_cache.json). No evidence of data exfiltration, malicious execution, or prompt injection was found; the script's behavior is entirely consistent with its stated purpose.
Capability Tags
Capability Assessment
Purpose & Capability
The stated purpose and visible code align with satellite tracking using Celestrak TLE data and SGP4, and the docs say no API key is required. The provided capability signal says sensitive credentials are required, which conflicts with the visible artifacts and should be verified.
Instruction Scope
The instructions are normal user-invoked CLI examples for tracking, updating TLE data, pass prediction, JSON output, and watch mode. No hidden prompt override or automatic high-impact action is evident.
Install Mechanism
The SKILL.md asks the user to install the unpinned PyPI package sgp4, while the registry has no install spec. This is purpose-aligned but should be done from a trusted environment.
Credentials
The visible code fetches public TLE data from Celestrak and stores a local TLE cache, which is disclosed and proportionate for satellite tracking.
Persistence & Privilege
The only visible persistence is a local tle_cache.json cache with a documented one-hour TTL. No elevated privileges, background service installation, or self-persistence is evident.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install satellite-tracker - After installation, invoke the skill by name or use
/satellite-tracker - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.1.0
v1.1.0: bilingual SKILL.md (Chinese + English)
v1.0.0
首版：实时卫星追踪，SGP4轨道预测，过境预测，中文界面，支持天宫/ISS/任意NORAD ID
Metadata
Frequently Asked Questions
What is Satellite Tracker?
Real-time satellite and spacecraft tracking powered by SGP4 orbit prediction. Supports Tiangong (CSS), ISS, Hubble, or any NORAD catalog ID. Features real-ti... It is an AI Agent Skill for Claude Code / OpenClaw, with 41 downloads so far.
How do I install Satellite Tracker?
Run "/install satellite-tracker" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Satellite Tracker free?
Yes, Satellite Tracker is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Satellite Tracker support?
Satellite Tracker is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Satellite Tracker?
It is built and maintained by fengyucn (@fengyucn); the current version is v1.1.0.
More Skills