Current aviation weather observations

Open this recipe in the console: it preserves the reviewed URL, fields and record key. Review the latest captured sample, confirm source rights, and choose a schedule before creating your monitor.

Copy into the console's Import or share a recipe panel to customize fields, types and schedules. This configuration contains no captured records or workspace IDs.

{
  "schema": "sourcefinch/source@1",
  "name": "Current aviation weather observations",
  "url": "https://aviationweather.gov/data/cache/metars.cache.xml.gz",
  "recipe": {
    "mode": "http",
    "format": "xml",
    "items": "METAR",
    "fields": {
      "maxT_c": "maxT_c",
      "minT_c": "minT_c",
      "temp_c": "temp_c",
      "snow_in": "snow_in",
      "latitude": "latitude",
      "raw_text": "raw_text",
      "longitude": "longitude",
      "pcp3hr_in": "pcp3hr_in",
      "pcp6hr_in": "pcp6hr_in",
      "precip_in": "precip_in",
      "wx_string": "wx_string",
      "dewpoint_c": "dewpoint_c",
      "maxT24hr_c": "maxT24hr_c",
      "metar_type": "metar_type",
      "minT24hr_c": "minT24hr_c",
      "pcp24hr_in": "pcp24hr_in",
      "station_id": "station_id",
      "altim_in_hg": "altim_in_hg",
      "elevation_m": "elevation_m",
      "vert_vis_ft": "vert_vis_ft",
      "wind_gust_kt": "wind_gust_kt",
      "wind_speed_kt": "wind_speed_kt",
      "flight_category": "flight_category",
      "observation_time": "observation_time",
      "wind_dir_degrees": "wind_dir_degrees",
      "sea_level_pressure_mb": "sea_level_pressure_mb",
      "visibility_statute_mi": "visibility_statute_mi",
      "three_hr_pressure_tendency_mb": "three_hr_pressure_tendency_mb"
    },
    "required": [
      "station_id",
      "raw_text",
      "observation_time"
    ],
    "types": {
      "dewpoint_c": "number",
      "latitude": "number",
      "longitude": "number",
      "observation_time": "datetime",
      "temp_c": "number",
      "wind_gust_kt": "number",
      "wind_speed_kt": "number"
    }
  },
  "schedule": "hourly",
  "key_field": "station_id"
}

The request body used by the API, CLI and SDK examples.

{
  "name": "Current aviation weather observations",
  "url": "https://aviationweather.gov/data/cache/metars.cache.xml.gz",
  "recipe": {
    "mode": "http",
    "format": "xml",
    "items": "METAR",
    "fields": {
      "maxT_c": "maxT_c",
      "minT_c": "minT_c",
      "temp_c": "temp_c",
      "snow_in": "snow_in",
      "latitude": "latitude",
      "raw_text": "raw_text",
      "longitude": "longitude",
      "pcp3hr_in": "pcp3hr_in",
      "pcp6hr_in": "pcp6hr_in",
      "precip_in": "precip_in",
      "wx_string": "wx_string",
      "dewpoint_c": "dewpoint_c",
      "maxT24hr_c": "maxT24hr_c",
      "metar_type": "metar_type",
      "minT24hr_c": "minT24hr_c",
      "pcp24hr_in": "pcp24hr_in",
      "station_id": "station_id",
      "altim_in_hg": "altim_in_hg",
      "elevation_m": "elevation_m",
      "vert_vis_ft": "vert_vis_ft",
      "wind_gust_kt": "wind_gust_kt",
      "wind_speed_kt": "wind_speed_kt",
      "flight_category": "flight_category",
      "observation_time": "observation_time",
      "wind_dir_degrees": "wind_dir_degrees",
      "sea_level_pressure_mb": "sea_level_pressure_mb",
      "visibility_statute_mi": "visibility_statute_mi",
      "three_hr_pressure_tendency_mb": "three_hr_pressure_tendency_mb"
    },
    "required": [
      "station_id",
      "raw_text",
      "observation_time"
    ],
    "types": {
      "temp_c": "number",
      "latitude": "number",
      "longitude": "number",
      "dewpoint_c": "number",
      "wind_gust_kt": "number",
      "wind_speed_kt": "number",
      "observation_time": "datetime"
    }
  },
  "key_field": "station_id",
  "schedule": "hourly",
  "rights": true,
  "catalog": {
    "slug": "awc-current-metar-observations",
    "version_id": "5424106f-d725-4b96-b88e-728ca01e99b1"
  }
}

Create an API key under Console → API keys. Reference: /docs/api.

# the Verified entry (fields, recipe, sample, terms) as JSON
curl https://sourcefinch.com/v1/catalog/awc-current-metar-observations -H "Authorization: Bearer $SOURCEFINCH_API_KEY"

# create the monitor from source.json (below)
curl -X POST https://sourcefinch.com/v1/sources \
  -H "Authorization: Bearer $SOURCEFINCH_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d @source.json

# then run it now (later runs follow the schedule)
curl -X POST https://sourcefinch.com/v1/sources/$SOURCE_ID/runs \
  -H "Authorization: Bearer $SOURCEFINCH_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)"

The sourcefinch CLI is not on npm yet; see /docs/cli.

sourcefinch login
sourcefinch catalog get awc-current-metar-observations --source-json > source.json
sourcefinch sources create --file source.json
sourcefinch runs create $SOURCE_ID --wait
sourcefinch records $SOURCE_ID

The SDK is not on npm yet; see /docs/sdk.

import { SourceFinch } from "@sourcefinch/sdk";

const sf = new SourceFinch({ apiKey: process.env.SOURCEFINCH_API_KEY });
const entry = await sf.catalog.get("awc-current-metar-observations");
const source = await sf.sources.create({
  catalog: { slug: entry.slug, version_id: entry.recipe.version_id },
  name: entry.name.slice(0, 100),
  url: entry.acquisition_path.endpoint,
  recipe: entry.recipe.definition,
  key_field: entry.recipe.key_field,
  schedule: entry.recipe.schedule,
  rights: true, // you confirm you have the right to collect this source
});
const run = await sf.runs.wait((await sf.runs.create(source.id)).id);
console.log(run.status);

Remote MCP server with OAuth; see /docs/mcp.

claude mcp add --transport http sourcefinch https://sourcefinch.com/mcp

# then ask your agent:
"Use SourceFinch to monitor Current aviation weather observations: get_catalog_source awc-current-metar-observations,
then create_source with its create_source_args (dry run first), then run_source."