← 返回 Skills 市场

Satellite Tracker

Name: Satellite Tracker
Author: fengyucn

作者 fengyucn · GitHub ↗ · v1.1.0 · MIT-0

cross-platform ✓ 安全检测通过

总下载

当前安装

版本数

在 OpenClaw 中安装

/install 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...

使用说明 (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

安全使用建议

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.

功能分析

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.

能力标签

requires-sensitive-credentials

能力评估

ℹ 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.

如何使用

确保已安装 OpenClaw（本地或 Docker 部署）
在对话框中输入安装命令：/install satellite-tracker
安装完成后，直接呼叫该 Skill 的名称或使用 /satellite-tracker 触发
根据 Skill 的参数说明提供必要输入，即可获得结构化输出

版本历史

v1.1.0

v1.1.0: bilingual SKILL.md (Chinese + English)

v1.0.0

首版：实时卫星追踪，SGP4轨道预测，过境预测，中文界面，支持天宫/ISS/任意NORAD ID

元数据

Slug satellite-tracker

版本 1.1.0

许可证 MIT-0

累计安装 0

当前安装数 0

历史版本数 2

常见问题