---
type: "firecrawl-provider"
description: "Astronomical data computed on request by the US Naval Observatory's Astronomical Applications Department (aa.usno.navy.mil API v4): sunrise, sunset, solar noon and civil twilight, moonrise, moonset and Moon phase with illumination for any place and date from 1700 to 2100; primary Moon phase dates and times (new, first quarter, full, last quarter); the solar eclipses of any year from 1800 to 2050 and what a given location sees during one (1996 to 2026); and equinox, solstice, perihelion and aphelion times. US government work, public domain."
use_when: "Astronomical data computed on request by the US Naval Observatory's Astronomical Applications Department (aa.usno.navy.mil API v4): sunrise, sunset, solar noon and civil twilight, moonrise, moonset and Moon phase with illumination for any place and date from 1700 to 2100; primary Moon phase dates and times (new, first quarter, full, last quarter); the solar eclipses of any year from 1800 to 2050 and what a given location sees during one (1996 to 2026); and equinox, solstice, perihelion and aphelion times. US government work, public domain."
categories: "Research"
capabilities: 5
credits_per_call: 5
---
# USNO astronomical data (Sun, Moon, eclipses, seasons) on Firecrawl Alexandria

Astronomical data computed on request by the US Naval Observatory's Astronomical Applications Department (aa.usno.navy.mil API v4): sunrise, sunset, solar noon and civil twilight, moonrise, moonset and Moon phase with illumination for any place and date from 1700 to 2100; primary Moon phase dates and times (new, first quarter, full, last quarter); the solar eclipses of any year from 1800 to 2050 and what a given location sees during one (1996 to 2026); and equinox, solstice, perihelion and aphelion times. US government work, public domain.

