/iss-position

name: iss-position
description: Fetch the current ISS latitude and longitude from the WhereTheISS API and return standardized payloads.
metadata:
  hybridclaw:
    category: misc
    short_description: "Current ISS position."
    tags:
      - iss
      - space
      - location
      - api

ISS Position

Fetch the ISS latitude and longitude with a deterministic Python script that matches this repository's existing `get_iss_position` tool behavior.

Quick Start

1. Run:

python3 skills/iss-position/scripts/get_iss_position.py --format text

2. For machine-readable output, run:

python3 skills/iss-position/scripts/get_iss_position.py --format json

Script Contract

Script path: `skills/iss-position/scripts/get_iss_position.py`

Behavior: 1. Call `https://api.wheretheiss.at/v1/satellites/25544`. 2. Use a default timeout of 15 seconds (override with `--timeout`). 3. Validate `latitude` and `longitude` as numeric values. 4. Return either:

{"status":"success","latitude":12.34,"longitude":56.78,"message":"The ISS is currently at latitude 12.34 and longitude 56.78."}

or:

{"status":"error","message":"Failed to retrieve ISS position."}

or:

{"status":"error","message":"ISS API returned invalid latitude/longitude values"}

Notes

• Network access is required to fetch live ISS coordinates.
• Use `--format text` for human-readable output and `--format json` for downstream tooling.
• Use `--timeout` to adjust request timeout when needed.