- Categories: Research
- Category index: [Research category](https://alexandria.firecrawl.dev/agents/categories/research)
- Provider key: `aa-usno-navy-mil`
- Access: Firecrawl credits
- Cost: 5 credits per call

## More

- [Human guide](https://www.firecrawl.dev/app/alexandria/aa-usno-navy-mil)
- [OpenAPI spec](https://alexandria.firecrawl.dev/agents/providers/aa-usno-navy-mil/openapi.json)

## Capabilities

- [Moon phases](https://alexandria.firecrawl.dev/agents/providers/aa-usno-navy-mil/astronomy/moon_phases): Dates and Universal Times of the primary Moon phases (new moon, first quarter, full moon, last quarter) from 1700 to 2100: either the next count phases starting from a date, or every phase of a calendar year. Source: USNO moon/phases.
- [Seasons](https://alexandria.firecrawl.dev/agents/providers/aa-usno-navy-mil/astronomy/seasons): The March and September equinoxes, June and December solstices, perihelion and aphelion of a year (1700 to 2100), with local date and time on the UT offset you pass (optionally with US daylight saving rules). Source: USNO seasons.
- [Solar eclipse local](https://alexandria.firecrawl.dev/agents/providers/aa-usno-navy-mil/astronomy/solar_eclipse_local): What one location sees during a solar eclipse (1996 to 2026): whether it is visible, total, annular or partial there, magnitude, percent of the Sun covered, total and central-phase durations, and the UT time, Sun altitude and azimuth of each contact (begins, totality or annularity, maximum, ends, or sunrise and sunset cutting it). visible is false when the eclipse does not reach the location. USNO's calculator fails for eclipses after 2026 and before 1996, so those years are refused; list later eclipses with solar_eclipses_in_year. Source: USNO eclipses/solar/date.
- [Solar eclipses in year](https://alexandria.firecrawl.dev/agents/providers/aa-usno-navy-mil/astronomy/solar_eclipses_in_year): The solar eclipses of a calendar year (1800 to 2050) with date and type (total, annular, partial, hybrid). Source: USNO eclipses/solar/year.
- [Sun moon day](https://alexandria.firecrawl.dev/agents/providers/aa-usno-navy-mil/astronomy/sun_moon_day): Sun and Moon data for one place on one date (1700 to 2100): sunrise, sunset, solar noon, civil twilight begin and end, day length, moonrise, moonset and Moon transit, the Moon's phase name and percent illuminated, and the nearest primary phase. Times are local on the UT offset you pass (tz_offset_hours, optionally with US daylight saving rules); polar day and night are reported as continuously above or below the horizon. Source: USNO rstt/oneday.

## 1. Choose this provider when

Astronomical data computed on request by the US Naval Observatory's Astronomical Applications Department (aa.usno.navy.mil API v4): sunrise, sunset, solar noon and civil twilight, moonrise, moonset and Moon phase with illumination for any place and date from 1700 to 2100; primary Moon phase dates and times (new, first quarter, full, last quarter); the solar eclipses of any year from 1800 to 2050 and what a given location sees during one (1996 to 2026); and equinox, solstice, perihelion and aphelion times. US government work, public domain.

## 2. Minimal request

Call `POST https://api.firecrawl.dev/v2/scrape` with `{ alexandria: { provider, capability, options } }`. For a batch, send `{ alexandria: [...] }` with up to 10 calls.

```json
{
  "provider": "aa-usno-navy-mil",
  "capability": "astronomy/moon_phases",
  "options": {
    "year": 2027
  }
}
```

## 3. Add provider options

Use only the options needed for the task:

- `count` (number): How many phases from start_date, 1 to 99 (default 4, about one lunar month). Example: `10`
- `start_date` (string): List phases on or after this date, YYYY-MM-DD. Pass this or year. Example: `<start_date>`
- `year` (number): Every primary phase of this year (1700 to 2100). Pass this or start_date. Example: `1700`

## 4. Request through your preferred interface

### JavaScript

```javascript
const result = await firecrawl.scrape({
  alexandria: {
    provider: "aa-usno-navy-mil",
    capability: "astronomy/moon_phases",
    options: {
      year: 2027,
    },
  },
});
```

### Python

```python
result = firecrawl.scrape_alexandria({
  "provider": "aa-usno-navy-mil",
  "capability": "astronomy/moon_phases",
  "options": {
    "year": 2027
  }
})
```

### cURL

```sh
curl https://api.firecrawl.dev/v2/scrape \
  -H "Authorization: Bearer $FIRECRAWL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "alexandria": {
    "provider": "aa-usno-navy-mil",
    "capability": "astronomy/moon_phases",
    "options": {
      "year": 2027
    }
  }
}'
```

### CLI

```sh
firecrawl scrape 'aa-usno-navy-mil/astronomy/moon_phases' \
  --options '{"year":2027}'
```


### MCP

Call the FCX MCP retrieve tool with this object:

```json
{
  "provider": "aa-usno-navy-mil",
  "capability": "astronomy/moon_phases",
  "options": {
    "year": 2027
  }
}
```

Ask for only the returned fields needed by the task.

## 5. Full request shape

```json
{
  "provider": "aa-usno-navy-mil",
  "capability": "astronomy/moon_phases",
  "options": {
    "year": 2027
  }
}
```

## 6. Response data

The response includes `success`, `provider`, `capability`, `creditsCost` and `data`. This example shows the provider payload in `data`:

```json
{
  "observed_at_ms": 1794421542000,
  "phases": [
    {
      "date": "2027-01-07",
      "datetime_utc": "2027-01-07T20:24Z",
      "phase": "New Moon",
      "time_ut": "20:24"
    },
    {
      "date": "2027-01-15",
      "datetime_utc": "2027-01-15T20:34Z",
      "phase": "First Quarter",
      "time_ut": "20:34"
    },
    {
      "date": "2027-01-22",
      "datetime_utc": "2027-01-22T12:17Z",
      "phase": "Full Moon",
      "time_ut": "12:17"
    },
    {
      "date": "2027-01-29",
      "datetime_utc": "2027-01-29T10:55Z",
      "phase": "Last Quarter",
      "time_ut": "10:55"
    },
    {
      "date": "2027-02-06",
      "datetime_utc": "2027-02-06T15:56Z",
      "phase": "New Moon",
      "time_ut": "15:56"
    },
    {
      "date": "2027-02-14",
      "datetime_utc": "2027-02-14T07:58Z",
      "phase": "First Quarter",
      "time_ut": "07:58"
    },
    {
      "date": "2027-02-20",
      "datetime_utc": "2027-02-20T23:23Z",
      "phase": "Full Moon",
      "time_ut": "23:23"
    },
    {
      "date": "2027-02-28",
      "datetime_utc": "2027-02-28T05:16Z",
      "phase": "Last Quarter",
      "time_ut": "05:16"
    },
    {
      "date": "2027-03-08",
      "datetime_utc": "2027-03-08T09:29Z",
      "phase": "New Moon",
      "time_ut": "09:29"
    },
    {
      "date": "2027-03-15",
      "datetime_utc": "2027-03-15T16:25Z",
      "phase": "First Quarter",
      "time_ut": "16:25"
    },
    {
      "date": "2027-03-22",
      "datetime_utc": "2027-03-22T10:44Z",
      "phase": "Full Moon",
      "time_ut": "10:44"
    },
    {
      "date": "2027-03-30",
      "datetime_utc": "2027-03-30T00:54Z",
      "phase": "Last Quarter",
      "time_ut": "00:54"
    },
    {
      "date": "2027-04-06",
      "datetime_utc": "2027-04-06T23:51Z",
      "phase": "New Moon",
      "time_ut": "23:51"
    },
    {
      "date": "2027-04-13",
      "datetime_utc": "2027-04-13T22:56Z",
      "phase": "First Quarter",
      "time_ut": "22:56"
    },
    {
      "date": "2027-04-20",
      "datetime_utc": "2027-04-20T22:27Z",
      "phase": "Full Moon",
      "time_ut": "22:27"
    },
    {
      "date": "2027-04-28",
      "datetime_utc": "2027-04-28T20:18Z",
      "phase": "Last Quarter",
      "time_ut": "20:18"
    },
    {
      "date": "2027-05-06",
      "datetime_utc": "2027-05-06T10:58Z",
      "phase": "New Moon",
      "time_ut": "10:58"
    },
    {
      "date": "2027-05-13",
      "datetime_utc": "2027-05-13T04:44Z",
      "phase": "First Quarter",
      "time_ut": "04:44"
    },
    {
      "date": "2027-05-20",
      "datetime_utc": "2027-05-20T10:59Z",
      "phase": "Full Moon",
      "time_ut": "10:59"
    },
    {
      "date": "2027-05-28",
      "datetime_utc": "2027-05-28T13:58Z",
      "phase": "Last Quarter",
      "time_ut": "13:58"
    },
    {
      "date": "2027-06-04",
      "datetime_utc": "2027-06-04T19:40Z",
      "phase": "New Moon",
      "time_ut": "19:40"
    },
    {
      "date": "2027-06-11",
      "datetime_utc": "2027-06-11T10:56Z",
      "phase": "First Quarter",
      "time_ut": "10:56"
    },
    {
      "date": "2027-06-19",
      "datetime_utc": "2027-06-19T00:44Z",
      "phase": "Full Moon",
      "time_ut": "00:44"
    },
    {
      "date": "2027-06-27",
      "datetime_utc": "2027-06-27T04:54Z",
      "phase": "Last Quarter",
      "time_ut": "04:54"
    },
    {
      "date": "2027-07-04",
      "datetime_utc": "2027-07-04T03:02Z",
      "phase": "New Moon",
      "time_ut": "03:02"
    },
    {
      "date": "2027-07-10",
      "datetime_utc": "2027-07-10T18:39Z",
      "phase": "First Quarter",
      "time_ut": "18:39"
    },
    {
      "date": "2027-07-18",
      "datetime_utc": "2027-07-18T15:45Z",
      "phase": "Full Moon",
      "time_ut": "15:45"
    },
    {
      "date": "2027-07-26",
      "datetime_utc": "2027-07-26T16:55Z",
      "phase": "Last Quarter",
      "time_ut": "16:55"
    },
    {
      "date": "2027-08-02",
      "datetime_utc": "2027-08-02T10:05Z",
      "phase": "New Moon",
      "time_ut": "10:05"
    },
    {
      "date": "2027-08-09",
      "datetime_utc": "2027-08-09T04:54Z",
      "phase": "First Quarter",
      "time_ut": "04:54"
    },
    {
      "date": "2027-08-17",
      "datetime_utc": "2027-08-17T07:29Z",
      "phase": "Full Moon",
      "time_ut": "07:29"
    },
    {
      "date": "2027-08-25",
      "datetime_utc": "2027-08-25T02:27Z",
      "phase": "Last Quarter",
      "time_ut": "02:27"
    },
    {
      "date": "2027-08-31",
      "datetime_utc": "2027-08-31T17:41Z",
      "phase": "New Moon",
      "time_ut": "17:41"
    },
    {
      "date": "2027-09-07",
      "datetime_utc": "2027-09-07T18:31Z",
      "phase": "First Quarter",
      "time_ut": "18:31"
    },
    {
      "date": "2027-09-15",
      "datetime_utc": "2027-09-15T23:03Z",
      "phase": "Full Moon",
      "time_ut": "23:03"
    },
    {
      "date": "2027-09-23",
      "datetime_utc": "2027-09-23T10:20Z",
      "phase": "Last Quarter",
      "time_ut": "10:20"
    },
    {
      "date": "2027-09-30",
      "datetime_utc": "2027-09-30T02:36Z",
      "phase": "New Moon",
      "time_ut": "02:36"
    },
    {
      "date": "2027-10-07",
      "datetime_utc": "2027-10-07T11:47Z",
      "phase": "First Quarter",
      "time_ut": "11:47"
    },
    {
      "date": "2027-10-15",
      "datetime_utc": "2027-10-15T13:47Z",
      "phase": "Full Moon",
      "time_ut": "13:47"
    },
    {
      "date": "2027-10-22",
      "datetime_utc": "2027-10-22T17:29Z",
      "phase": "Last Quarter",
      "time_ut": "17:29"
    },
    {
      "date": "2027-10-29",
      "datetime_utc": "2027-10-29T13:36Z",
      "phase": "New Moon",
      "time_ut": "13:36"
    },
    {
      "date": "2027-11-06",
      "datetime_utc": "2027-11-06T08:00Z",
      "phase": "First Quarter",
      "time_ut": "08:00"
    },
    {
      "date": "2027-11-14",
      "datetime_utc": "2027-11-14T03:26Z",
      "phase": "Full Moon",
      "time_ut": "03:26"
    },
    {
      "date": "2027-11-21",
      "datetime_utc": "2027-11-21T00:48Z",
      "phase": "Last Quarter",
      "time_ut": "00:48"
    },
    {
      "date": "2027-11-28",
      "datetime_utc": "2027-11-28T03:24Z",
      "phase": "New Moon",
      "time_ut": "03:24"
    },
    {
      "date": "2027-12-06",
      "datetime_utc": "2027-12-06T05:22Z",
      "phase": "First Quarter",
      "time_ut": "05:22"
    },
    {
      "date": "2027-12-13",
      "datetime_utc": "2027-12-13T16:09Z",
      "phase": "Full Moon",
      "time_ut": "16:09"
    },
    {
      "date": "2027-12-20",
      "datetime_utc": "2027-12-20T09:11Z",
      "phase": "Last Quarter",
      "time_ut": "09:11"
    },
    {
      "date": "2027-12-27",
      "datetime_utc": "2027-12-27T20:12Z",
      "phase": "New Moon",
      "time_ut": "20:12"
    }
  ],
  "query": {
    "count": null,
    "start_date": null,
    "year": 2027
  },
  "source_url": "https://aa.usno.navy.mil/api/moon/phases/year?year=2027",
  "total": 49
}
```

## API reference-derived contract

The following capability contract is generated from the same normalized Alexandria API reference exposed in the API spec.

### Moon phases

- Capability: `astronomy/moon_phases`
- Description: Dates and Universal Times of the primary Moon phases (new moon, first quarter, full moon, last quarter) from 1700 to 2100: either the next count phases starting from a date, or every phase of a calendar year. Source: USNO moon/phases.
- Instructions: When is the next full moon or new moon, list the full moons of 2027, how many days until the first quarter. Times are UT; add the local offset yourself.
- Cost: 5 credits per call
- Capability file: [Moon phases](https://alexandria.firecrawl.dev/agents/providers/aa-usno-navy-mil/astronomy/moon_phases)

Accepted options:
- `count` (number): How many phases from start_date, 1 to 99 (default 4, about one lunar month). Example: `10`
- `start_date` (string): List phases on or after this date, YYYY-MM-DD. Pass this or year. Example: `<start_date>`
- `year` (number): Every primary phase of this year (1700 to 2100). Pass this or start_date. Example: `1700`

Response schema example:
```json
{
  "observed_at_ms": 1794421542000,
  "phases": [
    {
      "date": "2027-01-07",
      "datetime_utc": "2027-01-07T20:24Z",
      "phase": "New Moon",
      "time_ut": "20:24"
    },
    {
      "date": "2027-01-15",
      "datetime_utc": "2027-01-15T20:34Z",
      "phase": "First Quarter",
      "time_ut": "20:34"
    },
    {
      "date": "2027-01-22",
      "datetime_utc": "2027-01-22T12:17Z",
      "phase": "Full Moon",
      "time_ut": "12:17"
    },
    {
      "date": "2027-01-29",
      "datetime_utc": "2027-01-29T10:55Z",
      "phase": "Last Quarter",
      "time_ut": "10:55"
    },
    {
      "date": "2027-02-06",
      "datetime_utc": "2027-02-06T15:56Z",
      "phase": "New Moon",
      "time_ut": "15:56"
    },
    {
      "date": "2027-02-14",
      "datetime_utc": "2027-02-14T07:58Z",
      "phase": "First Quarter",
      "time_ut": "07:58"
    },
    {
      "date": "2027-02-20",
      "datetime_utc": "2027-02-20T23:23Z",
      "phase": "Full Moon",
      "time_ut": "23:23"
    },
    {
      "date": "2027-02-28",
      "datetime_utc": "2027-02-28T05:16Z",
      "phase": "Last Quarter",
      "time_ut": "05:16"
    },
    {
      "date": "2027-03-08",
      "datetime_utc": "2027-03-08T09:29Z",
      "phase": "New Moon",
      "time_ut": "09:29"
    },
    {
      "date": "2027-03-15",
      "datetime_utc": "2027-03-15T16:25Z",
      "phase": "First Quarter",
      "time_ut": "16:25"
    },
    {
      "date": "2027-03-22",
      "datetime_utc": "2027-03-22T10:44Z",
      "phase": "Full Moon",
      "time_ut": "10:44"
    },
    {
      "date": "2027-03-30",
      "datetime_utc": "2027-03-30T00:54Z",
      "phase": "Last Quarter",
      "time_ut": "00:54"
    },
    {
      "date": "2027-04-06",
      "datetime_utc": "2027-04-06T23:51Z",
      "phase": "New Moon",
      "time_ut": "23:51"
    },
    {
      "date": "2027-04-13",
      "datetime_utc": "2027-04-13T22:56Z",
      "phase": "First Quarter",
      "time_ut": "22:56"
    },
    {
      "date": "2027-04-20",
      "datetime_utc": "2027-04-20T22:27Z",
      "phase": "Full Moon",
      "time_ut": "22:27"
    },
    {
      "date": "2027-04-28",
      "datetime_utc": "2027-04-28T20:18Z",
      "phase": "Last Quarter",
      "time_ut": "20:18"
    },
    {
      "date": "2027-05-06",
      "datetime_utc": "2027-05-06T10:58Z",
      "phase": "New Moon",
      "time_ut": "10:58"
    },
    {
      "date": "2027-05-13",
      "datetime_utc": "2027-05-13T04:44Z",
      "phase": "First Quarter",
      "time_ut": "04:44"
    },
    {
      "date": "2027-05-20",
      "datetime_utc": "2027-05-20T10:59Z",
      "phase": "Full Moon",
      "time_ut": "10:59"
    },
    {
      "date": "2027-05-28",
      "datetime_utc": "2027-05-28T13:58Z",
      "phase": "Last Quarter",
      "time_ut": "13:58"
    },
    {
      "date": "2027-06-04",
      "datetime_utc": "2027-06-04T19:40Z",
      "phase": "New Moon",
      "time_ut": "19:40"
    },
    {
      "date": "2027-06-11",
      "datetime_utc": "2027-06-11T10:56Z",
      "phase": "First Quarter",
      "time_ut": "10:56"
    },
    {
      "date": "2027-06-19",
      "datetime_utc": "2027-06-19T00:44Z",
      "phase": "Full Moon",
      "time_ut": "00:44"
    },
    {
      "date": "2027-06-27",
      "datetime_utc": "2027-06-27T04:54Z",
      "phase": "Last Quarter",
      "time_ut": "04:54"
    },
    {
      "date": "2027-07-04",
      "datetime_utc": "2027-07-04T03:02Z",
      "phase": "New Moon",
      "time_ut": "03:02"
    },
    {
      "date": "2027-07-10",
      "datetime_utc": "2027-07-10T18:39Z",
      "phase": "First Quarter",
      "time_ut": "18:39"
    },
    {
      "date": "2027-07-18",
      "datetime_utc": "2027-07-18T15:45Z",
      "phase": "Full Moon",
      "time_ut": "15:45"
    },
    {
      "date": "2027-07-26",
      "datetime_utc": "2027-07-26T16:55Z",
      "phase": "Last Quarter",
      "time_ut": "16:55"
    },
    {
      "date": "2027-08-02",
      "datetime_utc": "2027-08-02T10:05Z",
      "phase": "New Moon",
      "time_ut": "10:05"
    },
    {
      "date": "2027-08-09",
      "datetime_utc": "2027-08-09T04:54Z",
      "phase": "First Quarter",
      "time_ut": "04:54"
    },
    {
      "date": "2027-08-17",
      "datetime_utc": "2027-08-17T07:29Z",
      "phase": "Full Moon",
      "time_ut": "07:29"
    },
    {
      "date": "2027-08-25",
      "datetime_utc": "2027-08-25T02:27Z",
      "phase": "Last Quarter",
      "time_ut": "02:27"
    },
    {
      "date": "2027-08-31",
      "datetime_utc": "2027-08-31T17:41Z",
      "phase": "New Moon",
      "time_ut": "17:41"
    },
    {
      "date": "2027-09-07",
      "datetime_utc": "2027-09-07T18:31Z",
      "phase": "First Quarter",
      "time_ut": "18:31"
    },
    {
      "date": "2027-09-15",
      "datetime_utc": "2027-09-15T23:03Z",
      "phase": "Full Moon",
      "time_ut": "23:03"
    },
    {
      "date": "2027-09-23",
      "datetime_utc": "2027-09-23T10:20Z",
      "phase": "Last Quarter",
      "time_ut": "10:20"
    },
    {
      "date": "2027-09-30",
      "datetime_utc": "2027-09-30T02:36Z",
      "phase": "New Moon",
      "time_ut": "02:36"
    },
    {
      "date": "2027-10-07",
      "datetime_utc": "2027-10-07T11:47Z",
      "phase": "First Quarter",
      "time_ut": "11:47"
    },
    {
      "date": "2027-10-15",
      "datetime_utc": "2027-10-15T13:47Z",
      "phase": "Full Moon",
      "time_ut": "13:47"
    },
    {
      "date": "2027-10-22",
      "datetime_utc": "2027-10-22T17:29Z",
      "phase": "Last Quarter",
      "time_ut": "17:29"
    },
    {
      "date": "2027-10-29",
      "datetime_utc": "2027-10-29T13:36Z",
      "phase": "New Moon",
      "time_ut": "13:36"
    },
    {
      "date": "2027-11-06",
      "datetime_utc": "2027-11-06T08:00Z",
      "phase": "First Quarter",
      "time_ut": "08:00"
    },
    {
      "date": "2027-11-14",
      "datetime_utc": "2027-11-14T03:26Z",
      "phase": "Full Moon",
      "time_ut": "03:26"
    },
    {
      "date": "2027-11-21",
      "datetime_utc": "2027-11-21T00:48Z",
      "phase": "Last Quarter",
      "time_ut": "00:48"
    },
    {
      "date": "2027-11-28",
      "datetime_utc": "2027-11-28T03:24Z",
      "phase": "New Moon",
      "time_ut": "03:24"
    },
    {
      "date": "2027-12-06",
      "datetime_utc": "2027-12-06T05:22Z",
      "phase": "First Quarter",
      "time_ut": "05:22"
    },
    {
      "date": "2027-12-13",
      "datetime_utc": "2027-12-13T16:09Z",
      "phase": "Full Moon",
      "time_ut": "16:09"
    },
    {
      "date": "2027-12-20",
      "datetime_utc": "2027-12-20T09:11Z",
      "phase": "Last Quarter",
      "time_ut": "09:11"
    },
    {
      "date": "2027-12-27",
      "datetime_utc": "2027-12-27T20:12Z",
      "phase": "New Moon",
      "time_ut": "20:12"
    }
  ],
  "query": {
    "count": null,
    "start_date": null,
    "year": 2027
  },
  "source_url": "https://aa.usno.navy.mil/api/moon/phases/year?year=2027",
  "total": 49
}
```

### Seasons

- Capability: `astronomy/seasons`
- Description: The March and September equinoxes, June and December solstices, perihelion and aphelion of a year (1700 to 2100), with local date and time on the UT offset you pass (optionally with US daylight saving rules). Source: USNO seasons.
- Instructions: When does spring or winter start, what time is the equinox, when is Earth closest to the Sun.
- Cost: 5 credits per call
- Capability file: [Seasons](https://alexandria.firecrawl.dev/agents/providers/aa-usno-navy-mil/astronomy/seasons)

Accepted options:
- `dst` (boolean): Apply US daylight saving time rules (1967 onward) on top of tz_offset_hours. Defaults to false. USNO only knows the US rules, so for other countries pass the offset in force on the date instead. Example: `false`
- `tz_offset_hours` (number): Hours east of Greenwich (UT offset), -12 to 14: -5 for US Eastern Standard Time, 1 for Central European Time, 5.5 for India. Defaults to 0 (UT). Times are on this fixed offset unless dst applies. Example: `10`
- `year` (number, required): Calendar year, 1700 to 2100. Example: `1700`

Response schema example:
```json
{
  "dst_requested": false,
  "events": [
    {
      "clock": null,
      "date": "2026-01-03",
      "event": "perihelion",
      "phenomenon": "Perihelion",
      "time": "17:15"
    },
    {
      "clock": null,
      "date": "2026-03-20",
      "event": "march_equinox",
      "phenomenon": "Equinox",
      "time": "14:46"
    },
    {
      "clock": null,
      "date": "2026-06-21",
      "event": "june_solstice",
      "phenomenon": "Solstice",
      "time": "08:24"
    },
    {
      "clock": null,
      "date": "2026-07-06",
      "event": "aphelion",
      "phenomenon": "Aphelion",
      "time": "17:30"
    },
    {
      "clock": null,
      "date": "2026-09-23",
      "event": "september_equinox",
      "phenomenon": "Equinox",
      "time": "00:05"
    },
    {
      "clock": null,
      "date": "2026-12-21",
      "event": "december_solstice",
      "phenomenon": "Solstice",
      "time": "20:50"
    }
  ],
  "observed_at_ms": 1794421542000,
  "source_url": "https://aa.usno.navy.mil/api/seasons?year=2026&tz=0&dst=false",
  "tz_offset_hours": 0,
  "year": 2026
}
```

### Solar eclipse local

- Capability: `astronomy/solar_eclipse_local`
- Description: What one location sees during a solar eclipse (1996 to 2026): whether it is visible, total, annular or partial there, magnitude, percent of the Sun covered, total and central-phase durations, and the UT time, Sun altitude and azimuth of each contact (begins, totality or annularity, maximum, ends, or sunrise and sunset cutting it). visible is false when the eclipse does not reach the location. USNO's calculator fails for eclipses after 2026 and before 1996, so those years are refused; list later eclipses with solar_eclipses_in_year. Source: USNO eclipses/solar/date.
- Instructions: Will I see the eclipse from my city, how much of the Sun was covered in Dallas on 2024-04-08, when did totality start. Get the eclipse date from solar_eclipses_in_year.
- Cost: 5 credits per call
- Capability file: [Solar eclipse local](https://alexandria.firecrawl.dev/agents/providers/aa-usno-navy-mil/astronomy/solar_eclipse_local)

Accepted options:
- `date` (string, required): Date of the eclipse, YYYY-MM-DD (1996 to 2026); the UT date or the local date one day either side both work. Example: `<date>`
- `height_m` (number): Height above the ellipsoid in meters, -90 to 10999. Defaults to 0. Example: `10`
- `latitude` (number, required): Decimal degrees, north positive. Example: `10`
- `longitude` (number, required): Decimal degrees, east positive. Example: `10`

Response schema example:
```json
{
  "annularity_seconds": null,
  "delta_t_seconds": 72.8,
  "duration_seconds": 9560.8,
  "eclipse_date": "2024-04-08",
  "event": "Solar Eclipse of 2024 April 08",
  "height_m": 0,
  "latitude": 32.78,
  "local_type": "total",
  "longitude": -96.8,
  "magnitude": 1.015,
  "obscuration_percent": 100,
  "observed_at_ms": 1794421542000,
  "phases": [
    {
      "altitude_deg": 60.6,
      "azimuth_deg": 145.3,
      "date": "2024-04-08",
      "phenomenon": "Eclipse Begins",
      "position_angle_deg": 226.2,
      "time_ut": "17:23:14.7",
      "vertex_angle_deg": 255.4
    },
    {
      "altitude_deg": 64.7,
      "azimuth_deg": 186.9,
      "date": "2024-04-08",
      "phenomenon": "Totality Begins",
      "position_angle_deg": 18.8,
      "time_ut": "18:40:37.9",
      "vertex_angle_deg": 13.4
    },
    {
      "altitude_deg": 64.6,
      "azimuth_deg": 188,
      "date": "2024-04-08",
      "phenomenon": "Maximum Eclipse",
      "position_angle_deg": null,
      "time_ut": "18:42:32.9",
      "vertex_angle_deg": null
    },
    {
      "altitude_deg": 64.6,
      "azimuth_deg": 189.1,
      "date": "2024-04-08",
      "phenomenon": "Totality Ends",
      "position_angle_deg": 255.8,
      "time_ut": "18:44:29.8",
      "vertex_angle_deg": 248.5
    },
    {
      "altitude_deg": 56.8,
      "azimuth_deg": 226,
      "date": "2024-04-08",
      "phenomenon": "Eclipse Ends",
      "position_angle_deg": 49.2,
      "time_ut": "20:02:35.5",
      "vertex_angle_deg": 11.8
    }
  ],
  "requested_date": "2024-04-08",
  "source_url": "https://aa.usno.navy.mil/api/eclipses/solar/date?date=2024-04-08&coords=32.78,-96.8&height=0",
  "totality_seconds": 231.9,
  "visible": true
}
```

### Solar eclipses in year

- Capability: `astronomy/solar_eclipses_in_year`
- Description: The solar eclipses of a calendar year (1800 to 2050) with date and type (total, annular, partial, hybrid). Source: USNO eclipses/solar/year.
- Instructions: Which solar eclipses happen in 2027, when is the next total solar eclipse, find the date to pass to solar_eclipse_local.
- Cost: 5 credits per call
- Capability file: [Solar eclipses in year](https://alexandria.firecrawl.dev/agents/providers/aa-usno-navy-mil/astronomy/solar_eclipses_in_year)

Accepted options:
- `year` (number, required): Calendar year, 1800 to 2050. Example: `1800`

Response schema example:
```json
{
  "eclipses": [
    {
      "date": "2027-02-06",
      "event": "Annular Solar Eclipse of 6 February 2027",
      "type": "annular"
    },
    {
      "date": "2027-08-02",
      "event": "Total Solar Eclipse of 2 August 2027",
      "type": "total"
    }
  ],
  "observed_at_ms": 1794421542000,
  "source_url": "https://aa.usno.navy.mil/api/eclipses/solar/year?year=2027",
  "total": 2,
  "year": 2027
}
```

### Sun moon day

- Capability: `astronomy/sun_moon_day`
- Description: Sun and Moon data for one place on one date (1700 to 2100): sunrise, sunset, solar noon, civil twilight begin and end, day length, moonrise, moonset and Moon transit, the Moon's phase name and percent illuminated, and the nearest primary phase. Times are local on the UT offset you pass (tz_offset_hours, optionally with US daylight saving rules); polar day and night are reported as continuously above or below the horizon. Source: USNO rstt/oneday.
- Instructions: Questions like what time is sunset in Paris on a date, when does civil twilight end, golden-hour planning, how long is the day, when does the Moon rise tonight, how full is the Moon. Pass the place's coordinates and its UT offset on that date.
- Cost: 5 credits per call
- Capability file: [Sun moon day](https://alexandria.firecrawl.dev/agents/providers/aa-usno-navy-mil/astronomy/sun_moon_day)

Accepted options:
- `date` (string, required): Local calendar date, YYYY-MM-DD (1700 to 2100). Example: `<date>`
- `dst` (boolean): Apply US daylight saving time rules (1967 onward) on top of tz_offset_hours. Defaults to false. USNO only knows the US rules, so for other countries pass the offset in force on the date instead. Example: `false`
- `latitude` (number, required): Decimal degrees, north positive. Example: `10`
- `longitude` (number, required): Decimal degrees, east positive. Example: `10`
- `tz_offset_hours` (number): Hours east of Greenwich (UT offset), -12 to 14: -5 for US Eastern Standard Time, 1 for Central European Time, 5.5 for India. Defaults to 0 (UT). Times are on this fixed offset unless dst applies. Example: `10`

Response schema example:
```json
{
  "date": "2026-11-11",
  "day_of_week": "Wednesday",
  "dst_in_effect": false,
  "dst_requested": false,
  "events": [
    {
      "body": "sun",
      "clock": null,
      "phenomenon": "Begin Civil Twilight",
      "time": "06:18"
    },
    {
      "body": "sun",
      "clock": null,
      "phenomenon": "Rise",
      "time": "06:46"
    },
    {
      "body": "sun",
      "clock": null,
      "phenomenon": "Upper Transit",
      "time": "11:52"
    },
    {
      "body": "sun",
      "clock": null,
      "phenomenon": "Set",
      "time": "16:57"
    },
    {
      "body": "sun",
      "clock": null,
      "phenomenon": "End Civil Twilight",
      "time": "17:26"
    },
    {
      "body": "moon",
      "clock": null,
      "phenomenon": "Rise",
      "time": "09:16"
    },
    {
      "body": "moon",
      "clock": null,
      "phenomenon": "Upper Transit",
      "time": "13:47"
    },
    {
      "body": "moon",
      "clock": null,
      "phenomenon": "Set",
      "time": "18:16"
    }
  ],
  "latitude": 38.89,
  "longitude": -77.03,
  "moon": {
    "continuously": null,
    "lower_transit": null,
    "rise": "09:16",
    "set": "18:16",
    "upper_transit": "13:47"
  },
  "moon_phase": {
    "closest_primary_phase": {
      "date": "2026-11-09",
      "phase": "New Moon",
      "time": "02:02"
    },
    "current": "Waxing Crescent",
    "fraction_illuminated_percent": 6
  },
  "observed_at_ms": 1794421542000,
  "source_url": "https://aa.usno.navy.mil/api/rstt/oneday?date=2026-11-11&coords=38.89,-77.03&tz=-5&dst=false",
  "sun": {
    "begin_civil_twilight": "06:18",
    "continuously": null,
    "day_length_minutes": 611,
    "end_civil_twilight": "17:26",
    "lower_transit": null,
    "rise": "06:46",
    "set": "16:57",
    "twilight_continuously": null,
    "upper_transit": "11:52"
  },
  "tz_offset_hours": -5
}
```